Skip to main content

​
Event metadata

  • name: ISSUING
  • types:
    • cardholder.kyc.rfi_submitted: Triggered when a merchant submits supplementary review documents after receiving an RFI request.

​
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, always PENDING for this event.
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.rfi_submitted",
    "event_id": "d4e5f6a7-b8c9-0123-def0-234567890123",
    "source_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
    "data": {
        "cardholder_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
        "cardholder_status": "PENDING",
        "country_code": "SG",
        "create_time": "2026-04-01T10:00:00+08:00",
        "date_of_birth": "1990-01-01",
        "email": "user@example.com",
        "first_name": "John",
        "idv_provider": "SUMSUB",
        "idv_status": "PASSED",
        "last_name": "Doe",
        "nationality": "SG",
        "phone_number": "+6512345678",
        "update_time": "2026-04-01T10:10:00+08:00"
    }
}