2.2.1 预绑卡
绑定银行卡是指经过持卡人授权将个人银行卡和商户建立绑定关系,支付时不再需要输入银行卡信息。商户需先进行预绑卡,宝付(或银行)会发送短信验证码(可根据银行要求来配置是否发送)给持卡人,商户再使用确认绑卡接口将短信验证码回传给宝付完成绑卡。
交易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 | 固定值:169,参见:交易类型枚举 |
6 | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
7 | 数字信封 | dgtl_envlp | M | Max512Text | 详见数字信封 |
8 | 用户ID | user_id | O | Max50Text | 用户在商户平台唯一ID |
9 | 卡类型 | card_type | M | code | 见附录:枚举类型 |
10 | 证件类型 | id_card_type | M | code | 01,见附录:枚举类型 |
11 | 账户信息 | acc_info | M | ISODateTime | 格式:银行卡号|持卡人姓名|证件号|手机号|银行卡安全码|银行卡有效(yymm),安全码,有效期非必填 加密方式:UTF-8格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
12 | 通道类型 | channel_type | M | channel_type | 参照:通道类型 |
13 | 协议补充域 | protocol_info | M | protocol_info | 根据所选通道类型填写,具体参照:通道类型-协议补充域 ; |
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 | Max255Text | |
19 | 验签方式 | verify_type | C | Max20Text | 国密场景必传,国密SM:10;国际RSA:11 |
18 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 宝付公钥证书序列号,用于选择解密证书,验签方式为10时必传 |
19 | 签名证书序列号 | 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 | 预签约唯一码 | unique_code | C | Max126Text | 加密方式:UTF-8编码格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
11 | 数字信封 | dgtl_envlp | M | Max512Text | 详见数字信封 |
12 | 商户保留域1 | req_reserved1 | O | Max255Text | |
13 | 商户保留域2 | req_reserved2 | O | Max255Text | |
14 | 系统保留域1 | additional_info1 | O | Max255Text | |
15 | 系统保留域2 | additional_info2 | O | Max255Text | |
16 | 签名域 | signature | M | Max512Text | |
17 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 宝付公钥证书序列号,用于选择解密证书 |
18 | 签名证书序列号 | sign_sn | C | Max20Text | 商户公钥证书序列号,用于选择验签证书 |