- 2.业务接口说明
- 2.1应用场景
- 2.2业务接口
- 2.2.1预绑卡
- 交易URL
- 请求报文
- 返回报文
- 2.2.2确认绑卡
- 交易URL
- 请求报文
- 返回报文
- 2.2.3母订单支付类交易
- 交易URL
- 请求报文
- 返回报文
- 2.2.4子订单支付类交易
- 请求报文
- 返回报文
- 2.2.5解除银行卡绑定
- 交易URL
- 请求报文
- 返回报文
- 2.2.6绑定结果查询
- 交易URL
- 请求报文
- 返回报文
- 2.2.7母单支付结果查询类交易
- 交易URL
- 请求报文
- 返回报文
- 2.2.8分账（母单对应子单）订单状态查询类交易
- 交易URL
- 请求报文
- 返回报文
- 2.2.9母/子交易结果异步通知
- 返回报文
- 2.2.10分账结果异步通知
- 返回报文
- 2.2.11子订单支付结果查询类交易
- 交易URL
- 请求报文
- 返回报文
- 2.2.12母单组合营销支付交易类
- 交易URL
- 请求报文
- 返回报文
2.业务接口说明
2.1应用场景
宝付协议支付API产品是持卡人在商户平台购买服务或商品时，通过互联网将卡信息和身份信息提供给商户，商户在得到持卡人授权后，委托宝付从银行卡中将相应款项扣除，以满足商户的银行卡支付的业务需求。
合并支付模式，即在收到商户母单对应的所有子单系统自动发起协议支付的方式。
注：该接口为后台指令模式
目前银行要求在商户平台页面上挂持卡人与银行之间的服务协议（快捷支付、协议支付），用户在绑卡时需要用户详细阅读并同意协议，才可以提供协议支付服务。各家银行的协议内容不一样，已经放到接口包里。如果不清楚可联系技术支持。银行挂网协议材料点击下载
2.2业务接口
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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES加密方式：Base64转码后使用宝付的公钥加密 |
| 8. | 用户ID | user_id | O | Max50Text | 用户在商户平台唯一ID |
| 9. | 卡类型 | card_type | M | code | 见附录：卡枚举类型 |
| 10. | 证件类型 | id_card_type | M | code | 见附录：证件枚举类型 |
| 11. | 账户信息 | acc_info | M | Max200Text | 格式：银行卡号|持卡人姓名|证件号|手机号|银行卡安全码|银行卡有效期加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 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 |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | 具体参见附录5：商户接口应答码 | |
| 5 | 终端号 | terminal_id | R | Max11Numeric | |
| 6 | 交易类型 | txn_type | R | code | |
| 7 | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8 | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9 | 业务返回说明 | biz_resp_msg | M | ||
| 10 | 预签约唯一码 | unique_code | C | Max126Text | 加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 11 | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用商户的公钥加密 |
| 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 |
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 | 见附录：交易类型枚举 |
| 6 | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7 | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用宝付的公钥加密 |
| 9 | 预签约唯一码 | unique_code | M | Max126Text | 格式：预签约唯一码|短信验证码;加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 10 | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 11 | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 12 | 系统保留域1 | additional_info1 | O | Max255Text | |
| 13 | 系统保留域2 | additional_info2 | O | Max255Text | |
| 14 | 签名域 | signature | M | Max512Text |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5 | 终端号 | terminal_id | R | Max11Numeric | |
| 6 | 交易类型 | txn_type | R | code | |
| 7 | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8 | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9 | 业务返回说明 | biz_resp_msg | M | ||
| 10 | 签约协议号 | protocol_no | C | Max126Text | 只有成功时该字段才有值;加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 11 | 银行编码 | bank_code | C | Max10Text | 只有在绑卡成功后该字段才有值 |
| 12 | 银行名称 | bank_name | C | Max10Text | 只有在绑卡成功后该字段才有值 |
| 13 | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用商户的公钥加密 |
| 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 |
2.2.3母订单支付类交易
交易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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 商户订单号 | trans_id | M | Max50Text | 唯一订单号，8位系统当前日期格式为yyyyMMdd+字母或数字组成,未支付成功的订单号可重复提交，重复提交时交易参数不得发生变化（母订单号） |
| 8. | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用宝付的公钥加密 |
| 9. | 用户ID | user_id | O | Max50Text | 用户在商户平台唯一ID |
| 10. | 签约协议号 | protocol_no | M | Max126Text | 加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 11. | 交易金额 | txn_amt | M | Max12Numeric | 单位：分;例：1元则提交100;银行卡扣款金额 |
| 12. | 卡信息 | card_info | C | Max126Text | 当使用信用卡支付时，需上传。格式：信用卡有效期|安全码;加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 13. | 风控参数 | risk_item | M | 不限制 | Json格式，详细参数见风控参数字段说明（通用参数、电商、互金消金、航旅、酒店、宝信、游戏、大宗） |
| 14. | 交易成功通知地址 | return_url | O | Max500Text | 最多填写三个地址;不同的地址用‘|’连接 |
| 15. | 手续费商户 | fee_member_id | O | Max11Numeric | 指定分账手续费商户 |
| 16. | 子订单信息 | share_info | M | 不限制 | 单位(分);格式:商户1,金额1;商户2,金额2…;例如:100000363,10;100000364,90; |
| 17. | 子订单商户 | check_member_info | C | 不限制 | 需要确认的子订单商户号;格式：商户1;商户2 |
| 18. | 分账结果通知地址 | share_notify_url | O | 不限制 | 分账成功之后通知地址 |
| 19. | 订单有效期 | order_exp | O | Max11Numeric | 有效期为空时默认15分钟;商户传输有效期范围1~1440分钟 |
| 20. | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 21. | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 22. | 系统保留域1 | additional_info1 | O | Max255Text | |
| 23. | 系统保留域2 | additional_info2 | O | Max255Text | |
| 24. | 签名域 | signature | M | Max512Text | |
| 25. | 计费商户号 | call_fee_member_id | O | Max11Numeric |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5. | 终端号 | terminal_id | R | Max11Numeric | |
| 6. | 交易类型 | txn_type | R | Max11Text | |
| 7. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9. | 业务返回说明 | biz_resp_msg | M | ||
| 10. | 宝付订单号 | order_id | C | Max32Numeric | |
| 11. | 商户订单号 | trans_id | R | Max50Text | |
| 12. | 成功金额 | succ_amt | C | Max12Numeric | 单位：分;例：1元则100 |
| 13. | 成功时间 | succ_time | C | ISODateTime | 支付成功时间 |
| 14. | 渠道订单号 | channel_order_id | O | Max64Text | |
| 15. | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 16. | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 17. | 系统保留域1 | additional_info1 | O | Max255Text | |
| 18. | 系统保留域2 | additional_info2 | O | Max255Text | |
| 19. | 签名域 | signature | M | Max512Text | |
| 20. | 绑卡信息 | bind_card_info | O | Max512Text | 格式:签约协议号|卡号,加密方式:Base64转码后，使用数字信封指定的方式和密钥加密 |
2.2.4子订单支付类交易
- 测试环境地址：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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 商户订单号 | trans_id | M | Max50Text | 唯一订单号，8位系统当前日期格式为yyyyMMdd+字母或数字组成,未支付成功的订单号可重复提交，重复提交时交易参数不得发生变化（子订单号） |
| 8. | 母订单号 | main_trans_id | M | Max50Text | 母订单支付类的商户订单号 |
| 9. | 母订单商户号 | main_member_id | M | Max11Numeric | 母订单支付的商户号 |
| 10. | 交易金额 | txn_amt | M | Max12Numeric | 单位：分;例：1元则提交100 |
| 11. | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用宝付的公钥加密 |
| 12. | 签约协议号 | protocol_no | M | Max126Text | 加密方式：Base64转码后，使用数字信封指定的方式和密钥加密；签约协议号与母单一致 |
| 13. | 交易成功通知地址 | return_url | O | Max500Text | 最多填写三个地址;不同的地址用‘|’连接 |
| 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 |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5. | 终端号 | terminal_id | R | Max11Numeric | |
| 6. | 交易类型 | txn_type | R | Max11Text | |
| 7. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9. | 业务返回说明 | biz_resp_msg | M | ||
| 10. | 宝付订单号 | order_id | C | Max32Numeric | |
| 11. | 成功金额 | succ_amt | C | Max12Numeric | 单位：分;例：1元则100 |
| 12. | 成功时间 | succ_time | C | ISODateTime | 支付成功时间 |
| 13. | 渠道订单号 | channel_order_id | O | Max64Text | |
| 14. | 商户订单号 | trans_id | R | Max50Text | |
| 15. | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 16. | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 17. | 系统保留域1 | additional_info1 | O | Max255Text | |
| 18. | 系统保留域2 | additional_info2 | O | Max255Text | |
| 19. | 签名域 | signature | M | Max512Text |
2.2.5解除银行卡绑定
解绑是指持卡人发起的银行卡和商户解除绑定关系的业务。
交易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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用宝付的公钥加密 |
| 8. | 用户ID | user_id | O | Max50Text | 用户在商户平台唯一ID |
| 9. | 签约协议号 | protocol_no | M | Max126Text | 加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 10. | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 11. | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 12. | 系统保留域1 | additional_info1 | O | Max255Text | |
| 13. | 系统保留域2 | additional_info2 | O | Max255Text | |
| 14. | 签名域 | signature | M | Max512Text |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5 | 终端号 | terminal_id | R | Max11Numeric | |
| 6 | 交易类型 | txn_type | R | code | |
| 7 | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8 | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9 | 业务返回说明 | biz_resp_msg | M | ||
| 10 | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 11 | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 12 | 系统保留域1 | additional_info1 | O | Max255Text | |
| 13 | 系统保留域2 | additional_info2 | O | Max255Text | |
| 14 | 签名域 | signature | M | Max512Text |
2.2.6绑定结果查询
交易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 | 见附录：交易类型枚举 |
| 6 | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7 | 数字信封 | dgtl_envlp | C | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用宝付的公钥加密 |
| 8 | 用户ID | user_id | C | Max50Text | 用户在商户平台唯一ID |
| 9 | 银行卡号 | acc_no | C | Max20Text | 与user_id必须其中一个有值;加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 10 | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 11 | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 12 | 系统保留域1 | additional_info1 | O | Max255Text | |
| 13 | 系统保留域2 | additional_info2 | O | Max255Text | |
| 14 | 签名域 | signature | M | Max512Text |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 1 | 报文发送日期时间 | send_time | M | ISODateTime | 发送方发出本报文时的机器日期时间，如 2017-12-19 20:19:19 |
| 2 | 应答报文流水号 | msg_id | M | Max32Text | |
| 3 | 报文编号/版本号 | version | M | Max7Text | 4.0.0.0 |
| 5 | 应答码 | resp_code | M | Max16Text | 具体参见附录5：商户接口应答码 |
| 7 | 终端号 | terminal_id | R | Max11Numeric | |
| 8 | 交易类型 | txn_type | R | Max11Text | |
| 9 | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 10 | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 11 | 业务返回说明 | biz_resp_msg | M | ||
| 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 | 协议列表 | protocols | M | Max1024Text | 格式：签约协议号|用户ID|银行卡号|银行编码|银行名称; 签约协议号|用户ID|银行卡号|银行编码|银行名称;加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 19 | 签名域 | signature | M | Max512Text |
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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 商户原始订单号 | orig_trans_id | M | Max50Text | 商户提交的标识支付的唯一原订单号 |
| 8. | 交易日期 | orig_trade_date | M | ISODateTime | 格式：yyyy-MM-dd HH:mm:ss如2017-12-19 20:19:19 |
| 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 | Max512Text |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5. | 终端号 | terminal_id | R | Max11Numeric | |
| 6. | 交易类型 | txn_type | R | Max11Text | |
| 7. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9. | 业务返回说明 | biz_resp_msg | M | ||
| 10. | 成功金额 | succ_amt | C | Max12Numeric | 单位：分;例：1元则100 |
| 11. | 成功时间 | succ_time | C | ISODateTime | 支付成功时间 |
| 12. | 宝付订单号 | order_id | C | Max32Numeric | |
| 13. | 商户订单号 | trans_id | R | Max50Text | |
| 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. | 渠道订单号 | channel_order_id | O | Max64Text | |
| 19. | 签名域 | signature | M | Max512Text | |
| 20. | 绑卡信息 | bind_card_info | O | Max512Text | 格式:签约协议号|卡号,加密方式:Base64转码后，使用数字信封指定的方式和密钥加密 |
2.2.8分账（母单对应子单）订单状态查询类交易
当分账交易收单成功却没有收到分账成功通知时，可通过该接口查询分账订单状态。
交易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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 商户原始订单号 | orig_trans_id | M | Max50Text | 商户提交的标识支付的唯一原订单号 |
| 8. | 交易日期 | orig_trade_date | M | ISODateTime | 格式：yyyy-MM-dd HH:mm:ss如2017-12-19 20:19:19 |
| 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 | Max512Text |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5. | 终端号 | terminal_id | R | Max11Numeric | |
| 6. | 交易类型 | txn_type | R | Max11Text | |
| 7. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9. | 业务返回说明 | biz_resp_msg | M | ||
| 10. | 订单状态 | order_state | C | Max2Numeric | 1：交易成功 2：交易处理中 0：未支付 -1：交易失败 |
| 11. | 分账状态 | share_state | C | Max2Numeric | 订单状态为“1”时才会分账； 1：分账成功 0：待分账 |
| 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 |
注：该接口响应参数resp_code只会返回S（成功）和F（失败）。F代表接口参数错误或者分账订单不存在。S代表分账订单存在，具体的订单状态和分账状态需要判断order_state和share_state的返回值。
2.2.9母/子交易结果异步通知
如果直接支付类交易或预绑卡支付时上传了异步通知地址（return_url字段），当订单成功或失败时候会收到宝付的异步通知。
例如：biz_resp_code=0000&biz_resp_msg=交易成功& member_id=100000749 &resp_code=S& trans_id =201803221785&signature=8ab74c7869632dc395cc945adcc388e6afceb759e4d406c3bb6e0e8002ec422f1615f2a43966d7337dcc57963f18877a959fe9f67b082da2cd95217ba003cc81f07962d665f576509ebc1a38f7ddf2a423775a794b262b7ffc4af615da3ba6bd05d0672c004d7cf80be3ed236f268078bb5c700d4b0a6ae9a0e58f2c782bd6ef&terminal_id=100000949& order_id =58752185& succ_amt =585& succ_time =2018-01-24 13:25:33
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 1. | 应答码 | resp_code | M | Max16Text | 具体参见附录5：商户接口应答码 |
| 2. | 终端号 | terminal_id | R | Max11Numeric | |
| 3. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 4. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 5. | 业务返回说明 | biz_resp_msg | M | ||
| 6. | 宝付订单号 | order_id | M | Max32Numeric | |
| 7. | 商户原始订单号 | trans_id | M | Max50Text | 商户支付时上传的订单号 |
| 8. | 成功金额 | succ_amt | C | Max12Numeric | 单位：分;例：1元则100;订单成功时返回总金额 |
| 9. | 成功时间 | succ_time | C | ISODateTime | 支付成功时间，订单成功时返回 |
| 10. | 渠道订单号 | channel_order_id | O | Max64Text | |
| 11. | 签名域 | signature | M | Max512Text | |
| 12. | 绑卡信息 | bind_card_info | O | Max512Text | 格式:签约协议号|卡号,加密方式:Base64转码后，使用数字信封指定的方式和密钥加密 |
2.2.10分账结果异步通知
如果直接支付类分账交易上传了分账异步通知地址（share_notify_url字段），当分账成功后会收到宝付的异步通知。
例如：biz_resp_code= BF00338&biz_resp_msg=分账成功& member_id=100000749 &resp_code=S& trans_id =201803221785&signature=8ab74c7869632dc395cc945adcc388e6afceb759e4d406c3bb6e0e8002ec422f1615f2a43966d7337dcc57963f18877a959fe9f67b082da2cd95217ba003cc81f07962d665f576509ebc1a38f7ddf2a423775a794b262b7ffc4af615da3ba6bd05d0672c004d7cf80be3ed236f268078bb5c700d4b0a6ae9a0e58f2c782bd6ef&terminal_id=100000949& order_id =58752185
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 1. | 应答码 | resp_code | M | Max16Text | 具体参见附录5：商户接口应答码 |
| 2. | 终端号 | terminal_id | R | Max11Numeric | |
| 3. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 4. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 5. | 业务返回说明 | biz_resp_msg | M | ||
| 6. | 宝付订单号 | order_id | M | Max32Numeric | |
| 7. | 商户原始订单号 | trans_id | M | Max50Text | 商户支付时上传的订单号 |
| 8. | 签名域 | signature | M | Max512Text |
2.2.11子订单支付结果查询类交易
当系统返回异常或其他原因导致订单状态不明确时，可通过该接口查询订单状态。
交易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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 商户原始订单号 | orig_trans_id | M | Max50Text | 商户提交的标识支付的唯一原订单号 |
| 8. | 交易日期 | orig_trade_date | M | ISODateTime | 格式：yyyy-MM-dd HH:mm:ss如2017-12-19 20:19:19 |
| 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 | Max512Text |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5. | 终端号 | terminal_id | R | Max11Numeric | |
| 6. | 交易类型 | txn_type | R | Max11Text | |
| 7. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9. | 业务返回说明 | biz_resp_msg | M | ||
| 10. | 成功金额 | succ_amt | C | Max12Numeric | 单位：分;例：1元则100 |
| 11. | 成功时间 | succ_time | C | ISODateTime | 支付成功时间 |
| 12. | 宝付订单号 | order_id | C | Max32Numeric | |
| 13. | 商户订单号 | trans_id | R | Max50Text | |
| 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. | 渠道订单号 | channel_order_id | O | Max64Text | |
| 19. | 签名域 | signature | M | Max512Text |
2.2.12母单组合营销支付交易类
交易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 | 见附录：交易类型枚举 |
| 6. | 商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
| 7. | 商户订单号 | trans_id | M | Max50Text | 唯一订单号，8位系统当前日期格式为yyyyMMdd+字母或数字组成,未支付成功的订单号可重复提交，重复提交时交易参数不得发生变化（母订单号） |
| 8. | 数字信封 | dgtl_envlp | M | Max512Text | 格式：01|对称密钥，01代表AES;加密方式：Base64转码后使用宝付的公钥加密 |
| 9. | 用户ID | user_id | O | Max50Text | 用户在商户平台唯一ID |
| 10. | 签约协议号 | protocol_no | M | Max126Text | 加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 11. | 订单金额 | order_amt | M | Max12Numeric | 单位：分例：1元则提交100 订单金额=交易金额+营销金额 |
| 12. | 交易金额 | txn_amt | M | Max12Numeric | 单位：分;例：1元则提交100;银行卡扣款金额 |
| 13 | 营销账户信息 | union_info | O | 变（200） | 金额单位(分)（营销账户金额为0时不传） 格式 商户1,金额1;商户2,金额2… 例如100000363,5;100000364,5; |
| 14. | 卡信息 | card_info | C | Max126Text | 当使用信用卡支付时，需上传。格式：信用卡有效期|安全码;加密方式：Base64转码后，使用数字信封指定的方式和密钥加密 |
| 15. | 风控参数 | risk_item | M | 不限制 | Json格式，详细参数见风控参数字段说明（通用参数、电商、互金消金、航旅、酒店、宝信、游戏、大宗） |
| 16. | 交易成功通知地址 | return_url | O | Max500Text | 最多填写三个地址;不同的地址用‘|’连接 |
| 17. | 手续费商户 | fee_member_id | O | Max11Numeric | 指定分账手续费商户 |
| 18. | 子订单信息 | share_info | M | 不限制 | 单位(分);格式:商户1,金额1;商户2,金额2…;例如:100000363,10;100000364,90; |
| 19. | 子订单商户 | check_member_info | C | 不限制 | 需要确认的子订单商户号;格式：商户1;商户2 |
| 20. | 分账结果通知地址 | share_notify_url | O | 不限制 | 分账成功之后通知地址 |
| 21. | 订单有效期 | order_exp | O | Max11Numeric | 有效期为空时默认15分钟;商户传输有效期范围1~1440分钟 |
| 22. | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 23. | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 24. | 系统保留域1 | additional_info1 | O | Max255Text | |
| 25. | 系统保留域2 | additional_info2 | O | Max255Text | |
| 26. | 签名域 | signature | M | Max512Text | |
| 27. | 计费商户号 | call_fee_member_id | O | Max11Numeric |
返回报文
| 序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
|---|---|---|---|---|---|
| 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 | Max16Text | 具体参见附录5：商户接口应答码 |
| 5. | 终端号 | terminal_id | R | Max11Numeric | |
| 6. | 交易类型 | txn_type | R | Max11Text | |
| 7. | 商户号 | member_id | R | Max11Numeric | 宝付提供给商户的唯一编号 |
| 8. | 业务返回码 | biz_resp_code | M | 具体参见附录1：业务应答码 | |
| 9. | 业务返回说明 | biz_resp_msg | M | ||
| 10. | 宝付订单号 | order_id | C | Max32Numeric | |
| 11. | 商户订单号 | trans_id | R | Max50Text | |
| 12. | 成功金额 | succ_amt | C | Max12Numeric | 单位：分;例：1元则100 |
| 13. | 成功时间 | succ_time | C | ISODateTime | 支付成功时间 |
| 14. | 渠道订单号 | channel_order_id | O | Max64Text | |
| 15. | 商户保留域1 | req_reserved1 | O | Max255Text | |
| 16. | 商户保留域2 | req_reserved2 | O | Max255Text | |
| 17. | 系统保留域1 | additional_info1 | O | Max255Text | |
| 18. | 系统保留域2 | additional_info2 | O | Max255Text | |
| 19. | 签名域 | signature | M | Max512Text |
作者：xiaofeng 创建时间：2024-03-21 18:07
最后编辑：xiaofeng 更新时间：2024-09-19 18:06
最后编辑：xiaofeng 更新时间：2024-09-19 18:06
