1.1 订单分账
订单支付成功后再分账,可调用本接口实现。
注:支付成功29天,剩余未分账金额系统自动分给交易商户
网关对接
| 项目 |
值 |
| 请求方式 |
POST |
| 请求域名 |
api.baofu.com |
| 请求地址 |
/v1/split/orderSplit |
| Content-Type |
application/json |
1.1.2 请求报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 1 |
商户订单号 |
trans_id |
M |
Max64Text |
分账商户订单号 |
| 2 |
原收单订单号 |
orig_trans_id |
M |
Max50Text |
收单商户订单号 |
| 3 |
终端号 |
terminal_id |
M |
Max11Text |
终端号/规则ID |
| 4 |
商户号 |
member_id |
M |
Max11Text |
商户号 |
| 5 |
交易时间 |
txn_time |
M |
Date |
格式:yyyyMMddHHmmss |
| 6 |
分账总金额 |
trade_amt |
M |
Max12Numeric |
单位:分 例:1元则提交100 |
| 7 |
产品类型 |
product_type |
M |
Max12Numeric |
详见附录产品类型 |
| 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:二级账簿 |
| 15 |
- - 金额 |
split_amt |
O |
Max12Text |
|
| 16 |
- - 说明 |
detail_desc |
O |
Max12Text |
|
| 17 |
风控 |
risk_item |
O |
Max200Text |
|
| 18 |
是否解冻剩余未分资金 |
unfreeze_unsplit |
O |
Boolean |
(预留,暂不生效)是否完结,如果设置为true,则该笔订单剩余未分账的金额会解冻回分账发起方商户,解冻后不支持对该笔订单再次进行分账;如果设置为false,则该笔订单剩余未分账的金额不会解冻回分账发起方商户,可以对该笔订单再次进行分账。 |
1.1.3 返回报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 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 |
- - 分账明细单号 |
detail_no |
O |
Max64Text |
|
| 11 |
- - 被分账方 |
payee_acct_no |
O |
Max128Text |
|
| 12 |
- - 账户类型 |
acct_type |
O |
Max8Text |
1:特约商户 2:二级账簿 |
| 13 |
- - 金额 |
split_amt |
O |
Max12Text |
|
| 14 |
- - 说明 |
detail_desc |
O |
Max12Text |
|
1.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”:”第二个分账方”}]”}
1.2.1 通知报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 1 |
商户订单号 |
trans_id |
M |
Max64Text |
分账请求单号 |
| 2 |
商户号 |
member_id |
M |
Max11Text |
商户号 |
| 3 |
终端号 |
terminal_id |
M |
Max11Text |
终端号/规则ID |
| 4 |
分账失败原因 |
fail_msg |
C |
Max128Text |
|
| 5 |
交易状态 |
txn_state |
C |
Max2Numeric |
订单状态,详见附录 |
| 6 |
分账订单号 |
share_no |
O |
Max64Text |
宝付生成的唯一分账单号 |
| 7 |
分账信息 |
sharing_info |
O |
json |
|
| 8 |
- - 分账明细单号 |
detail_no |
O |
Max64Text |
|
| 9 |
- - 被分账方 |
payee_acct_no |
O |
Max128Text |
|
| 10 |
- - 账户类型 |
acct_type |
O |
Max8Text |
1:特约商户 2:二级账簿 |
| 11 |
- - 金额 |
split_amt |
O |
Max12Text |
|
| 12 |
- - 说明 |
detail_desc |
O |
Max12Text |
|
1.3 剩余可分账金额查询接口
1.3.1 网关对接
| 项目 |
值 |
| 请求方式 |
POST |
| 请求域名 |
api.baofu.com |
| 请求地址 |
/v1/split/shareableQuery |
| Content-Type |
application/json |
1.3.2 请求报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 1 |
商户号 |
member_id |
M |
Max11Text |
商户号 |
| 2 |
终端号 |
terminal_id |
M |
Max11Text |
终端号/规则ID |
| 3 |
原订单交易日期 |
orig_trade_date |
M |
Max50Text |
格式:yyyyMMddHHmmss如20171219201919 |
| 4 |
原支付订单商户订单号 |
orig_trans_id |
M |
Max50Text |
商户提交的标识支付的唯一原订单号 |
| 5 |
产品类型 |
product_type |
M |
Max12Numeric |
详见附录 |
| 6 |
版本号 |
version |
M |
Max20Text |
版本号:1.0 |
1.4.3 返回报文
| 序号 |
域名 |
变量名 |
必填 |
字段类型 |
备注 |
| 1 |
商户订单号 |
trans_id |
O |
Max64Text |
商户订单号 |
| 2 |
商户号 |
member_id |
O |
Max11Text |
商户号 |
| 3 |
终端号 |
terminal_id |
O |
Max11Text |
终端号/规则ID |
| 4 |
版本号 |
version |
O |
Max20Text |
版本号:1.0 |
| 5 |
宝付单号 |
order_id |
O |
Max64Text |
宝付生成的唯一单号 |
| 6 |
支付金额 |
orig_order_amt |
O |
Max12Numeric |
单位:分 |
| 7 |
剩余分账金额 |
shareable_amt |
O |
Max12Numeric |
单位:分 |