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"
  }
}

{}

WEBHOOK

{
  "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.

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

Rejection reason values:

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_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",
    "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

Show child attributes

Response

200

Acknowledge the event.

Guides

JIT Authorization

Card Events

Transaction Events

Cardholder Events

Account Events

Billing Events

Event Type

Payload

Payload Fields

What To Do When You Receive This Event

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

​What To Do When You Receive This Event

Authorizations

Body

Response

Event Type

Payload

Payload Fields

What To Do When You Receive This Event