Skip to main content
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"
  }
}

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

FieldTypeDescription
cardIdstringThe terminated card ID
cardholderIdstringThe cardholder the card belonged to
cardTypestringVIRTUAL or PHYSICAL
statusstringAlways TERMINATED
reasonstringSINGLE_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"
  }
}

{}

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

Response

200

Acknowledge the event.