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",
    "programId":                 "prg_01HXYZ9876ABCDEF0000",
    "status":                    "TERMINATED",
    "remainingCents":            0,
    "refundedToProgramCents":    0
  }
}

{}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

Fires after a successful POST /cards/{id}/terminate request. Termination is irreversible — the card cannot be reactivated. Any remaining balance is automatically returned to the program ledger.

​
Event Type

CARD_TERMINATED

​
Payload

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

​
Payload Fields

FieldTypeDescription
cardIdstringThe terminated card ID
cardholderIdstringThe cardholder the card belonged to
programIdstringThe program the card belonged to
statusstringAlways TERMINATED
remainingCentsintegerCard balance at termination time, in cents
refundedToProgramCentsintegerAmount returned to the program ledger, in cents

​
Common Use Cases

  • Remove the card from the cardholder’s active card list in your UI
  • Log the termination for audit trail purposes
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",
    "programId":                 "prg_01HXYZ9876ABCDEF0000",
    "status":                    "TERMINATED",
    "remainingCents":            0,
    "refundedToProgramCents":    0
  }
}

{}

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.