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