Skip to main content
WEBHOOK
CARD_UNLOAD_FAILED
{
  "event":       "CARD_UNLOAD_FAILED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":    "crd_01HXYZ5555ABCDEF1111",
    "programId": "prg_01HXYZ9876ABCDEF0000",
    "amount":    25.00,
    "currency":  "USD",
    "error":     "INSUFFICIENT_CARD_BALANCE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

{}

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 a POST /cards/{id}/unload request fails at the card provider level. No funds are moved — the program ledger is unchanged.

​
Event Type

CARD_UNLOAD_FAILED

​
Payload

{
  "event":       "CARD_UNLOAD_FAILED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":    "crd_01HXYZ5555ABCDEF1111",
    "programId": "prg_01HXYZ9876ABCDEF0000",
    "amount":    25.00,
    "currency":  "USD",
    "error":     "INSUFFICIENT_CARD_BALANCE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

​
Payload Fields

FieldTypeDescription
cardIdstringThe card the unload was attempted from
programIdstringThe program the unload was targeted at
amountnumberAmount that failed to unload (in dollars)
currencystringCurrency code (ISO 4217)
errorstringProvider error message
timestampstringISO 8601 timestamp
For the full event group documentation see Card Events. 
{
  "event":       "CARD_UNLOAD_FAILED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":    "crd_01HXYZ5555ABCDEF1111",
    "programId": "prg_01HXYZ9876ABCDEF0000",
    "amount":    25.00,
    "currency":  "USD",
    "error":     "INSUFFICIENT_CARD_BALANCE",
    "timestamp": "2026-05-22T10: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:

"CARD_UNLOAD_FAILED"

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

Response

200

Acknowledge the event.