Skip to main content
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

FieldTypeDescription
cardIdstringThe funded card ID
amountnumberAmount loaded in dollars
currencystringCurrency code (ISO 4217)
referencestring or nullYour reference string from the fund request
ledgerTransactionIdstringInternal ledger transaction reference
timestampstringISO 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

Response

200

Acknowledge the event.