Skip to main content
WEBHOOK
CARDHOLDER_KYC_REJECTED
{
  "event":       "CARDHOLDER_KYC_REJECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:10Z",
  "data": {
    "cardholderId":      "chl_01HXYZ1234ABCDEF5678",
    "programId":         "prg_01HXYZ9876ABCDEF0000",
    "kycStatus":         "REJECTED",
    "kycRejectionReason": "DOCUMENT_EXPIRED"
  }
}

{}

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.

Fires when a cardholder’s identity verification fails. Cards cannot be issued to this cardholder until the rejection is resolved. Contact FYATU support if you believe a rejection was issued in error.

​
Event Type

CARDHOLDER_KYC_REJECTED

​
Payload

{
  "event":       "CARDHOLDER_KYC_REJECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:10Z",
  "data": {
    "cardholderId":      "chl_01HXYZ1234ABCDEF5678",
    "programId":         "prg_01HXYZ9876ABCDEF0000",
    "kycStatus":         "REJECTED",
    "kycRejectionReason": "DOCUMENT_EXPIRED"
  }
}

​
Payload Fields

FieldTypeDescription
cardholderIdstringThe cardholder whose KYC was rejected
programIdstringThe program the cardholder belongs to
kycStatusstringAlways REJECTED
kycRejectionReasonstringMachine-readable rejection reason — see values below
Rejection reason values:
ValueMeaning
DOCUMENT_EXPIREDThe submitted ID document has expired
DOCUMENT_UNREADABLEThe document image was too blurry or incomplete
NAME_MISMATCHName on document does not match cardholder profile
UNDER_AGECardholder is under 18 years old
WATCHLIST_MATCHName matched a regulatory watchlist
DUPLICATE_IDENTITYIdentity documents already used by another cardholder
UNSUPPORTED_COUNTRYCardholder’s country is not supported for card issuance
OTHERContact support for details

​
What To Do When You Receive This Event

  • Show the cardholder a specific message based on kycRejectionReason
  • For DOCUMENT_EXPIRED or DOCUMENT_UNREADABLE, invite them to retry with updated or clearer documents
  • For WATCHLIST_MATCH or UNSUPPORTED_COUNTRY, do not allow retry — contact FYATU support
For the full event group documentation see Cardholder Events. 
{
  "event":       "CARDHOLDER_KYC_REJECTED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:10Z",
  "data": {
    "cardholderId":      "chl_01HXYZ1234ABCDEF5678",
    "programId":         "prg_01HXYZ9876ABCDEF0000",
    "kycStatus":         "REJECTED",
    "kycRejectionReason": "DOCUMENT_EXPIRED"
  }
}

{}

Authorizations

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json
​
event
string
Example:

"CARDHOLDER_KYC_REJECTED"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.