交互流程
交易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 | 固定值 180 |
| 6 | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7 | 数字信封 | dgtl_envlp | M | Max512Text | 格式:01|对称密钥,01代表AES加密方式:Base64转码后使用宝付的公钥加密 |
| 8 | 用户ID | user_id | M | Max50Text | 用户在商户平台唯一ID |
| 9 | 账户信息 | acc_info | M | Max200Text | 格式:持卡人姓名|证件号 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密 |
| 10 | 证件类型 | id_card_type | M | code | 见附录:枚举类型 |
| 9 | 页面返回地址 | page_url | M | Max255Text | 签约完成,页面跳转地址 |
| 10 | 签约结果通知地址 | return_url | M | Max255Text | 宝付后台异步通知,在此签约结果处理,不可使用页面返回地址作为签约结果通知地址 |
| 11 | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 12 | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 13 | 系统保留域1 | additional_info1 | O | Max255Text | |
| 14 | 系统保留域2 | additional_info2 | O | Max255Text | |
| 15 | 签名域 | signature | M | Max512Text | |
| 16 | 验签方式 | verify_type | O | Max20Text | 示例值:10;国密此字段必传 |
| 17 | 加密证书序列号 | ncrptn_sn | O | Max20Text | 接收方公钥证书序列号 |
| 18 | 签名证书序列号 | sign_sn | O | Max512Text | 发送方公钥证书序列号 |
- 说明
1)“签名方式”
“签名方式”用于标识算法方式,国密方式取值为:10;国际算法可默认不传。默认不传为国际算法。
2)“加密证书序列号”“签名证书序列号”
“加密证书序列号”和“签名证书序列号”在“签名方式”为国密方式(取值为10)时,必须上传,在“签名方式”为国际算法时,可传可不传。
返回报文
| 序号 | 域名 | 变量名 | 必填标识 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | 应答码 | resp_code | M | 参见商户接口应答码 | |
| 5 | 终端号 | terminal_id | M | Max11Numeric | |
| 6 | 交易类型 | txn_type | M | code | 固定值 |
| 7 | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8 | 业务返回码 | biz_resp_code | M | Max11Numeric | 具体参见附录1:业务应答码 |
| 9 | 业务返回说明 | biz_resp_msg | M | Max11Numeric | |
| 10 | url地址 | url | M | Max512Text | 一键多绑跳转地址 |
| 11 | 交互令牌 | token | M | Max512Text | 需用数字信封解密后拼接在一键多绑跳转地址上 格式为?token=${token} |
| 12 | 数字信封 | dgtl_envlp | M | Max512Text | 格式:01|对称密钥,01代表AES加密方式:Base64转码后使用商户的公钥加密 |
| 13 | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 14 | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 15 | 系统保留域1 | additional_info1 | O | Max255Text | |
| 16 | 系统保留域2 | additional_info2 | O | Max255Text | |
| 17 | 签名域 | signature | M | Max512Text | |
| 18 | 加密证书序列号 | ncrptn_sn | O | Max20Text | 接收方公钥证书序列号 |
| 19 | 签名证书序列号 | sign_sn | O | Max512Text | 发送方公钥证书序列号 |
-说明
1)“加密证书序列号”“签名证书序列号”
“加密证书序列号”和“签名证书序列号”在“签名方式”为国密方式(取值为10)时必返回,在“签名方式”为国际算法时如请求时上送则返回。