开卡申请

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

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（二选一）。

请求头

string

必填

apiKey（商户凭证，与 IP 白名单绑定）

string

必填

Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳

string

必填

登录标识（除获取 Token 外必填）

string

默认值:"application/json"

固定为 application/json

请求体

string

卡 BIN 单号（授权模式必填）

string

必填

持卡人单号

string

必填

商户侧卡唯一单号（最长 64 字符）

string

卡套餐单号（授信模式必填）

string

必填

卡类型，见【附录常量表】卡类型

object

地址信息（实体卡、部分虚拟卡必填）

显示 address_info

string

名（英文，实体卡必填）

string

姓（英文，实体卡必填）

string

手机号国别码（纯数字，不含 + 号，如 86 表示中国大陆；须为平台支持的有效国别码，实体卡必填）

string

手机号（不含国别码，与 phone_code 组合校验，实体卡必填）

string

必填

邮编（须与 country / state / city 匹配）

string

必填

国家 ISO 3166-1 alpha-2（如 US）

string

必填

省/州（英文）

string

必填

城市（英文）

string

必填

地址1（英文字母、数字、空格或常用地址符号）

string

地址2（同上，可空）

重要说明：

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

响应消息

object

返回数据

显示 data

string

卡单号

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": ""
  }
}

接入指引

API文档

附录

请求头

请求体

返回参数

​请求头

​请求体

​返回参数

请求头

请求体

返回参数