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" } }

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

Field	Type	Description
`cardId`	string	The card that failed to receive funds
`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

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

Show child attributes

Response

200

Acknowledge the event.

Guides

JIT Authorization

Card Events

Transaction Events

Cardholder Events

Account Events

Billing Events

Event Type

Payload

Payload Fields

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

Authorizations

Body

Response

Event Type

Payload

Payload Fields