CARD_FROZEN

{ "event": "CARD_FROZEN", "eventId": "evt_01HXY123456ABCDEF", "businessId": "BUS1A2B3C4D5E6F", "environment": "LIVE", "timestamp": "2026-05-22T10:00:00Z", "data": { "cardId": "crd_01HXYZ5555ABCDEF1111", "cardholderId": "chl_01HXYZ1234ABCDEF5678", "cardType": "VIRTUAL", "status": "FROZEN" } }

Payload

{
  "event":       "CARD_FROZEN",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":       "crd_01HXYZ5555ABCDEF1111",
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "cardType":     "VIRTUAL",
    "status":       "FROZEN"
  }
}

Field	Type	Description
`cardId`	string	The frozen card ID
`cardholderId`	string	The cardholder the card belongs to
`cardType`	string	`VIRTUAL` or `PHYSICAL`
`status`	string	Always `FROZEN`

Field

Type

Description

cardId

string

The frozen card ID

cardholderId

string

The cardholder the card belongs to

cardType

string

VIRTUAL or PHYSICAL

status

string

Always FROZEN

Common Use Cases

Notify the cardholder that their card has been temporarily blocked

Update the card status in your platform UI

For the full event group documentation see Card Events.

{
  "event":       "CARD_FROZEN",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":       "crd_01HXYZ5555ABCDEF1111",
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "cardType":     "VIRTUAL",
    "status":       "FROZEN"
  }
}

{}

Authorizations

Authorization

string

header

required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json

event

string

Example:

"CARD_FROZEN"

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

Common Use Cases

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

​Common Use Cases

Authorizations

Body

Response

Event Type

Payload

Payload Fields

Common Use Cases