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",
    "cardholderId":        "chl_01HXYZ1234ABCDEF5678",
    "programId":           "prg_01HXYZ9876ABCDEF0000",
    "amountCents":         5000,
    "currency":            "USD",
    "cardBalanceCents":    5000,
    "programBalanceCents": 99500000,
    "ledgerTransactionId": "ltx_01HXYZ9999ABCDEF2222"
  }
}

{}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

Fires after a successful POST /cards/{id}/fund request. Funds have moved from the program ledger to the card. The card’s balance increases and the program’s balance decreases by the same amount.

​
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",
    "cardholderId":        "chl_01HXYZ1234ABCDEF5678",
    "programId":           "prg_01HXYZ9876ABCDEF0000",
    "amountCents":         5000,
    "currency":            "USD",
    "cardBalanceCents":    5000,
    "programBalanceCents": 99500000,
    "ledgerTransactionId": "ltx_01HXYZ9999ABCDEF2222"
  }
}

​
Payload Fields

FieldTypeDescription
cardIdstringThe funded card ID
cardholderIdstringThe cardholder the card belongs to
programIdstringThe program that funded the card
amountCentsintegerAmount loaded in cents
currencystringCurrency code (ISO 4217)
cardBalanceCentsintegerCard balance after funding, in cents
programBalanceCentsintegerProgram ledger balance after funding, in cents
ledgerTransactionIdstringInternal ledger transaction reference

​
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",
    "cardholderId":        "chl_01HXYZ1234ABCDEF5678",
    "programId":           "prg_01HXYZ9876ABCDEF0000",
    "amountCents":         5000,
    "currency":            "USD",
    "cardBalanceCents":    5000,
    "programBalanceCents": 99500000,
    "ledgerTransactionId": "ltx_01HXYZ9999ABCDEF2222"
  }
}

{}

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.