curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/apply \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"card_bin_no": "",
"cardholder_no": "",
"package_no": "",
"card_type": "Virtual",
"card_unique_no": "",
"address_info": {
"first_name": "",
"last_name": "",
"phone_code": "86",
"phone": "",
"postal_code": "",
"country": "CN",
"state": "",
"city": "",
"address_line1": "",
"address_line2": ""
}
}'
{
"code": 0,
"msg": "Success",
"data": {
"card_no": "",
"card_unique_no": ""
}
}
卡相关
开卡申请
POST
/
open-api
/
v1
/
card
/
apply
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/apply \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"card_bin_no": "",
"cardholder_no": "",
"package_no": "",
"card_type": "Virtual",
"card_unique_no": "",
"address_info": {
"first_name": "",
"last_name": "",
"phone_code": "86",
"phone": "",
"postal_code": "",
"country": "CN",
"state": "",
"city": "",
"address_line1": "",
"address_line2": ""
}
}'
{
"code": 0,
"msg": "Success",
"data": {
"card_no": "",
"card_unique_no": ""
}
}
开卡申请。授信模式传
package_no，授权模式传 card_bin_no（二选一）。
Channel02开卡时需要填写账单地址，卡片账单地址存在受限地区。提交申请前，请查看受限场景/区域中的账单限制区域清单。
开卡审核时间：正式环境预计在 30 分钟内完成，沙盒环境预计在 10 分钟内完成。
如长时间未完成审核，请联系技术支持。持卡数量上限：
- Channel01：虚拟卡和实体卡合计最多持有 5 张。
- Channel02：虚拟卡最多持有 2 张，实体卡最多持有 3 张。
请求头
string
必填
apiKey（商户凭证，与 IP 白名单绑定）
string
必填
Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
string
必填
登录标识（除获取 Token 外必填）
string
默认值:"application/json"
固定为
application/json请求体
string
卡 BIN 单号（授权模式必填）
string
必填
持卡人单号
string
必填
商户侧卡唯一单号（最长 64 字符）
string
卡套餐单号（授信模式必填）
string
必填
卡类型，见 【附录常量表】卡类型
object
账单地址信息（实体卡、部分虚拟卡必填）
显示 address_info
显示 address_info
重要说明：
card_bin_no与package_no至少传一个；两者均为空时返回错误码 1004- 实体卡（
card_type = Physical）时address_info整体不能为空，且first_name、last_name、phone_code、phone及所有地址字段均必填 - 虚拟卡可按业务需要省略
address_info，若传入则必须包含postal_code、country、state、city、address_line1并参与校验 phone_code为纯数字，不得含+号- 地址字段须使用英文填写，并符合所在国家的地址格式
返回参数
number
响应状态码，
0 表示成功string
响应消息
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/apply \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"card_bin_no": "",
"cardholder_no": "",
"package_no": "",
"card_type": "Virtual",
"card_unique_no": "",
"address_info": {
"first_name": "",
"last_name": "",
"phone_code": "86",
"phone": "",
"postal_code": "",
"country": "CN",
"state": "",
"city": "",
"address_line1": "",
"address_line2": ""
}
}'
{
"code": 0,
"msg": "Success",
"data": {
"card_no": "",
"card_unique_no": ""
}
}