Skip to main content
WEBHOOK
card.transaction.refunded
{
  "event": "card.transaction.refunded",
  "version": "3.20",
  "eventId": "c4d5e6f7-a8b9-0123-defa-234567890123",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "data": {
    "cardId": "crd_9x8y7z6w5v4u",
    "cardholderId": "CH-ABC123DEF456",
    "reference": "REF-004",
    "originalReference": "REF-001",
    "merchantName": "Amazon",
    "amount": 29.99,
    "currency": "USD",
    "cardBalanceAfter": 100,
    "timestamp": "2026-05-01T09:00:00+00:00"
  }
}

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.

{
  "event": "card.transaction.refunded",
  "version": "3.20",
  "eventId": "c4d5e6f7-a8b9-0123-defa-234567890123",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "data": {
    "cardId": "crd_9x8y7z6w5v4u",
    "cardholderId": "CH-ABC123DEF456",
    "amount": 29.99,
    "currency": "USD",
    "status": "REFUNDED",
    "timestamp": "2026-05-01T09:00:00+00:00"
  }
}

Body

application/json
​
event
string
Example:

"card.transaction.refunded"

​
version
string
Example:

"3.20"

​
eventId
string<uuid>

Unique event ID — use for deduplication

Example:

"c4d5e6f7-a8b9-0123-defa-234567890123"

​
sign
string

HMAC-SHA256 of the data object using your webhookSecret

Example:

"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"

​
data
object

Response

200

Acknowledge receipt of the event