创建虚拟卡【接口】
简要描述
创建虚拟卡
请求URL
open/api/card/create
请求方式
POST
请求参数说明
参数名 | 必选 | 类型 | 长度 | 说明 |
---|---|---|---|---|
vid | 是 | string | 卡段id | |
+cardHolder | 否 | object | 持卡人 | |
└firstName | 是 | string | 32 | 持卡人姓 [a-zA-Z]32 |
└lastName | 是 | string | 32 | 持卡人名 [a-zA-Z]32 |
deposit | 是 | string | 24 | 充值金额(美元), 1000代表 $10.00 |
orderNo | 是 | string | 64 | 自定义客户交易流水id 1,64 |
callbackUrl | 是 | string | 256 | 回调地址 256 |
feeType | 是 | string | 256 | 月费类型 ONE,TWO,THREE |
注意事项
- deposit 为虚拟卡充值(初始存款)金额,1 代表 1 美分,即 1000 代表 $10.00,本系统中所有金额(例如balance, consume)都采用此规则
- 单笔充值金额范围:5 USD - 5000 USD
- vid 为卡段id, 通过获取卡段列表查询您可使用的卡段
- 为改进用户体验,创建虚拟卡为异步操作,创建虚拟卡后,通常卡会经过 【开卡中 -> 创建持卡人 -> 创建虚拟卡 -> 激活卡片 -> 已激活
- 单笔充值金额 >1000 USD,会核验该用户邮箱账户是否已完成 KYC,若未完成,则返回错误。商户可调用 ACH KYC 接口完成用户 KYC 认证(如果用户已通过其它平台完成 KYC 认证,则商户可通过共享 KYC 接口同步用户信息)。
请求示例
{
"cardHolder": {
"firstName": "Milton",
"lastName": "Schmitt"
},
"deposit": "1000",
"vid": "vab_069af8a792ad",
"orderNo": "v_5bc814",
"callbackUrl": "https://www.baidu.com",
}
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
success |
boolean |
成功标志 |
error |
boolean |
失败标志 |
msg |
string |
返回处理消息 |
code |
integer |
返回代码 |
+model |
object |
返回数据对象 data |
+cardHolder |
object |
持卡人信息 |
└firstName |
string |
持卡人姓 |
└lastName |
string |
持卡人名 |
└street |
string |
街道 |
└city |
string |
城市 |
└state |
string |
州 |
└country |
string |
国家 |
└zipCode |
string |
邮编 |
+card |
object |
卡信息 |
└userId |
string |
用户ID |
└cardHolderId |
string |
持卡人ID |
└cardId |
string |
卡ID |
└customerId |
string |
自定义客户id |
└cardSeqNo |
string |
卡序列号 |
└deposit |
integer |
存款, 1000代表 $10.00 |
└consume |
integer |
消费, 1000代表 $10.00 |
└balance |
integer |
余额, 1000代表 $10.00 |
└cvc |
string |
cvc 虚拟卡校验码,在VISA卡中也称为cvv |
└number |
string |
卡号 |
└cardBin |
string |
卡段(卡号前6位) |
└last4 |
string |
后四位 |
└status |
string |
INIT :开卡中 |
└expYear |
integer |
卡过期年 |
└expMonth |
integer |
卡过期月 |
└gmtCreate |
string |
开卡时间 |
└tags |
array |
卡标签列表 |
└ |
string |
标签 |
返回示例
{
"success": true,
"error":false,
"msg": "成功",
"code": 0,
"model": {
"cardHolder": {
"firstName": "Milton",
"lastName": "Schmitt",
"street": "1010 Pine St LOT 12-E",
"city": "Vienna",
"state": "GA",
"country": "US",
"zipCode": "31092"
},
"card": {
"userId": "u_xxxxxxxx",
"customerId" : "user_id_123",
"cardHolderId": "ch_xxxxxxxxx",
"holderName": "Milton Schmitt",
"cardId": "c_xxxxxxxxx",
"cardSeqNo": "CXXXXXXXX",
"deposit": 1000,
"consume": 0,
"balance": 1000,
"cvc": "-",
"number": "-",
"cardBin": "-",
"last4": "-",
"status": "INIT",
"expYear": 0,
"expMonth": 0,
"gmtCreate": null
},
"tags": [
"test"
]
},
"traceId": 1646648711017
}
备注
更多返回错误代码请看首页的错误代码描述
Updated 19 days ago