{
"event": "CARDHOLDER_KYC_REJECTED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:10Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"kycStatus": "REJECTED",
"kycRejectionReason": "DOCUMENT_EXPIRED"
}
}
{}
Cardholder Events
CARDHOLDER_KYC_REJECTED
Fired when a cardholder’s KYC verification is rejected. The machine-readable rejection reason is included in the payload.
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",
"kycStatus": "REJECTED",
"kycRejectionReason": "DOCUMENT_EXPIRED"
}
}
{}
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.
Rejection reason values:
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",
"kycStatus": "REJECTED",
"kycRejectionReason": "DOCUMENT_EXPIRED"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardholderId | string | The cardholder whose KYC was rejected |
kycStatus | string | Always REJECTED |
kycRejectionReason | string | Machine-readable rejection reason — see values below |
| Value | Meaning |
|---|---|
DOCUMENT_EXPIRED | The submitted ID document has expired |
DOCUMENT_UNREADABLE | The document image was too blurry or incomplete |
NAME_MISMATCH | Name on document does not match cardholder profile |
UNDER_AGE | Cardholder is under 18 years old |
WATCHLIST_MATCH | Name matched a regulatory watchlist |
DUPLICATE_IDENTITY | Identity documents already used by another cardholder |
UNSUPPORTED_COUNTRY | Cardholder’s country is not supported for card issuance |
OTHER | Contact support for details |
What To Do When You Receive This Event
- Show the cardholder a specific message based on
kycRejectionReason - For
DOCUMENT_EXPIREDorDOCUMENT_UNREADABLE, invite them to retry with updated or clearer documents - For
WATCHLIST_MATCHorUNSUPPORTED_COUNTRY, do not allow retry — contact FYATU support
{
"event": "CARDHOLDER_KYC_REJECTED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:10Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"kycStatus": "REJECTED",
"kycRejectionReason": "DOCUMENT_EXPIRED"
}
}
{}
Authorizations
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.