Skip to main content
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",
    "programId": "prg_01HXYZ9876ABCDEF0000",
    "amount":    50.00,
    "currency":  "USD",
    "error":     "CARD_NOT_ACTIVE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

{}

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 when a 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",
    "programId": "prg_01HXYZ9876ABCDEF0000",
    "amount":    50.00,
    "currency":  "USD",
    "error":     "CARD_NOT_ACTIVE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

​
Payload Fields

FieldTypeDescription
cardIdstringThe card that failed to receive funds
programIdstringThe program the funding was attempted from
amountnumberAmount that failed to load (in dollars)
currencystringCurrency code (ISO 4217)
errorstringProvider error message
timestampstringISO 8601 timestamp
For the full event group documentation see Card Events. 
{
  "event":       "CARD_FUND_FAILED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":    "crd_01HXYZ5555ABCDEF1111",
    "programId": "prg_01HXYZ9876ABCDEF0000",
    "amount":    50.00,
    "currency":  "USD",
    "error":     "CARD_NOT_ACTIVE",
    "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_FUND_FAILED"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.