Skip to main content
WEBHOOK
card.transaction.declined
{
  "event": "card.transaction.declined",
  "version": "3.20",
  "eventId": "a2b3c4d5-e6f7-8901-bcde-f12345678901",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "data": {
    "cardId": "crd_9x8y7z6w5v4u",
    "cardholderId": "CH-ABC123DEF456",
    "reference": "REF-002",
    "amount": 15.99,
    "currency": "USD",
    "merchant": {
      "name": "Netflix",
      "category": "7841"
    },
    "reason": "INSUFFICIENT_FUNDS",
    "status": "DECLINED",
    "timestamp": "2026-04-30T10:36: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.declined",
  "version": "3.20",
  "eventId": "a2b3c4d5-e6f7-8901-bcde-f12345678901",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "data": {
    "cardId": "crd_9x8y7z6w5v4u",
    "cardholderId": "CH-ABC123DEF456",
    "amount": 15.99,
    "currency": "USD",
    "reason": "INSUFFICIENT_FUNDS",
    "status": "DECLINED",
    "timestamp": "2026-04-30T10:36:00+00:00"
  }
}

Body

application/json
​
event
string
Example:

"card.transaction.declined"

​
version
string
Example:

"3.20"

​
eventId
string<uuid>

Unique event ID — use for deduplication

Example:

"a2b3c4d5-e6f7-8901-bcde-f12345678901"

​
sign
string

HMAC-SHA256 of the data object using your webhookSecret

Example:

"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"

​
data
object

Response

200

Acknowledge receipt of the event