2.2.4 预支付类交易(可选)

交易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 固定值:05,参见:交易类型枚举
6 商户号 member_id M Max11Numeric 宝付提供给商户的唯一编号
7 商户订单号 trans_id M Max50Text 唯一订单号,8位系统当前日期格式为yyyyMMdd+字母或数字组成,未支付成功的订单号可重复提交,重复提交时交易参数不得发生变化
8 数字信封 dgtl_envlp M Max512Text 详见数字信封
9 用户ID user_id O Max50Text 用户在商户平台唯一ID
10 签约协议号 protocol_no M Max126Text 加密方式:UTF-8编码格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写
11 交易金额 txn_amt M Max12Numeric 单位:分。例:1元则提交100
12 风控参数 risk_item M 不限制 Json格式,详细参数见风控参数字段说明(通用参数、电商、互金消金、航旅、酒店、宝信、游戏、大宗)
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
19 验签方式 verify_type C Max20Text 国密场景必传,国密SM:10;国际RSA:11
20 加密证书序列号 ncrptn_sn C Max20Text 宝付公钥证书序列号,用于选择解密证书,验签方式为10时必传
21 签名证书序列号 sign_sn C Max20Text 商户公钥证书序列号,用于选择验签证书,验签方式为10时必传
22 手续费承担方商户号 fee_member_id O Max11Numeric 如需要其他商户号承担上述商户号的手续费。现手续费承担方为固定商户号
23 计费商户号 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 终端号 terminal_id R Max11Numeric
6 交易类型 txn_type R Max11Text
7 商户号 member_id R Max11Numeric 宝付提供给商户的唯一编号
8 业务返回码 biz_resp_code M Max11Text 参见:业务应答码
9 业务返回说明 biz_resp_msg M Max11Text
10 数字信封 dgtl_envlp M Max512Text 详见数字信封
11 预支付唯一码 unique_code C Max126Text 预支付成功后返回;加密方式:UTF-8格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写
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 宝付公钥证书序列号,用于选择验签证书