1.1 订单分账

网关对接

项目
请求方式 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 分账通知

如果交易的类型是分账模式,在宝付处理分账成功之后,会将分账结果通知到商户的sharingNotifyUrl。
异步通知以GET和POST方式发送到商户配置的接收地址,商户接收到支付结果,并且进行相应处理之后,需要商户接收通知的地址在页面上输出 OK 表示接收成功<除了 OK 无任何其他内容>,告诉宝付已经成功接收并处理完毕,宝付系统在未得到商户接收通知成功的反馈时,将通过重发机制再次通知商户(重发次数 2~10 次,请以第一次收到的支付成功的消息为准,避免进行多次充值或支付),直到商户接收成功或达到最大重发次数为止。商户接收到通知系统处理完成后,按约定返回 OK
例如:memberId=100000749&respCode=S&transId=201803221785&signature=8ab74c7869632dc395cc945adcc388e6afceb759e4d406c3bb6e0e8002ec422f1615f2a43966d7337dcc57963f18877a959fe9f67b082da2cd95217ba003cc81f07962d665f576509ebc1a38f7ddf2a423775a794b262b7ffc4af615da3ba6bd05d0672c004d7cf80be3ed236f268078bb5c700d4b0a6ae9a0e58f2c782bd6ef&terminalId=100000949&tradeNo=58752185

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