2.2.10 支付类交易(分账)
交易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 |
固定值:18,参见:交易类型枚举 |
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 |
最多填写三个地址;不同的地址用‘|’连接 |
16 |
分账信息 |
share_info |
M |
不限制 |
单位(分);格式:商户1,金额1;商户2,金额2…;例如:100000363,10;100000364,90; |
17 |
分账结果通知地址 |
share_notify_url |
O |
不限制 |
分账成功之后通知地址 |
18 |
商户保留域1 |
req_reserved1 |
O |
Max255Text |
|
19 |
商户保留域2 |
req_reserved2 |
O |
Max255Text |
|
20 |
系统保留域1 |
additional_info1 |
O |
Max255Text |
|
21 |
系统保留域2 |
additional_info2 |
O |
Max255Text |
|
22 |
签名域 |
signature |
M |
Max512Text |
|
23 |
验签方式 |
verify_type |
M |
Max20Text |
国密SM:10;国际RSA:11 |
24 |
加密证书序列号 |
ncrptn_sn |
M |
Max20Text |
宝付公钥证书序列号,用于选择解密证书 |
25 |
签名证书序列号 |
sign_sn |
M |
Max20Text |
商户公钥证书序列号,用于选择验签证书 |
26 |
手续费承担方商户号 |
fee_member_id |
O |
Max11Numeric |
如需要其他商户号承担上述商户号的手续费,银企云手续费方为固定商户 |
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 |
终端号 |
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 |
单位:分。例: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 |
|
19 |
加密证书序列号 |
ncrptn_sn |
M |
Max20Text |
商户公钥证书序列号,用于选择解密证书 |
20 |
签名证书序列号 |
sign_sn |
M |
Max20Text |
宝付公钥证书序列号,用于选择验签证书 |
21 |
渠道订单号 |
channel_order_id |
O |
Max64Text |
默认不返回 |