{
"event": "CARD_TERMINATION_REFUND",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-07-08T09:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chd_01HXYZ1111ABCDEF0000",
"amount": 12.50,
"currency": "USD",
"reference": "9f1e6b31f6fd010a6e8bdd317e8579",
"timestamp": "2026-07-08T09:00:00Z"
}
}
{}
Card Events
CARD_TERMINATION_REFUND
Fired when a terminated card’s remaining balance is refunded back to your program.
WEBHOOK
CARD_TERMINATION_REFUND
{
"event": "CARD_TERMINATION_REFUND",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-07-08T09:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chd_01HXYZ1111ABCDEF0000",
"amount": 12.50,
"currency": "USD",
"reference": "9f1e6b31f6fd010a6e8bdd317e8579",
"timestamp": "2026-07-08T09:00:00Z"
}
}
{}
Fires when a card is terminated and its remaining prefunded balance is returned to your program balance.
The
reference is the provider transaction id — unique per refund — so use it as your idempotency key.
Event Type
CARD_TERMINATION_REFUND
Payload
{
"event": "CARD_TERMINATION_REFUND",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-07-08T09:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chd_01HXYZ1111ABCDEF0000",
"amount": 12.50,
"currency": "USD",
"reference": "9f1e6b31f6fd010a6e8bdd317e8579",
"timestamp": "2026-07-08T09:00:00Z"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardId | string | The terminated card ID |
cardholderId | string | The cardholder the card belonged to |
amount | number | Refunded amount, credited to your program balance |
currency | string | ISO-4217 currency of the refund |
reference | string | Provider transaction id — unique per refund; use it as your idempotency key |
timestamp | string | ISO 8601 time the refund was processed |
Common Use Cases
- Reconcile the returned balance against your program ledger
- Log the refund for audit purposes, keyed on
reference
Deduplicate on
reference. A webhook retry re-delivers the same reference; a genuinely
new refund always carries a new one.{
"event": "CARD_TERMINATION_REFUND",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-07-08T09:00:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chd_01HXYZ1111ABCDEF0000",
"amount": 12.50,
"currency": "USD",
"reference": "9f1e6b31f6fd010a6e8bdd317e8579",
"timestamp": "2026-07-08T09:00:00Z"
}
}
{}
Authorizations
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.