Skip to main content
WEBHOOK
BILLING_INVOICE_PAID
{
  "event":       "BILLING_INVOICE_PAID",
  "eventId":     "EVTJHLTPQH45SAP",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-26T14:13:26Z",
  "data": {
    "invoiceId":     "INVTEST000001AB",
    "invoiceNumber": "INV-2026-TEST-001",
    "amount":        50.00,
    "paid":          50.00,
    "currency":      "USD",
    "paymentMethod": "CRYPTO",
    "txHash":        "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "network":       "TRON"
  }
}

{}
Fires when a crypto deposit fully covers a pending invoice. The invoice status moves to PAID and — if it was a setup invoice — your program is activated.

​
Event Type

BILLING_INVOICE_PAID

​
Payload

{
  "event":       "BILLING_INVOICE_PAID",
  "eventId":     "EVTJHLTPQH45SAP",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-26T14:13:26Z",
  "data": {
    "invoiceId":     "INVTEST000001AB",
    "invoiceNumber": "INV-2026-TEST-001",
    "amount":        50.00,
    "paid":          50.00,
    "currency":      "USD",
    "paymentMethod": "CRYPTO",
    "txHash":        "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "network":       "TRON"
  }
}

​
Payload Fields

FieldTypeDescription
invoiceIdstringUnique invoice identifier
invoiceNumberstringHuman-readable invoice number
amountnumberOriginal invoice amount in dollars
paidnumberAmount actually applied to this invoice, in dollars
currencystringCurrency code (always USD)
paymentMethodstringAlways CRYPTO for on-chain payments
txHashstringBlockchain transaction hash of the deposit
networkstringBlockchain network — TRON or ETH
For the full event group documentation see Billing Events. 
{
  "event":       "BILLING_INVOICE_PAID",
  "eventId":     "EVTJHLTPQH45SAP",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-26T14:13:26Z",
  "data": {
    "invoiceId":     "INVTEST000001AB",
    "invoiceNumber": "INV-2026-TEST-001",
    "amount":        50.00,
    "paid":          50.00,
    "currency":      "USD",
    "paymentMethod": "CRYPTO",
    "txHash":        "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "network":       "TRON"
  }
}

{}

Authorizations

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json
​
event
string
Example:

"BILLING_INVOICE_PAID"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.