Skip to main content
WEBHOOK
cardholder.kyc.approved
{
  "event": "cardholder.kyc.approved",
  "version": "3.20",
  "eventId": "a4b5c6d7-e8f9-0123-bcde-234567890123",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "data": {
    "cardholderId": "CH-ABC123DEF456",
    "firstName": "Jane",
    "lastName": "Doe",
    "kycLevel": "ACCEPTED",
    "kycStatus": "ACCEPTED",
    "timestamp": "2026-04-30T10:40: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": "cardholder.kyc.approved",
  "version": "3.20",
  "eventId": "a4b5c6d7-e8f9-0123-bcde-234567890123",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "data": {
    "cardholderId": "CH-ABC123DEF456",
    "firstName": "Jane",
    "lastName": "Doe",
    "kycStatus": "ACCEPTED",
    "timestamp": "2026-04-30T10:40:00+00:00"
  }
}

Body

application/json
​
event
string
Example:

"cardholder.kyc.approved"

​
version
string
Example:

"3.20"

​
eventId
string<uuid>

Unique event ID — use for deduplication

Example:

"a4b5c6d7-e8f9-0123-bcde-234567890123"

​
sign
string

HMAC-SHA256 of the data object using your webhookSecret

Example:

"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"

​
data
object

Response

200

Acknowledge receipt of the event