2.1 余额分账
网关对接
| 项目 |
值 |
| 请求方式 |
POST |
| 请求域名 |
api.baofu.com |
| 请求地址 |
/v1/split/balanceSplit |
| Content-Type |
application/json |
2.1.1 请求报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 1 |
商户订单号 |
trans_id |
M |
Max64Text |
分账商户订单号 |
| 2 |
终端号 |
terminal_id |
M |
Max11Text |
终端号/规则ID |
| 3 |
商户号 |
member_id |
M |
Max11Text |
商户号 |
| 4 |
付款账户类型 |
payer_acct_type |
M |
Max32Text |
付款账户类型1:特约商户 3：银行账簿 |
| 5 |
付款账簿号 |
payer_acct_no |
C |
Max32Text |
付款方账户类型是二级账簿和银行账户必填 |
| 6 |
交易时间 |
txn_time |
M |
Date |
格式：yyyyMMddHHmmss |
| 7 |
分账总金额 |
trade_amt |
M |
Max12Numeric |
单位：分 例：1元则提交100 |
| 8 |
分账通知地址 |
notify_url |
M |
Max255Text |
交易结果通知地址 |
| 9 |
版本号 |
version |
M |
Max20Text |
版本号：1.0 |
| 10 |
计费商户 |
call_fee_member_id |
O |
Max128Text |
计费商户（预留）； |
| 11 |
手续费承担方 |
fee_member_id |
O |
Max128Text |
|
| 12 |
分账信息 |
sharing_info |
O |
json |
|
| 13 |
- - 被分账方 |
payee_acct_no |
O |
Max128Text |
|
| 14 |
- - 账户类型 |
acct_type |
O |
Max8Text |
1:特约商户 2：二级账簿 3：银行账簿 |
| 15 |
- - 金额 |
split_amt |
O |
Max12Text |
|
| 16 |
- - 说明 |
detail_desc |
O |
Max12Text |
|
| 17 |
风控 |
risk_item |
O |
Max200Text |
|
2.1.2 返回报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 1 |
商户订单号 |
trans_id |
O |
Max64Text |
分账商户订单号 |
| 2 |
终端号 |
terminal_id |
O |
Max11Text |
终端号/规则ID |
| 3 |
商户号 |
member_id |
O |
Max11Text |
商户号 |
| 4 |
分账失败原因 |
fail_msg |
C |
Max128Text |
|
| 5 |
交易状态 |
txn_state |
C |
Max2Numeric |
订单状态，详见附录 |
| 6 |
版本号 |
version |
O |
Max20Text |
版本号：1.0.0.0 |
| 7 |
分账订单号 |
share_no |
O |
Max64Text |
宝付生成的唯一分账单号 |
| 8 |
分账完成时间 |
finish_time |
C |
yyyyMMddHHmmss |
|
| 9 |
分账信息 |
sharing_info |
O |
json |
|
| 10 |
- - 被分账方 |
payee_acct_no |
O |
Max128Text |
|
| 11 |
- - 账户类型 |
acct_type |
O |
Max8Text |
1:特约商户 2：二级账簿 3：银行账簿 |
| 12 |
- - 金额 |
split_amt |
O |
Max12Text |
|
| 13 |
- - 说明 |
detail_desc |
O |
Max12Text |
|
| 14 |
- - 分账明细单号 |
detail_no |
O |
Max64Text |
|
2.2 分账通知
如果交易的类型是分账模式，在宝付处理分账成功之后，会将分账结果通知到商户的sharingNotifyUrl。
异步通知以GET和POST方式发送到商户配置的接收地址，商户接收到支付结果，并且进行相应处理之后，需要商户接收通知的地址在页面上输出 OK 表示接收成功<除了 OK 无任何其他内容>，告诉宝付已经成功接收并处理完毕，宝付系统在未得到商户接收通知成功的反馈时，将通过重发机制再次通知商户（重发次数 2~10 次，请以第一次收到的支付成功的消息为准，避免进行多次充值或支付），直到商户接收成功或达到最大重发次数为止。商户接收到通知系统处理完成后，按约定返回 OK；
例如：memberId=100000749&respCode=S&transId=201803221785&signature=8ab74c7869632dc395cc945adcc388e6afceb759e4d406c3bb6e0e8002ec422f1615f2a43966d7337dcc57963f18877a959fe9f67b082da2cd95217ba003cc81f07962d665f576509ebc1a38f7ddf2a423775a794b262b7ffc4af615da3ba6bd05d0672c004d7cf80be3ed236f268078bb5c700d4b0a6ae9a0e58f2c782bd6ef&terminalId=100000949&tradeNo=58752185
2.2.1 通知报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 1 |
商户订单号 |
trans_id |
M |
Max64Text |
分账请求单号 |
| 2 |
商户号 |
member_id |
M |
Max11Text |
商户号 |
| 3 |
终端号 |
terminal_id |
M |
Max11Text |
终端号/规则ID |
| 4 |
业务响应码 |
code |
M |
Max32Text |
|
| 5 |
业务响应描述 |
message |
M |
Max128Text |
|
| 6 |
交易状态 |
txn_state |
C |
Max2Numeric |
订单状态，详见附录 |
| 7 |
分账订单号 |
share_no |
O |
Max64Text |
宝付生成的唯一分账单号 |
| 8 |
分账信息 |
sharing_info |
O |
json |
|
| 9 |
- - 分账明细单号 |
detail_no |
O |
Max64Text |
|
| 10 |
- - 被分账方 |
payee_acct_no |
O |
Max128Text |
|
| 11 |
- - 账户类型 |
acct_type |
O |
Max8Text |
1:特约商户 2：二级账簿 |
| 12 |
- - 金额 |
split_amt |
O |
Max12Text |
|
| 13 |
- - 说明 |
detail_desc |
O |
Max12Text |
|
