存量协议迁移
对特定渠道的存量签约关系进行迁移。(接口并发限制:3笔/s)
当通道类型为ICBC_ZL_003、ICBC_ZL_004时,若未同步返回明确迁移结果,可发送2.2.7 绑定关系查询交易进行查询,无需接入存量迁移异步通知。
交易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 | 固定值:172,参见:交易类型枚举 |
6 | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
7 | 商户订单号 | trans_id | M | Max50Text | 唯一订单号,8-50 位字母和数字,不能重复 |
8 | 数字信封 | dgtl_envlp | M | Max512Text | 详见数字信封 |
9 | 通道类型 | channel_type | M | channel_type | 参见:通道类型 |
10 | 证件类型 | id_card_type | M | code | 01,具体参见:枚举类型 |
11 | 账户信息 | acc_info | M | ISODateTime | 格式:银行卡号|持卡人姓名|证件号|手机号|银行卡安全码|银行卡有效期(yymm),安全码,有效期非必填 加密方式:UTF-8格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
12 | 协议补充域 | protocol_info | O | protocol_info | |
13 | 签名域 | signature | M | Max255Text | |
14 | 验签方式 | verify_type | C | Max20Text | 国密场景必传,国密SM:10;国际RSA:11 |
15 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 宝付公钥证书序列号,用于选择解密证书,国密必传 |
16 | 签名证书序列号 | sign_sn | C | Max20Text | 商户公钥证书序列号,用于选择验签证书,国密必传 |
返回报文
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
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 | 商户订单号 | trans_id | R | Max50Text | 唯一订单号 |
9 | 业务返回码 | biz_resp_code | M | Max50Text | 参见:业务应答码 |
10 | 业务返回说明 | biz_resp_msg | M | Max50Text | |
11 | 签约协议号 | protocol_no | C | Max126Text | 只有成功时该字段才有值;加密方式:UTF-8格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
12 | 数字信封 | dgtl_envlp | M | Max512Text | 详见数字信封 |
13 | 签名域 | signature | M | Max512Text | |
14 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 宝付公钥证书序列号,用于选择解密证书 |
15 | 签名证书序列号 | sign_sn | C | Max20Text | 商户公钥证书序列号,用于选择验签证书 |
存量迁移结果异步通知(部分通道需接入:CCB_ZL_003需对接)
异步通知以GET和POST方式发送到商户配置的接收地址,商户接收到存量协议迁移结果,并且进行相应处理之后,需要商户接收通知的地址在页面上输出 OK 表示接收成功<除了 OK 无任何其他内容>,告诉宝付已经成功接收并处理完毕,宝付系统在未得到商户接收通知成功的反馈时,将通过重发机制再次通知商户(重发次数 2~10 次,请以第一次收到的签约成功的消息为准),直到商户接收成功或达到最大重发次数为止。
通知报文
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1 | 应答报文流水号 | msg_id | M | Max32Text | |
2 | 应答码 | resp_code | M | Max16Text | 参见:商户接口应答码 |
3 | 终端号 | terminal_id | R | Max11Numeric | |
4 | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
5 | 商户订单号 | trans_id | R | Max50Text | 唯一订单号 |
6 | 业务返回码 | biz_resp_code | M | 参见:业务应答码 | |
7 | 业务返回说明 | biz_resp_msg | M | ||
8 | 签约协议号 | protocol_no | C | Max126Text | 只有成功时该字段才有值;加密方式:UTF-8格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
9 | 账户信息 | acc_info | C | 只有成功时该字段才有值;格式:身份证号|持卡人姓名|卡号|手机号;加密方式:UTF-8编码格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 | |
10 | 数字信封 | dgtl_envlp | M | Max512Text | 详见数字信封 |
11 | 签名域 | signature | M | Max512Text | |
12 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 商户公钥证书序列号,用于选择解密证书 |
13 | 签名证书序列号 | sign_sn | C | Max20Text | 宝付公钥证书序列号,用于选择验签证书 |