{
"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"
}
}
{}
Billing Events
BILLING_INVOICE_PAID
Fired when a billing invoice is successfully paid — by a crypto deposit or from the program balance.
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 pending invoice is fully paid — either by a crypto deposit that covers it or from the program balance. The invoice status moves to
For the full event group documentation see Billing Events.
PAID and — if it was a setup invoice — your program is activated. The paymentMethod field tells you which path settled it (CRYPTO or BALANCE).
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
| Field | Type | Description |
|---|---|---|
invoiceId | string | Unique invoice identifier |
invoiceNumber | string | Human-readable invoice number |
amount | number | Original invoice amount in dollars |
paid | number | Amount actually applied to this invoice, in dollars |
currency | string | Currency code (always USD) |
paymentMethod | string | CRYPTO when paid by an on-chain deposit, or BALANCE when paid from the program balance |
txHash | string | Blockchain transaction hash of the deposit — present only when paymentMethod is CRYPTO |
network | string | Blockchain network of the deposit — present only when paymentMethod is CRYPTO |
{
"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
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.