订单分账

支持一笔收单订单多次分账（不同 trans_id）；代理商模式共用证书，须校验代理关系；平台商户分二级户无需维护分账关系

接口说明

请求方式：【POST】/v1/split/orderSplit

请求域名：【主域名】https://api.baofu.com

请求参数

Header 参数

参数名 类型 必填 描述
Authorization string true 请参考【开发指引-整体说明】生成认证信息
Accept string true 请设置为 application/json
Content-Type string true 请设置为 application/json

Body 参数

参数名 类型 必填 描述
trans_id string true 分账请求单号（商户侧幂等键）；≤64
member_id string true 交易商户号；格式 [0-9]{1,11}
terminal_id string true 终端号/规则ID；格式 [0-9]{1,11}
orig_trans_id string true 原支付商户单号；≤64
product_type integer true 收单产品类型
trade_amt string true 分账总金额，单位分；格式 [0-9]+
txn_time string true 原支付交易时间；格式 yyyyMMddHHmmss
sharing_info string true 分账明细 JSON 数组字符串，见 sharing_info_item；元素字段见下方点号展开
fee_member_id string false 手续费承担方商户号；格式 ^([0-9]{1,11})?$
notify_url string false 异步通知地址；格式 `^(http
version string false 接口版本号；≤20
agent_member_id string false 代理商商户号（对外展示为技术服务商会员号）
agent_terminal_id string false 代理商终端号
risk_item string false 风控字段；≤200
unfreeze_unsplit boolean false 是否完结分账（当前实现忽略，不生效）
trade_type string false 交易类型（预留）
sharing_info.detail_no string false 分账明细单号（退回等场景）
sharing_info.acct_type integer true 收款账户类型（取值见数据字典 acct_type）
sharing_info.payee_acct_no string true 收款账户号（账户类型为商户账户时填商户号）
sharing_info.split_amt number true 分账金额，单位分
sharing_info.detail_desc string false 分账说明
sharing_info.origin_detail_no string false 原分账明细单号

收单新老支付分账标识互斥，错用接口拒绝

product_type=2 走聚合分账通道转发

请求示例

{
  "trans_id": "202605141730001",
  "member_id": "100000178",
  "terminal_id": "100000935",
  "orig_trans_id": "11111111111111",
  "product_type": 1,
  "trade_amt": "10000",
  "txn_time": "20260514173000",
  "sharing_info": "[{\"acct_type\":1,\"payee_acct_no\":\"800\",\"split_amt\":1,\"detail_desc\":\"测试\"}]"
}

应答参数

200 OK

参数名 类型 必填 描述
member_id string false 回显商户号
terminal_id string false 回显终端号
trans_id string false 回显分账请求单号
version string false 回显版本号
share_no string false 宝付分账单号
txn_state string false 分账状态（取值：SUCCESS / PROCESSING / FAIL / ABNORMAL）
finish_time string false 分账完成时间（成功时）
fail_msg string false 失败或受理说明
sharding_info string false 成功时分账明细 JSON 数组（同步响应字段名；异步通知为 sharing_info）

应答示例

200 OK

{
  "txn_state": "SUCCESS"
}

错误码

公共错误码

状态码 错误码 描述 解决方案
401 SIGN_ERROR 验证不通过 请参阅【开发指引-整体说明】排查签名
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
500 SYSTEM_ERROR 系统异常，请稍后重试 请稍后重试