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

{}

WEBHOOK

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

Authorization

string

header

required

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

Body

application/json

event

string

Example:

"CARD_TERMINATION_REFUND"

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

Payload Fields

Common Use Cases

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

​Common Use Cases

Authorizations

Body

Response

Event Type

Payload

Payload Fields

Common Use Cases