根据申请额度扣除对应币种账户余额。
开卡情形描述:
(1)开卡成功,卡要素齐全
(2)开卡成功,卡要素不全,需等待1到5分钟,调用卡片查询接口查询卡要素
(3)开卡返回false,errorCode为[140001],需等待1到5分钟,调用查询接口卡片操作查询
(4)其他失败情况,可查看返回错误码详情
请求URL
POST {域名}/api/vas/card/apply
请求参数
加密数据dataContent
序号 | 域名 | 变量名 | 必填 | 长度 | 备注 |
---|---|---|---|---|---|
01. | 请求流水号 | userReqNo | M | String(128) | 唯一单号 |
02. | 开卡币种 | localCurrency | M | String(3) | 开卡币种 |
03. | 卡生效日期 | startDate | M | String(10) | 大于等于当前日期,格式yyyy-MM-dd |
04. | 卡失效日期 | endDate | M | String(10) | 大于等于生效日期,格式yyyy-MM-dd |
05. | 授权额度 | authLimitAmount | C | Number | 授权额度【channelType=1时必传】 |
06. | 是否多次卡 | enableMultiUse | M | Number | 1多次卡0单次卡 |
07. | 是否限制交易币种 | enableCurrencyCheck | C | Number | 1开启校验 0 不校验。如果开启,交易币种需同开卡币种【channelType=1时必传】 |
08. | 卡别名 | cardAlias | O | String(64) | 卡别名 |
09. | 卡头 | binRangeId | O | String(8) | 常规卡(默认):222929 共享卡-附属卡(默认):493193 如需指定其他卡头,请联系客户经理或GEP客服查看。 |
10. | 卡类型 | channelType | O | String | 1(常规卡,默认) 2(共享-附属卡) |
11. | 共享卡卡组id | groupId | C | String | 共享卡卡组唯一编号 【channelType=2时必传】 |
12. | 持卡人Id | cardUserId | C | String | 卡头:485932、486821 时必传(持卡人申请接口返回的cardUserId) |
13. | 场景编号 | sceneCode | C | Number | 场景编号,有特殊场景要求的可上送场景编号。如:航旅,上送1004,不上送则走默认场景。场景编号列表可见附录:场景编号 |
14. | 航司编号 | airLineCode | C | String(2) | 常规卡:binRangeId为000000时(000000表示随机卡头,卡头不固定),必须上送此字段,如:航司AMERICAN AIRLINES,上送:AA。binRangeId为000000时,场景编号必须上送1004,或者为空 航司编号列表见附录:航司编号 附属卡不支持 |
dataContent示例
{
"authLimitAmount": "100",
"binRangeId": "438357",
"cardAlias": "消费卡",
"cardUserId": "2408070955000000409",
"channelType": "1",
"enableCurrencyCheck": "0",
"enableMultiUse": "1",
"endDate": "2026-01-01",
"groupId": "",
"localCurrency": "USD",
"startDate": "2024-08-14",
"userReqNo": "20240814201558-1133055849"
}
响应参数
结果信息result
序号 | 域名 | 变量名 | 必填 | 长度 | 备注 |
---|---|---|---|---|---|
01. | 服务系统返回的单号 | orderId | M | String | 唯一订单号 |
02. | 卡编号 | cardId | M | String(128) | 卡唯一编号,后续接口使用 |
03. | 开卡币种 | localCurrency | M | String(3) | 开卡币种 |
04. | 卡号 | cardNo | M | String(25) | |
05. | 卡cvv | cardVerifyNo | M | String(3) | |
06. | 卡有效期 | cardExpiryDate | M | String(7) | 格式:03/2022 |
result示例
{
"cardExpiryDate": "01/2026",
"cardId": "2408142015000001190",
"cardNo": "4383570067527441",
"cardVerifyNo": "721",
"localCurrency": "USD",
"orderId": "2408142015001005713"
}