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" } }

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

Field	Type	Description
`cardId`	string	The card funds were unloaded from
`amount`	number	Amount unloaded in dollars
`currency`	string	Currency code (ISO 4217)
`reference`	string or null	Your reference string from the unload request
`ledgerTransactionId`	string	Internal ledger transaction reference
`timestamp`	string	ISO 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

Show child attributes

Response

200

Acknowledge the event.

Guides

JIT Authorization

Card Events

Transaction Events

Cardholder Events

Account Events

Billing Events

Event Type

Payload

Payload Fields

Common Use Cases

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

​Common Use Cases

Authorizations

Body

Response

Event Type

Payload

Payload Fields

Common Use Cases