25.开卡申请1.0

URL

/api/v1.0/card/apply

1.开卡情形描述：

（1）开卡受理返回success，返回的卡要素齐全。
（2）开卡受理返回success,返回的卡要素不全。
（3）开卡受理返回false，errorCode为"BIZ_STATUS_ERROR"
以上三种情况都需要补查，等待1到5分钟，等待webhook回调或调用“卡片订单信息查询”主动查询订单状态并读取卡要素
—————————————————————————————————————————— 
（4）其他失败情况表示受理失败，可查看返回错误码详情
3.处理逻辑建议：开卡终态均会webhook通知商户，也可通过“卡片订单信息查询”主动查询订单状态处理后续业务逻辑。
开卡终态成功后，拿cardId去查询3号接口拿到完整卡片信息。

请求参数

名称	字段描述	字段类型	必须	备注
requestNo	请求流水号	String	必填	唯一，不可重复
currency	开卡币种	String	必填	见开卡币种
startDate	生效日期	String	必填	格式： yyyy-MM-dd；557，428卡头该字段也要填，不生效；其他卡头生效
endDate	失效日期	String	必填	格式： yyyy-MM-dd557，428卡头该字段也要填，不生效；其他卡头生效
limitAmount	开卡金额	Number	必填
enableMultiUse	多次卡	String	必填	YES-多次卡; NO-单次卡
enableCurrencyCheck	限制交易币种	String	必填	YES-限制;NO-不限制
cardAlias	卡片别名	String	/
binRangeId	卡头	String	必填	卡头查询接口返回
cardType	卡类型	String	必填	卡类型(NORMAL-普通卡,GROUP-共享卡附属卡)
groupId	卡组ID	String	/	当cardType为GROUP时必填，共享卡卡组申请返回的卡组ID
cardUserId	持卡人ID	String	/	部分卡头需要持卡人信息

请求示例

{
  "custNo": "158519...017664",
  "request": {
    "binRangeId": "522981",
    "cardAlias": "信息",
    "cardType": "NORMAL",
    "currency": "USD",
    "enableCurrencyCheck": "YES",
    "enableMultiUse": "YES",
    "endDate": "2023-10-25",
    "limitAmount": 100,
    "requestNo": "20222...240002",
    "startDate": "2022-10-26",
    "cardUserId": "519...017664"
  },
  "verify": "234rfre43...u763ewdft"
}

待签名字符串

"requestNo="+requestNo+"&currency="+currency+"&limitAmount="+limitAmount+"&cardType="+cardType

响应结果

名称	字段描述	字段类型	必须	备注
requestNo	请求流水号	String	必填	商户请求流水号
orderNo	平台订单号	String	必填
cardId	卡编号	String	必填
currency	币种	String	必填
cardNo	卡号	String	必填
cardCvv	CVV	String	必填
expiryDate	失效日期	String	必填	格式：yyyyMM

响应示例

{
  "errorCode": null,
  "errorMsg": null,
  "result": "dafsdjfnh239u4....odnfb2i3ope",
  "success": true
}

result解密后内容

{
  "requestNo": "221...0000001",
  "orderNo": "22292...764",
  "cardId": "22292...764",
  "cardNo": "22292...764",
  "currency": "USD",
  "expiryDate": "202511"
}