2.2.2 确认绑卡
绑定银行卡是指经过持卡人授权将个人银行卡和商户建立绑定关系,支付时不再需要输入银行卡信息。商户需先进行预绑卡,宝付(或银行)会发送短信验证码(可根据银行要求来配置是否发送)给持卡人,商户再使用确认绑卡接口,将短信验证码回传给宝付完成绑卡。
交易URL
测试环境地址:https://vgw.baofoo.com/cutpayment/protocol/backTransRequest
正式环境地址:https://public.baofoo.com/cutpayment/protocol/backTransRequest
请求报文
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1 | 报文发送日期时间 | send_time | M | ISODateTime | 发送方发出本报文时的机器日期时间,如 2017-12-19 20:19:19 |
2 | 报文流水号 | msg_id | M | Max32Text | 商户流水号 |
3 | 报文编号/版本号 | version | M | Max7Text | 4.0.0.0 |
4 | 终端号 | terminal_id | M | Max11Numeric | |
5 | 交易类型 | txn_type | M | code | 固定值:170,参见:交易类型枚举 |
6 | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
7 | 数字信封 | dgtl_envlp | M | Max512Text | 详见数字信封 |
8 | 预签约唯一码 | unique_code | M | Max126Text | 格式:预签约唯一码|短信验证码;加密方式:UTF-8编码格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
9 | 商户保留域1 | req_reserved1 | O | Max255Text | |
10 | 商户保留域2 | req_reserved2 | O | Max255Text | |
11 | 系统保留域1 | additional_info1 | O | Max255Text | |
12 | 系统保留域2 | additional_info2 | O | Max255Text | |
13 | 签名域 | signature | M | Max255Text | |
14 | 验签方式 | verify_type | C | Max20Text | 国密场景必传,国密SM:10;国际RSA:11 |
15 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 宝付公钥证书序列号,用于选择解密证书,验签方式为10时必传 |
16 | 签名证书序列号 | sign_sn | C | Max20Text | 商户公钥证书序列号,用于选择验签证书,验签方式为10时必传 |
返回报文
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1 | 报文发送日期时间 | send_time | M | ISODateTime | 发送方发出本报文时的机器日期时间,如 2017-12-19 20:19:19 |
2 | 应答报文流水号 | msg_id | M | Max32Text | |
3 | 报文编号/版本号 | version | R | Max7Text | 4.0.0.0 |
4 | 应答码 | resp_code | M | Max11Numeric | 参见:商户接口应答码 |
5 | 终端号 | terminal_id | R | Max11Numeric | |
6 | 交易类型 | txn_type | R | code | |
7 | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
8 | 业务返回码 | biz_resp_code | M | Max50Text | 参见:业务应答码 |
9 | 业务返回说明 | biz_resp_msg | M | Max50Text | |
10 | 签约协议号 | protocol_no | C | Max126Text | 只有成功时该字段才有值;加密方式:UTF-8格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
11 | 银行编码 | bank_code | C | Max10Text | 只有在绑卡成功后该字段才有值 |
12 | 银行名称 | bank_name | C | Max10Text | 只有在绑卡成功后该字段才有值 |
13 | 数字信封 | dgtl_envlp | M | Max512Text | 详见数字信封 |
14 | 商户保留域1 | req_reserved1 | O | Max255Text | |
15 | 商户保留域2 | req_reserved2 | O | Max255Text | |
16 | 系统保留域1 | additional_info1 | O | Max255Text | |
17 | 系统保留域2 | additional_info2 | O | Max255Text | |
18 | 签名域 | signature | M | Max512Text | |
19 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 商户公钥证书序列号,用于选择解密证书 |
20 | 签名证书序列号 | sign_sn | C | Max20Text | 宝付公钥证书序列号,用于选择验签证书 |