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

{}
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",
    "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
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",
    "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.