跳转到主要内容
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（二选一）。

​
请求头

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

​
请求体

​
card_bin_no
string
卡 BIN 单号（授权模式必填）
​
cardholder_no
string
必填
持卡人单号
​
card_unique_no
string
必填
商户侧卡唯一单号（最长 64 字符）
​
package_no
string
卡套餐单号（授信模式必填）
​
card_type
string
必填
卡类型，见 【附录常量表】卡类型
​
address_info
object
地址信息（实体卡、部分虚拟卡必填）
重要说明：
  • 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 为纯数字，不得含 + 号
  • 地址字段须使用英文填写，并符合所在国家的地址格式

​
返回参数

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