{
"event": "CARD_FUND_FAILED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"reference": "invoice-2026-001",
"amount": 50.00,
"currency": "USD",
"error": "CARD_NOT_ACTIVE",
"timestamp": "2026-05-22T10:00:00Z"
}
}
{}
Card Events
CARD_FUND_FAILED
Fired when a card funding attempt fails at the provider level. The program ledger debit is automatically reversed.
WEBHOOK
CARD_FUND_FAILED
{
"event": "CARD_FUND_FAILED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"reference": "invoice-2026-001",
"amount": 50.00,
"currency": "USD",
"error": "CARD_NOT_ACTIVE",
"timestamp": "2026-05-22T10:00:00Z"
}
}
{}
Fires when a
For the full event group documentation see Card Events.
POST /cards/{id}/fund request fails at the card provider level. The program ledger debit is automatically reversed — no funds are lost.
Event Type
CARD_FUND_FAILED
Payload
{
"event": "CARD_FUND_FAILED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"reference": "invoice-2026-001",
"amount": 50.00,
"currency": "USD",
"error": "CARD_NOT_ACTIVE",
"timestamp": "2026-05-22T10:00:00Z"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardId | string | The card that failed to receive funds |
reference | string or null | Your reference string from the fund request |
amount | number | Amount that failed to load, in dollars |
currency | string | Currency code (ISO 4217) |
error | string | Provider error message |
timestamp | string | ISO 8601 timestamp |
{
"event": "CARD_FUND_FAILED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"reference": "invoice-2026-001",
"amount": 50.00,
"currency": "USD",
"error": "CARD_NOT_ACTIVE",
"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.