Skip to main content

Event metadata

  • name: ISSUING
  • types:
    • cardholder.kyc.rfi_required: Triggered when a manual reviewer requests additional information (RFI). The cardholder’s status changes to INCOMPLETE.

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 INCOMPLETE 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_required",
    "event_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "source_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
    "data": {
        "cardholder_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
        "cardholder_status": "INCOMPLETE",
        "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": "",
        "idv_status": "",
        "last_name": "Doe",
        "nationality": "SG",
        "phone_number": "+6512345678",
        "update_time": "2026-04-01T10:05:00+08:00"
    }
}