Card Issuance Failed - FYATU API Docs

{
  "event": "card.failed",
  "version": "3.0",
  "eventId": "e2a7c5b1-48d0-4f36-9a2e-7b15c0d4f839",
  "sign": "3f8ad51c96b2e074cd83f1a5207b9e6c4d10af83b25e79cd604a1f3b82e5c917",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "cardName": "JOHN DOE",
    "last4": "",
    "reason": "The identity document was not accepted.",
    "refundAmount": 10.00,
    "providerEvent": "card.application_refunded",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-05-09T23:57:58Z"
  }
}

{}

WEBHOOK

card.failed

{
  "event": "card.failed",
  "version": "3.0",
  "eventId": "e2a7c5b1-48d0-4f36-9a2e-7b15c0d4f839",
  "sign": "3f8ad51c96b2e074cd83f1a5207b9e6c4d10af83b25e79cd604a1f3b82e5c917",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "cardName": "JOHN DOE",
    "last4": "",
    "reason": "The identity document was not accepted.",
    "refundAmount": 10.00,
    "providerEvent": "card.application_refunded",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-05-09T23:57:58Z"
  }
}

{}

The card was never issued and will never become usable. reason carries why. You may receive this event twice for one card: once when the issuance fails, and again once the application fee has actually been returned — the second carries refundAmount. They are separate facts, and the money is only back when the second arrives.

{
  "event": "card.failed",
  "version": "3.0",
  "eventId": "e2a7c5b1-48d0-4f36-9a2e-7b15c0d4f839",
  "sign": "3f8ad51c96b2e074cd83f1a5207b9e6c4d10af83b25e79cd604a1f3b82e5c917",
  "data": {
    "cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
    "cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
    "cardName": "JOHN DOE",
    "last4": "",
    "reason": "The identity document was not accepted.",
    "refundAmount": 10.00,
    "providerEvent": "card.application_refunded",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-05-09T23:57:58Z"
  }
}

{}

Body

application/json

event

string

The event type identifier (e.g. card.funded).

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