{
"event": "CARD_UNLOAD_FAILED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"reference": "rebalance-2026-05",
"amount": 25.00,
"currency": "USD",
"error": "INSUFFICIENT_CARD_BALANCE",
"timestamp": "2026-05-22T10:00:00Z"
}
}
{}
Card Events
CARD_UNLOAD_FAILED
Fired when a card unload attempt fails at the provider level. No funds are moved.
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",
"reference": "rebalance-2026-05",
"amount": 25.00,
"currency": "USD",
"error": "INSUFFICIENT_CARD_BALANCE",
"timestamp": "2026-05-22T10:00:00Z"
}
}
{}
Fires when a
For the full event group documentation see Card Events.
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",
"reference": "rebalance-2026-05",
"amount": 25.00,
"currency": "USD",
"error": "INSUFFICIENT_CARD_BALANCE",
"timestamp": "2026-05-22T10:00:00Z"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardId | string | The card the unload was attempted from |
reference | string or null | Your reference string from the unload request |
amount | number | Amount that failed to unload, in dollars |
currency | string | Currency code (ISO 4217) |
error | string | Provider error message |
timestamp | string | ISO 8601 timestamp |
{
"event": "CARD_UNLOAD_FAILED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"reference": "rebalance-2026-05",
"amount": 25.00,
"currency": "USD",
"error": "INSUFFICIENT_CARD_BALANCE",
"timestamp": "2026-05-22T10:00:00Z"
}
}
{}
Authorizations
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.