Skip to main content
WEBHOOK
BILLING_DEPOSIT_DETECTED
{
  "event":       "BILLING_DEPOSIT_DETECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T13:58:00Z",
  "data": {
    "depositId":       "dep_01HXYZ2222ABCDEF1111",
    "programId":       "prg_01HXYZ9876ABCDEF0000",
    "amountCents":     10000,
    "currency":        "USDT",
    "network":         "TRC20",
    "fromAddress":     "TXyZ1234567890abcdef1234567890abcdef12",
    "toAddress":       "TAbcdef1234567890abcdef1234567890abcd",
    "txHash":          "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "confirmations":   0,
    "requiredConfirmations": 3,
    "status":          "DETECTED"
  }
}

{}

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 inbound crypto transfer to your program’s deposit address is detected on-chain with 0 confirmations. The deposit is not yet credited — wait for BILLING_DEPOSIT_CONFIRMED before treating funds as available.

​
Event Type

BILLING_DEPOSIT_DETECTED

​
Payload

{
  "event":       "BILLING_DEPOSIT_DETECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T13:58:00Z",
  "data": {
    "depositId":       "dep_01HXYZ2222ABCDEF1111",
    "programId":       "prg_01HXYZ9876ABCDEF0000",
    "amountCents":     10000,
    "currency":        "USDT",
    "network":         "TRC20",
    "fromAddress":     "TXyZ1234567890abcdef1234567890abcdef12",
    "toAddress":       "TAbcdef1234567890abcdef1234567890abcd",
    "txHash":          "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "confirmations":   0,
    "requiredConfirmations": 3,
    "status":          "DETECTED"
  }
}

​
Payload Fields

FieldTypeDescription
depositIdstringUnique deposit identifier assigned by FYATU
programIdstringThe program receiving the deposit
amountCentsintegerDeposit amount in cents
currencystringUSDT or USDC
networkstringTRC20 or ERC20
fromAddressstringSender wallet address
toAddressstringYour program’s deposit address
txHashstringBlockchain transaction hash
confirmationsintegerCurrent confirmation count (0 at detection)
requiredConfirmationsintegerConfirmations required before crediting (3)
statusstringAlways DETECTED
For the full event group documentation see Billing Events. 
{
  "event":       "BILLING_DEPOSIT_DETECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T13:58:00Z",
  "data": {
    "depositId":       "dep_01HXYZ2222ABCDEF1111",
    "programId":       "prg_01HXYZ9876ABCDEF0000",
    "amountCents":     10000,
    "currency":        "USDT",
    "network":         "TRC20",
    "fromAddress":     "TXyZ1234567890abcdef1234567890abcdef12",
    "toAddress":       "TAbcdef1234567890abcdef1234567890abcd",
    "txHash":          "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "confirmations":   0,
    "requiredConfirmations": 3,
    "status":          "DETECTED"
  }
}

{}

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_DETECTED"

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

Response

200

Acknowledge the event.