Skip to main content

​
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

FieldsData TypeDescription
event_idstringA unique ID for the event.
event_namestringEvent name.
event_typestringEvent type.
source_idstringCardholder id.
versionstringAPI Version number.
dataobjectRelated business objects.

​
data fields

FieldsData TypeDescription
cardholder_idstringThe affected cardholder’s unique identifier.
emailstringThe cardholder’s email address.
first_namestringThe cardholder’s first name.
last_namestringThe cardholder’s last name.
date_of_birthstringThe cardholder’s date of birth in yyyy-mm-dd format.
country_codestringThe cardholder’s country code.
nationalitystringThe cardholder’s nationality in ISO 3166-1 alpha-2 format.
phone_numberstringThe cardholder’s phone number.
cardholder_statusstringCurrent status: SUCCESS | PENDING | INCOMPLETE | FAILED.
idv_statusstringIDV verification status: PENDING | PASSED | FAILED. Empty if N/A.
idv_providerstringIDV provider name (e.g., SUMSUB). Empty if N/A.
create_timestringCardholder creation time in ISO 8601 format.
update_timestringLast update time in ISO 8601 format.

​
Notification example

{
    "version": "V1.6.0",
    "event_name": "ISSUING",
    "event_type": "cardholder.kyc.status_changed",
    "event_id": "d92ab1ec-1737-4b3c-bedb-7500a3c02677",
    "source_id": "9d6017b2-0c2f-4b2e-876b-992b0db9597d",
    "data": {
        "cardholder_id": "9d6017b2-0c2f-4b2e-876b-992b0db9597d",
        "cardholder_status": "SUCCESS",
        "country_code": "SG",
        "create_time": "2026-04-03T17:32:50+08:00",
        "date_of_birth": "1992-06-15",
        "email": "sarah.chen.nw6p38lu@example.com",
        "first_name": "Sarah",
        "idv_provider": "SUMSUB",
        "idv_status": "PASSED",
        "last_name": "Chen",
        "nationality": "SG",
        "phone_number": "90755646",
        "update_time": "2026-04-03T17:34:49+08:00"
    }
}