{
"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": "sdkagent-1775638904623@example.com",
"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"
}
}持卡人与 KYC
持卡人KYC状态变更
持卡人 KYC 状态变更时发送,包括审核完成或需要补充资料的情况。
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": "sdkagent-1775638904623@example.com",
"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.status_changed | 持卡人 KYC 状态已变更,包括审核完成或需要补充资料的情况。 |
data.cardholder_status 处理 KYC 审核结果:
| 状态 | 审核结果 |
|---|---|
SUCCESS | 审核通过,持卡人已满足发卡的 KYC 要求。 |
FAILED | 审核被拒绝,请勿发卡。 |
INCOMPLETE | 需要补充或更正资料,请勿发卡。 |
cardholder.kyc.status_changed。data.reason 在有可用拒绝或补充资料说明时包含该说明;无可用说明或审核通过时为空。请根据状态判断结果,并兼容说明为空的情况。请求体
application/json
A unique identifier for this event.
Top-level event category. Always ISSUING for card issuance events.
可用选项:
ISSUING The specific event type that occurred.
可用选项:
cardholder.kyc.status_changed Cardholder ID.
API version number.
示例:
"V1.6.0"
Cardholder information included in KYC and cardholder update events.
Show child attributes
Show child attributes
响应
200
Return 200 to acknowledge receipt.

