Skip to main content
WEBHOOK
card.transaction.approved
{
  "event": "card.transaction.approved",
  "version": "3.20",
  "eventId": "f3a1b2c4-d5e6-7890-abcd-ef1234567890",
  "sign": "3a5b8c2d1e4f9a0b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b",
  "data": {
    "cardId": "crd_9x8y7z6w5v4u",
    "cardholderId": "CH-ABC123DEF456",
    "reference": "REF-001",
    "amount": 29.99,
    "currency": "USD",
    "merchant": {
      "name": "Amazon",
      "category": "5999",
      "country": "US"
    },
    "cardBalanceBefore": 100,
    "cardBalanceAfter": 70.01,
    "status": "APPROVED",
    "timestamp": "2026-04-30T10:35: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.approved",
  "version": "3.20",
  "eventId": "f3a1b2c4-d5e6-7890-abcd-ef1234567890",
  "sign": "3a5b8c2d1e4f9a0b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b",
  "data": {
    "cardId": "crd_9x8y7z6w5v4u",
    "cardholderId": "CH-ABC123DEF456",
    "amount": 29.99,
    "currency": "USD",
    "status": "APPROVED",
    "timestamp": "2026-04-30T10:35:00+00:00"
  }
}

Body

application/json
​
event
string
Example:

"card.transaction.approved"

​
version
string
Example:

"3.20"

​
eventId
string<uuid>

Unique event ID — use for deduplication

Example:

"f3a1b2c4-d5e6-7890-abcd-ef1234567890"

​
sign
string

HMAC-SHA256 of the data object using your webhookSecret

Example:

"3a5b8c2d1e4f9a0b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b"

​
data
object

Response

200

Acknowledge receipt of the event