VIRTUAL-L

简要描述

此处 KYC 理解为开卡接口。
开卡成功会返回一个卡号。
注意：如未提交 firstRecharge，开卡会默认扣除 10 USD，且发卡系统默认会为卡充值 10 USD。

请求URL

${baseUrl}/api/card/kyc/apply/virtual/L
${baseUrl}/api/card/kyc/apply/virtual/L/en

请求方式

Method : POST
Content-Type : application/json

请求参数

参数名	必填	类型	说明
merOrderNo	是	string	商家订单号
notifyUrl	否	string	若有值，当申请状态有变更时会通知，详见通知说明
cardType	是	string	需要申请的卡种，如 VISA、MASTER，通过卡头获取对应卡种
businessScene	是	string	业务类型，如电商消费，通过卡头获取
cardArea	是	string	发行区域，如中国香港，通过卡头获取
firstRecharge	否	string	首充金额，如 11，默认为 10，提交值需为不小于 10 的整数，首充后金额会充入卡，并扣除相应备用金
cardHeader	否	string	卡头，如 493193，通过卡头获取。不指定则随机分配
firstName	否	string	英文名（只能为英文字符）
lastName	否	string	英文姓（只能为英文字符）
email	否	string	电子邮箱
birthday	否	string	出生日期，格式为 yyyy-MM-dd

返回示例

{
    "data": {
        "completeTime":"",
        "createTime":"2023-04-23 20:08:35",
        "ext":"",
        "merOrderNo":"230423200834215712",
        "orderNo":"230423200835147904",
        "status":1
    },
    "msg":"操作成功",
    "status":200,
    "success":true
}

返回参数说明

通用响应字段

参数名	示例	说明	类型
data	jsonArray	响应数据，订单信息	见下表
msg	操作成功	响应消息	string
status	200	响应码	int
success	true	是否成功：true/false	bool

data 字段参数说明

参数名	示例	说明
merOrderNo	436343534234	商家订单号
orderNo	35432346345345	平台订单号
status	1	订单状态：1-处理中，2-成功，3-失败
createTime	2023-04-02 17:07:09	订单创建时间
completeTime	2023-04-02 17:07:09	订单完成时间
ext		订单额外信息，预留字段

Keyboard shortcuts

api