Card Termination Refund - FYATU API Docs

{
  "event": "card.termination_refund",
  "version": "3.0",
  "eventId": "447b7b5d-bcbf-40b3-907b-e7c0ec390377",
  "sign": "36e920701fa5a4348e3075aa7ead358818c4768fa5a3e8a36d69942bc066f2c2",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "amount": 12.50,
    "currency": "USD",
    "reference": "9f1e6b31f6fd010a6e8bdd317e8579",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-07-08T09:00:00Z"
  }
}

{}

WEBHOOK

card.termination_refund

{
  "event": "card.termination_refund",
  "version": "3.0",
  "eventId": "447b7b5d-bcbf-40b3-907b-e7c0ec390377",
  "sign": "36e920701fa5a4348e3075aa7ead358818c4768fa5a3e8a36d69942bc066f2c2",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "amount": 12.50,
    "currency": "USD",
    "reference": "9f1e6b31f6fd010a6e8bdd317e8579",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-07-08T09:00:00Z"
  }
}

{}

Fired once when a card is terminated and its remaining balance is returned to your business wallet. The reference field is the provider transaction id — it is unique per refund, so use it as your idempotency key to avoid processing the same refund twice.

{
  "event": "card.termination_refund",
  "version": "3.0",
  "eventId": "447b7b5d-bcbf-40b3-907b-e7c0ec390377",
  "sign": "36e920701fa5a4348e3075aa7ead358818c4768fa5a3e8a36d69942bc066f2c2",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "amount": 12.50,
    "currency": "USD",
    "reference": "9f1e6b31f6fd010a6e8bdd317e8579",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-07-08T09:00:00Z"
  }
}

{}

Body

application/json

event

string

The event type identifier.

version

string

Webhook payload version.

sign

string

HMAC-SHA256 signature of the data object using your webhook secret. Always verify this before processing.

data

object

Show child attributes

Response

200

Acknowledge receipt of the event