2.3.2 预绑卡(短信请求)
绑定银行卡是指经过持卡人授权将个人银行卡和商户建立绑定关系,支付时不再需要输入银行卡信息。商户需先进行预绑卡,银行会发送短信验证码给持卡人,商户再使用确认绑卡接口将短信验证码回传给银行完成绑卡。
交易URL
生产环境:https://esc.baofu.com/gateway/api/acquiring/v2
测试环境:https://v-esc-service.baofu.com/gateway/api/acquiring/v2
请求报文
data_content:
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 子商户号 | sub_member_id | M | Max32Text | 提供给商户的唯一子商户编号 |
2. | 商户订单号 | trans_id | M | Max50Text | yyyyMMdd(8位系统当前日期)+字母/数字,系统对前8位进行强校验 |
3. | 账户信息 | acc_info | M | acc_info | 参照:账户信息 acc_info |
4. | 通道类型 | channel_type | M | channel_type | 参照:通道类型 |
5. | 协议补充域 | protocol_info | M | protocol_info | 根据所选通道类型填写,具体参照:通道类型-协议补充域 ; |
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 持卡人姓名 | id_holder | M | Max200Text | 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密 |
2. | 证件号 | id_card | M | Max200Text | 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密 |
3. | 证件类型 | id_card_type | M | code | 具体参见:证件枚举类型 |
4. | 银行卡号 | acc_no | M | Max200Text | 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密 |
5. | 银行账户类型 | card_type | M | code | 具体参见:账户枚举类型 |
6. | 手机号 | mobile | M | Max200Text | 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密 |
返回报文
data_content:
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 业务应答码 | biz_resp_code | M | Max32Text | 具体参见:应答码 |
2. | 业务应答说明 | biz_resp_msg | C | Max128Text | |
3. | 预签约唯一码 | unique_code | C | Max126Text | 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密 |
4. | 系统保留域1 | additional_info1 | O | 不限制 | 预留字段 |
5. | 子商户号 | sub_member_id | R | Max32Text |
说明:
A)“预签约唯一码”
只有预签约唯一码字段有值时表示预绑卡交易成功,若未返回预签约唯一码,该预绑卡交易失败(不必参考其他字段),请重新发起预绑卡请求。
B)若需要重新签约,请先发起解除银行卡绑定交易,再发起预绑卡(短信请求)、签约绑卡交易。