{
"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"
}
}
{}
Card Events
CARD_TERMINATED
Fired when a card is permanently terminated — either manually via the API or automatically after a single-use card settles its first transaction.
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}/terminateAPI call or via the portal. Thereasonfield is absent. - Automatic (single-use) — triggered by the system after a single-use card’s first transaction clears. The
reasonfield isSINGLE_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
{
"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
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.