{
"version": "V1.6.0",
"event_name": "ISSUING",
"event_type": "cardholder.kyc.status_changed",
"event_id": "656154ea-6dde-4844-bd98-f37eb997e129",
"source_id": "811001d4-9862-4cc6-90d8-ebc829fcfd41",
"data": {
"cardholder_id": "811001d4-9862-4cc6-90d8-ebc829fcfd41",
"cardholder_status": "SUCCESS",
"country_code": "SG",
"create_time": "2026-04-08T17:01:47+08:00",
"date_of_birth": "1990-01-15",
"email": "[email protected]",
"first_name": "Sdk",
"idv_provider": "SUMSUB",
"idv_status": "PASSED",
"last_name": "Agent",
"nationality": "SG",
"phone_number": "98904623",
"update_time": "2026-04-08T17:01:47+08:00"
}
}Cardholder & KYC
Cardholder KYC Status Changed
Published when a cardholder’s KYC status changes, including review outcomes and requests for additional information.
WEBHOOK
cardholderKycStatusChanged
{
"version": "V1.6.0",
"event_name": "ISSUING",
"event_type": "cardholder.kyc.status_changed",
"event_id": "656154ea-6dde-4844-bd98-f37eb997e129",
"source_id": "811001d4-9862-4cc6-90d8-ebc829fcfd41",
"data": {
"cardholder_id": "811001d4-9862-4cc6-90d8-ebc829fcfd41",
"cardholder_status": "SUCCESS",
"country_code": "SG",
"create_time": "2026-04-08T17:01:47+08:00",
"date_of_birth": "1990-01-15",
"email": "[email protected]",
"first_name": "Sdk",
"idv_provider": "SUMSUB",
"idv_status": "PASSED",
"last_name": "Agent",
"nationality": "SG",
"phone_number": "98904623",
"update_time": "2026-04-08T17:01:47+08:00"
}
}Event Types
| Event Type | Description |
|---|---|
cardholder.kyc.status_changed | The cardholder’s KYC status has changed, including when a review completes or additional information is required. |
data.cardholder_status to handle KYC review outcomes:
| Status | Review outcome |
|---|---|
SUCCESS | Approved. The cardholder meets the KYC requirements for card issuance. |
FAILED | Rejected. Do not issue a card. |
INCOMPLETE | Additional or corrected information is required. Do not issue a card. |
cardholder.kyc.status_changed. data.reason contains the rejection or additional-information explanation when available; it is empty when no explanation is available or the review is approved. Use the status to determine the outcome and handle an empty explanation.Body
application/json
A unique identifier for this event.
Top-level event category. Always ISSUING for card issuance events.
Available options:
ISSUING The specific event type that occurred.
Available options:
cardholder.kyc.status_changed Cardholder ID.
API version number.
Example:
"V1.6.0"
Cardholder information included in KYC and cardholder update events.
Show child attributes
Show child attributes
Response
200
Return 200 to acknowledge receipt.