CARD_FUNDED

{
  "event":       "CARD_FUNDED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":              "crd_01HXYZ5555ABCDEF1111",
    "amount":              50.00,
    "currency":            "USD",
    "reference":           "invoice-2026-001",
    "ledgerTransactionId": "ltx_01HXYZ9999ABCDEF2222",
    "timestamp":           "2026-05-22T10:00:00Z"
  }
}

{}

WEBHOOK

CARD_FUNDED

{
  "event":       "CARD_FUNDED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":              "crd_01HXYZ5555ABCDEF1111",
    "amount":              50.00,
    "currency":            "USD",
    "reference":           "invoice-2026-001",
    "ledgerTransactionId": "ltx_01HXYZ9999ABCDEF2222",
    "timestamp":           "2026-05-22T10:00:00Z"
  }
}

{}

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

Event Type

CARD_FUNDED

Payload

{
  "event":       "CARD_FUNDED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":              "crd_01HXYZ5555ABCDEF1111",
    "amount":              50.00,
    "currency":            "USD",
    "reference":           "invoice-2026-001",
    "ledgerTransactionId": "ltx_01HXYZ9999ABCDEF2222",
    "timestamp":           "2026-05-22T10:00:00Z"
  }
}

Payload Fields

Field	Type	Description
`cardId`	string	The funded card ID
`amount`	number	Amount loaded in dollars
`currency`	string	Currency code (ISO 4217)
`reference`	string or null	Your reference string from the fund request
`ledgerTransactionId`	string	Internal ledger transaction reference
`timestamp`	string	ISO 8601 timestamp of the funding operation

Common Use Cases

Update the displayed card balance in your UI
Confirm a load completed successfully without polling
Send the cardholder a push notification: “Your card has been topped up with $50”

For the full event group documentation see Card Events.

{
  "event":       "CARD_FUNDED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":              "crd_01HXYZ5555ABCDEF1111",
    "amount":              50.00,
    "currency":            "USD",
    "reference":           "invoice-2026-001",
    "ledgerTransactionId": "ltx_01HXYZ9999ABCDEF2222",
    "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_FUNDED"

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