cardholder.kyc.status_changed

Event metadata

name: ISSUING
types:
- cardholder.kyc.status_changed: Triggered when the cardholder's KYC status changes (e.g., review initiated after creation, callback updates status, manual review result).

Request body

Fields	Data Type	Description
`event_id`	`string`	A unique ID for the event.
`event_name`	`string`	Event name.
`event_type`	`string`	Event type.
`source_id`	`string`	Cardholder id.
`version`	`string`	API Version number.
`data`	`object`	Related business objects.

`data` fields

Fields	Data Type	Description
`cardholder_id`	`string`	The affected cardholder's unique identifier.
`email`	`string`	The cardholder's email address.
`first_name`	`string`	The cardholder's first name.
`last_name`	`string`	The cardholder's last name.
`date_of_birth`	`string`	The cardholder's date of birth in `yyyy-mm-dd` format.
`country_code`	`string`	The cardholder's country code.
`nationality`	`string`	The cardholder's nationality in ISO 3166-1 alpha-2 format.
`phone_number`	`string`	The cardholder's phone number.
`cardholder_status`	`string`	Current status: `SUCCESS` \| `PENDING` \| `INCOMPLETE` \| `FAILED`.
`idv_status`	`string`	IDV verification status: `PENDING` \| `PASSED` \| `FAILED`. Empty if N/A.
`idv_provider`	`string`	IDV provider name (e.g., `SUMSUB`). Empty if N/A.
`create_time`	`string`	Cardholder creation time in ISO 8601 format.

Notification example

cardholder.kyc.status_changed

{
    "version": "V1.6.0",
    "event_name": "cardholder.kyc.status_changed",
    "event_type": "cardholder.kyc.status_changed",
    "event_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "source_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
    "data": {
        "cardholder_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
        "email": "[email protected]",
        "first_name": "John",
        "last_name": "Doe",
        "date_of_birth": "1990-01-01",
        "country_code": "SG",
        "nationality": "SG",
        "phone_number": "+6512345678",
        "cardholder_status": "SUCCESS",
        "idv_status": "",
        "idv_provider": "",
        "create_time": "2026-04-01T10:00:00Z"
    }
}