curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/apply \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"cardholder_no": "",
"cardholder_unique_no": "MERCHANT_USER_001",
"sumsub_share_token": "your_sumsub_share_token"
}'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": ""
}
}
持卡人相关
持卡人认证申请
POST
/
open-api
/
v1
/
cardholder
/
apply
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/apply \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"cardholder_no": "",
"cardholder_unique_no": "MERCHANT_USER_001",
"sumsub_share_token": "your_sumsub_share_token"
}'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": ""
}
}
新建或更新持卡人 KYC 认证申请。
KYC 认证存在受限地区。提交申请前，请查看受限场景/区域中的 KYC 限制区域清单。
KYC 审核需要一定时间：正式环境预计约 1 个工作日，沙盒环境预计约 10 分钟。如长时间未完成审核，请联系技术支持。
请求头
string
必填
apiKey（商户凭证，与 IP 白名单绑定）
string
必填
Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
string
必填
登录标识（除获取 Token 外必填）
string
默认值:"application/json"
固定为
application/json请求体
string
持卡人单号（更新认证时必填）
string
必填
商户侧持卡人唯一单号
string
必填
Sumsub shareToken
- 新建：不传
cardholder_no，须传cardholder_unique_no+sumsub_share_token。 - 更新认证：须传
cardholder_no，且cardholder_unique_no须与平台记录一致。
字段校验建议
Sumsub 填写可以使用其他语言，以下字段，需要可以从sharetoken中获取到； Sumsub 会生成对应的英文字段，只要生成的 Sumsub 英文字段符合以下规则即可。- 街道 / 城市 / 省州：空、纯数字、或去空格后只有 1 个字符 → 失败。默认还会去掉符号后再判一次。
- 纯数字：
^\d+$ - 去符号：
[^\p{L}\p{N}]
- 纯数字：
- 邮编：空值通过；非空须匹配宽松邮编（约 3–10 位，字母数字，中间可有空格/连字符）。
^[A-Za-z0-9][A-Za-z0-9\-\s]{1,8}[A-Za-z0-9]$
- 完整地址：空或不匹配地址正则 → 失败。
^[0-9a-zA-Z\u4e00-\u9fa5,， ]+$
- 姓名：不匹配中英文字母/空格正则 → 失败。
^[\u4e00-\u9fa5a-zA-Z ]+$
- 邮箱格式：空或不匹配邮箱正则 → 失败。
^[A-Za-z0-9.\_%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$
- 邮箱一致性：有注册用户时，须与注册邮箱忽略大小写一致；持卡人新建无用户则跳过。
- 手机号：空或不是合法国际号码 → 失败。
- 证件类型：只允许
ID_CARD/PASSPORT。无正则（忽略大小写字符串比较）。 - 性别：男、女
- 证件照片：需要清晰可见，目前支持身份证和护照，根据kyc限制区域进行传输；
- 地址证明：部分国家需要提供；
返回参数
number
响应状态码，
0 表示成功string
响应消息
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/apply \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"cardholder_no": "",
"cardholder_unique_no": "MERCHANT_USER_001",
"sumsub_share_token": "your_sumsub_share_token"
}'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": ""
}
}