{
"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"
}
}
{}
Card Events
CARD_FUNDED
Fired when funds are successfully loaded onto a card from the program ledger.
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”
{
"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
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.