Skip to content

订单分账 ​

POST /api/division/exec

对支付成功的订单发起分账。代码出处:jeepay-payment/pay/rqrs/division/PayOrderDivisionExecRQ.java。 另支持分账接收者绑定:POST /api/division/receiver/bind(DivisionReceiverBindRQ)。

请求参数 ​

参数类型必填说明
mchNoString(64)是商户号
appIdString(64)是商户应用 ID
mchOrderNoString二选一商户订单号
payOrderIdString二选一平台支付订单号
useSysAutoDivisionReceiversByte是是否使用系统配置的自动分账接收者:0-否,1-是
receiversString否手动指定的分账接收者列表,JSON 数组字符串,元素含 receiverId、divisionProfit(分账比例,如 0.1)等
version / signType / reqTime / signString是公共字段,见鉴权说明

前置条件:下单时 divisionMode = 2(商户手动分账)的订单才可通过本接口发起分账。

响应参数(data) ​

参数类型说明
stateByte分账批次状态:0-待分账,1-分账成功,2-分账失败
channelBatchOrderIdString渠道批次单号
errCode / errMsgString错误码 / 错误描述

分账接收者绑定(/api/division/receiver/bind) ​

参数类型必填说明
ifCodeString是分账接口代码(渠道)
receiverAliasString否接收者别名
receiverGroupIdLong否接收者账号组 ID
accTypeByte是账号类型:0-个人(如微信 PERSONAL_OPENID),1-商户
accNoString是分账接收账号
accNameString否分账接收人名称
relationTypeString否分账关系类型(微信要求,如 SERVICE_PROVIDER)
relationTypeNameString否分账关系类型名称
channelExtInfoString否渠道扩展信息
divisionProfitString否默认分账比例,如 0.1

Java 示例(SDK) ​

java
JeepayResponse resp = client.divisionExec(new DivisionExecRequest()
        .mchNo("M1690858842671").appId("appId-demo")
        .payOrderId("P20261105000001")
        .useSysAutoDivisionReceivers((byte) 1)
        .toParams());
System.out.println("state=" + resp.getByte("state"));

curl 示例 ​

bash
curl -X POST http://<服务器IP>:9216/api/division/exec \
  -H 'Content-Type: application/json' \
  -d '{"version":"1.0","signType":"MD5","reqTime":"20261105120007","mchNo":"M1690858842671","appId":"appId-demo","payOrderId":"P20261105000001","useSysAutoDivisionReceivers":1,"sign":"<按签名算法计算>"}'