BILLING_DEPOSIT_DETECTED

{
  "event":       "BILLING_DEPOSIT_DETECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T13:58:00Z",
  "data": {
    "depositId": "dep_01HXYZ2222ABCDEF1111",
    "amount":    100.00,
    "currency":  "USDT",
    "network":   "TRC20",
    "txHash":    "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "timestamp": "2026-06-05T13:58:00Z"
  }
}

{}

WEBHOOK

{
  "event":       "BILLING_DEPOSIT_DETECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-05T13:58:00Z",
  "data": {
    "depositId": "dep_01HXYZ2222ABCDEF1111",
    "amount":    100.00,
    "currency":  "USDT",
    "network":   "TRC20",
    "txHash":    "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "timestamp": "2026-06-05T13:58:00Z"
  }
}

{}

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",
    "amount":    100.00,
    "currency":  "USDT",
    "network":   "TRC20",
    "txHash":    "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "timestamp": "2026-06-05T13:58:00Z"
  }
}

Payload Fields

Field	Type	Description
`depositId`	string	Unique deposit identifier assigned by FYATU
`amount`	number	Deposit amount in dollars
`currency`	string	Token symbol — `USDT` or `USDC`
`network`	string	Blockchain network — `TRC20` or `ERC20`
`txHash`	string	Blockchain transaction hash
`timestamp`	string	ISO 8601 timestamp of detection

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",
    "amount":    100.00,
    "currency":  "USDT",
    "network":   "TRC20",
    "txHash":    "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "timestamp": "2026-06-05T13:58:00Z"
  }
}

{}

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

Show child attributes

Response

200

Acknowledge the event.

Guides

JIT Authorization

Card Events

Transaction Events

Cardholder Events

Account Events

Billing Events

Event Type

Payload

Payload Fields

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

Authorizations

Body

Response

Event Type

Payload

Payload Fields