跳转到主要内容
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 认证申请。

​
请求头

​
Api-Key
string
必填
apiKey（商户凭证，与 IP 白名单绑定）
​
Timestamp
string
必填
Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
​
Access-Token
string
必填
登录标识（除获取 Token 外必填）
​
Content-Type
string
默认值:"application/json"
固定为 application/json

​
请求体

​
cardholder_no
string
持卡人单号（更新认证时必填）
​
cardholder_unique_no
string
必填
商户侧持卡人唯一单号
​
sumsub_share_token
string
必填
Sumsub shareToken
  • 新建：不传 cardholder_no，须传 cardholder_unique_no + sumsub_share_token。
  • 更新认证：须传 cardholder_no，且 cardholder_unique_no 须与平台记录一致。

​
返回参数

​
code
number
响应状态码，0 表示成功
​
msg
string
响应消息
​
data
object
返回数据
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": ""
  }
}