Skip to main content
WEBHOOK
BILLING_DEPOSIT_CONFIRMED
{
  "event":       "BILLING_DEPOSIT_CONFIRMED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T14:00:00Z",
  "data": {
    "depositId":        "dep_01HXYZ2222ABCDEF1111",
    "programId":        "prg_01HXYZ9876ABCDEF0000",
    "amountCents":      10000,
    "currency":         "USDT",
    "network":          "TRC20",
    "fromAddress":      "TXyZ1234567890abcdef1234567890abcdef12",
    "toAddress":        "TAbcdef1234567890abcdef1234567890abcd",
    "txHash":           "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "confirmations":    3,
    "status":           "CONFIRMED",
    "invoicesPaid": [
      {
        "invoiceId":   "inv_01HXYZ1111ABCDEF0000",
        "amountCents": 4999
      }
    ],
    "surplusCreditedCents": 5001,
    "programBalanceCents":  5001
  }
}

{}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

Fires when an incoming crypto deposit reaches 3 on-chain confirmations. The funds are credited to your program. Pending invoices are automatically paid and any surplus goes to the program balance.

​
Event Type

BILLING_DEPOSIT_CONFIRMED

​
Payload

{
  "event":       "BILLING_DEPOSIT_CONFIRMED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T14:00:00Z",
  "data": {
    "depositId":        "dep_01HXYZ2222ABCDEF1111",
    "programId":        "prg_01HXYZ9876ABCDEF0000",
    "amountCents":      10000,
    "currency":         "USDT",
    "network":          "TRC20",
    "fromAddress":      "TXyZ1234567890abcdef1234567890abcdef12",
    "toAddress":        "TAbcdef1234567890abcdef1234567890abcd",
    "txHash":           "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "confirmations":    3,
    "status":           "CONFIRMED",
    "invoicesPaid": [
      {
        "invoiceId":   "inv_01HXYZ1111ABCDEF0000",
        "amountCents": 4999
      }
    ],
    "surplusCreditedCents": 5001,
    "programBalanceCents":  5001
  }
}

​
Payload Fields

FieldTypeDescription
depositIdstringUnique deposit identifier
programIdstringThe program that received the deposit
amountCentsintegerTotal deposit amount in cents
currencystringUSDT or USDC
networkstringTRC20 or ERC20
fromAddressstringSender wallet address
toAddressstringYour program’s deposit address
txHashstringBlockchain transaction hash
confirmationsintegerFinal confirmation count (3 or more)
statusstringAlways CONFIRMED
invoicesPaidarrayInvoices automatically paid with this deposit
invoicesPaid[].invoiceIdstringInvoice ID
invoicesPaid[].amountCentsintegerAmount applied to this invoice, in cents
surplusCreditedCentsintegerAmount credited to the program balance after paying invoices, in cents
programBalanceCentsintegerProgram ledger balance after this deposit, in cents
For the full event group documentation see Billing Events. 
{
  "event":       "BILLING_DEPOSIT_CONFIRMED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T14:00:00Z",
  "data": {
    "depositId":        "dep_01HXYZ2222ABCDEF1111",
    "programId":        "prg_01HXYZ9876ABCDEF0000",
    "amountCents":      10000,
    "currency":         "USDT",
    "network":          "TRC20",
    "fromAddress":      "TXyZ1234567890abcdef1234567890abcdef12",
    "toAddress":        "TAbcdef1234567890abcdef1234567890abcd",
    "txHash":           "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "confirmations":    3,
    "status":           "CONFIRMED",
    "invoicesPaid": [
      {
        "invoiceId":   "inv_01HXYZ1111ABCDEF0000",
        "amountCents": 4999
      }
    ],
    "surplusCreditedCents": 5001,
    "programBalanceCents":  5001
  }
}

{}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
event
string
Example:

"BILLING_DEPOSIT_CONFIRMED"

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

Response

200

Acknowledge the event.