2.开卡申请-2.0

开常规卡/附属卡

URL

/api/v2.0/card/apply

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

请求参数

名称	字段描述	字段类型	是否必填	备注
requestNo	请求流水号	String	Y	唯一，不可重复
currency	开卡币种	String	Y
startDate	生效日期	String	Y	格式： yyyy-MM-dd；557，428卡头该字段也要填，不生效；其他卡头生效
endDate	失效日期	String	Y	格式： yyyy-MM-dd557，428卡头该字段也要填，不生效；其他卡头生效
receivedCcy	到账币种	String	Y	跟卡币种不一致时会兑换成卡币种
receivedAmount	到账金额	Number	Y	跟卡币种不一致时会兑换成卡币种
enableMultiUse	多次卡	String	Y	YES-多次卡; NO-单次卡
enableCurrencyCheck	限制交易币种	String	Y	YES-限制;NO-不限制（建议）如果选择限制，将只能消费USD;选择不限制，则主流币种消费均支持
cardAlias	卡片别名	String	N
cardProductCode	卡产品	String	Y	联系客户经理配置
cardType	卡类型	String	Y	卡类型(NORMAL-普通卡,GROUP-共享卡附属卡)
groupId	卡组ID	String	C	当cardType为GROUP时必填，共享卡卡组申请返回的卡组ID
cardUserId	持卡人ID	String	C	申请某些卡头必填，需先调用持卡人信息申请提交
phoneCode	手机区号	String	C	申请某些卡头必填, 带区号+
phoneNumber	手机号码	String	C	申请某些卡头必填, 手机号码
countryCode	国家代码	String	C	申请某些卡头必填, 2位

请求示例

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

待签名字符串

"requestNo="+requestNo+"&currency="+currency+"&receivedCcy="+receivedCcy+"&receivedAmount="+receivedAmount+"&cardType="+cardType

响应结果

名称	是否必填	字段类型	备注
requestNo	Y	String	商户请求流水号
orderNo	Y	String	平台订单号
cardId		String	卡编号
currency		String	币种
cardNo		String	卡号
cardCvv		String	CVV
expiryDate		String	失效日期

响应示例

{
  "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", //异步卡无此字段
  "cardCvv": "321" //异步卡无此字段
}