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",
    "amount":    25.00,
    "currency":  "USD",
    "error":     "INSUFFICIENT_CARD_BALANCE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

{}
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",
    "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
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",
    "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.