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 | 直接支付类:08 余额扣款:164 参见:交易类型枚举 |
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 | 卡信息 | card_info | C | Max126Text | 当使用信用卡支付时,可上传安全码、有效期。格式:信用卡有效期(yymm)|安全码;加密方式:UTF-8编码格式下转字节数组,使用数字信封指定的方式和密钥加密后转16进制大写 |
13 | 风控参数 | risk_item | M | 不限制 | Json格式,详细参数见风控参数字段说明(通用参数、电商、互金消金、航旅、酒店、宝信、游戏、大宗) |
14 | 交易成功通知地址 | return_url | O | Max500Text | 最多填写三个地址;不同的地址用‘|’连接 |
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 | 验签方式 | verify_type | C | Max20Text | 国密场景必传,国密SM:10;国际RSA:11 |
21 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 宝付公钥证书序列号,用于选择解密证书,验签方式为10时必传 |
22 | 签名证书序列号 | sign_sn | C | Max20Text | 商户公钥证书序列号,用于选择验签证书,验签方式为10时必传 |
23 | 手续费承担方商户号 | fee_member_id | O | Max11Numeric | 如需要其他商户号承担上述商户号的手续费。现手续费承担方为固定商户号 |
24 | 计费商户号 | 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 | 参见:业务应答码 | |
9 | 业务返回说明 | biz_resp_msg | M | ||
10 | 成功金额 | succ_amt | C | Max12Numeric | 交易类型为164时为实际扣款金额,非订单申请金额 单位:分。例:1元则100>单位:分。例: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 | 签名域 | signature | M | Max512Text | |
18 | 加密证书序列号 | ncrptn_sn | C | Max20Text | 商户公钥证书序列号,用于选择解密证书 |
19 | 签名证书序列号 | sign_sn | C | Max20Text | 宝付公钥证书序列号,用于选择验签证书 |
20 | 渠道订单号 | channel_order_id | O | Max64Text | 默认不返回 |