Skip to main content
WEBHOOK
CARD_UNLOADED
{
  "event":       "CARD_UNLOADED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":              "crd_01HXYZ5555ABCDEF1111",
    "amount":              25.00,
    "currency":            "USD",
    "reference":           "rebalance-2026-05",
    "ledgerTransactionId": "ltx_01HXYZ8888ABCDEF3333",
    "timestamp":           "2026-05-22T10:00:00Z"
  }
}

{}
Fires after a successful POST /cards/{id}/unload request. Funds have moved from the card back to the program ledger.

​
Event Type

CARD_UNLOADED

​
Payload

{
  "event":       "CARD_UNLOADED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":              "crd_01HXYZ5555ABCDEF1111",
    "amount":              25.00,
    "currency":            "USD",
    "reference":           "rebalance-2026-05",
    "ledgerTransactionId": "ltx_01HXYZ8888ABCDEF3333",
    "timestamp":           "2026-05-22T10:00:00Z"
  }
}

​
Payload Fields

FieldTypeDescription
cardIdstringThe card funds were unloaded from
amountnumberAmount unloaded in dollars
currencystringCurrency code (ISO 4217)
referencestring or nullYour reference string from the unload request
ledgerTransactionIdstringInternal ledger transaction reference
timestampstringISO 8601 timestamp of the unload operation

​
Common Use Cases

  • Reflect the updated card balance in your UI
  • Confirm a partial unload before proceeding with a withdrawal
For the full event group documentation see Card Events. 
{
  "event":       "CARD_UNLOADED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":              "crd_01HXYZ5555ABCDEF1111",
    "amount":              25.00,
    "currency":            "USD",
    "reference":           "rebalance-2026-05",
    "ledgerTransactionId": "ltx_01HXYZ8888ABCDEF3333",
    "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_UNLOADED"

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

Response

200

Acknowledge the event.