Skip to main content
WEBHOOK
ACCOUNT_WITHDRAWAL_INITIATED
{
  "event":       "ACCOUNT_WITHDRAWAL_INITIATED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T15:00:00Z",
  "data": {
    "withdrawalId": "wdr_01HXYZ6666ABCDEF0000",
    "programId":    "prg_01HXYZ9876ABCDEF0000",
    "amount":       5000.00,
    "token":        "USDT",
    "network":      "TRC20",
    "toAddress":    "TXyZ1234567890abcdef1234567890abcdef12",
    "timestamp":    "2026-05-22T15:00:00Z"
  }
}

{}
Fires when a withdrawal request from the program ledger is created. The requested funds are reserved in a suspense ledger while the transfer is processed.

​
Event Type

ACCOUNT_WITHDRAWAL_INITIATED

​
Payload

{
  "event":       "ACCOUNT_WITHDRAWAL_INITIATED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T15:00:00Z",
  "data": {
    "withdrawalId": "wdr_01HXYZ6666ABCDEF0000",
    "programId":    "prg_01HXYZ9876ABCDEF0000",
    "amount":       5000.00,
    "token":        "USDT",
    "network":      "TRC20",
    "toAddress":    "TXyZ1234567890abcdef1234567890abcdef12",
    "timestamp":    "2026-05-22T15:00:00Z"
  }
}

​
Payload Fields

FieldTypeDescription
withdrawalIdstringUnique withdrawal identifier
programIdstringThe program being withdrawn from
amountnumberWithdrawal amount (in dollars)
tokenstringUSDT or USDC
networkstringTRC20 or ERC20
toAddressstringDestination wallet address
timestampstringISO 8601 timestamp
For the full event group documentation see Account Events. 
{
  "event":       "ACCOUNT_WITHDRAWAL_INITIATED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T15:00:00Z",
  "data": {
    "withdrawalId": "wdr_01HXYZ6666ABCDEF0000",
    "programId":    "prg_01HXYZ9876ABCDEF0000",
    "amount":       5000.00,
    "token":        "USDT",
    "network":      "TRC20",
    "toAddress":    "TXyZ1234567890abcdef1234567890abcdef12",
    "timestamp":    "2026-05-22T15:00:00Z"
  }
}

{}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
event
string
Example:

"ACCOUNT_WITHDRAWAL_INITIATED"

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

Response

200

Acknowledge the event.