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 分账通知
在宝付处理分账成功之后,会将分账结果通知到商户的notify_url。
异步通知以GET和POST方式发送到商户配置的接收地址,商户接收到支付结果,并且进行相应处理之后,需要商户接收通知的地址在页面上输出 OK 表示接收成功<除了 OK 无任何其他内容>,告诉宝付已经成功接收并处理完毕,宝付系统在未得到商户接收通知成功的反馈时,将通过重发机制再次通知商户(重发次数 2~10 次,请以第一次收到的支付成功的消息为准,避免进行多次充值或支付),直到商户接收成功或达到最大重发次数为止。商户接收到通知系统处理完成后,按约定返回OK;
例如:{“trans_id”:”2026061517250796829197661”,”member_id”:”102004169”,”terminal_id”:”200024546”,”share_no”:”12606151702344808804300001”,”txn_state”:”SUCCESS”,”sharing_info”:”[{“detail_no”:”12606151702344808804300001000001”,”payee_acct_no”:”CS660000000000000718”,”acct_type”:”2”,”split_amt”:”10”,”detail_desc”:”ruyan_test”},{“detail_no”:”12606151702344808804300001000002”,”payee_acct_no”:”CM660000000103201928”,”acct_type”:”2”,”split_amt”:”20”,”detail_desc”:”第二个分账方”}]”}
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 |
|