CARD_TERMINATED

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

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

{}

WEBHOOK

CARD_TERMINATED

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

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

{}

Fires after a card is permanently terminated. Termination is irreversible — the card cannot be reactivated. There are two termination paths:

Manual — triggered by a POST /cards/{id}/terminate API call or via the portal. The reason field is absent.
Automatic (single-use) — triggered by the system after a single-use card’s first transaction clears. The reason field is SINGLE_USE_EXHAUSTED.

Event Type

CARD_TERMINATED

Payload

Manual termination

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

Single-use auto-termination

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

Payload Fields

Field	Type	Description
`cardId`	string	The terminated card ID
`cardholderId`	string	The cardholder the card belonged to
`cardType`	string	`VIRTUAL` or `PHYSICAL`
`status`	string	Always `TERMINATED`
`reason`	string	`SINGLE_USE_EXHAUSTED` for automatic single-use terminations. Absent for manual terminations.

Common Use Cases

Remove the card from the cardholder’s active card list in your UI
Log the termination for audit trail purposes
On reason: SINGLE_USE_EXHAUSTED — mark the single-use card as consumed in your system

For the full event group documentation see Card Events.

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

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

{}

Authorizations

Authorization

string

header

required

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

Body

application/json

event

string

Example:

"CARD_TERMINATED"

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

Manual termination

Single-use auto-termination

Payload Fields

Common Use Cases

Authorizations

Body

Response

​Event Type

​Payload

​Manual termination

​Single-use auto-termination

​Payload Fields

​Common Use Cases

Authorizations

Body

Response

Event Type

Payload

Manual termination

Single-use auto-termination

Payload Fields

Common Use Cases