存量协议迁移

对特定渠道的存量签约关系进行迁移。(接口并发限制: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 宝付公钥证书序列号,用于选择验签证书