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 根据所选通道类型填写,具体参照:通道类型-协议补充域

账户信息 acc_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)若需要重新签约,请先发起解除银行卡绑定交易,再发起预绑卡(短信请求)、签约绑卡交易。