Appearance
订单分账
POST /api/division/exec
对支付成功的订单发起分账。代码出处:jeepay-payment/pay/rqrs/division/PayOrderDivisionExecRQ.java。 另支持分账接收者绑定:POST /api/division/receiver/bind(DivisionReceiverBindRQ)。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mchNo | String(64) | 是 | 商户号 |
| appId | String(64) | 是 | 商户应用 ID |
| mchOrderNo | String | 二选一 | 商户订单号 |
| payOrderId | String | 二选一 | 平台支付订单号 |
| useSysAutoDivisionReceivers | Byte | 是 | 是否使用系统配置的自动分账接收者:0-否,1-是 |
| receivers | String | 否 | 手动指定的分账接收者列表,JSON 数组字符串,元素含 receiverId、divisionProfit(分账比例,如 0.1)等 |
| version / signType / reqTime / sign | String | 是 | 公共字段,见鉴权说明 |
前置条件:下单时
divisionMode = 2(商户手动分账)的订单才可通过本接口发起分账。
响应参数(data)
| 参数 | 类型 | 说明 |
|---|---|---|
| state | Byte | 分账批次状态:0-待分账,1-分账成功,2-分账失败 |
| channelBatchOrderId | String | 渠道批次单号 |
| errCode / errMsg | String | 错误码 / 错误描述 |
分账接收者绑定(/api/division/receiver/bind)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ifCode | String | 是 | 分账接口代码(渠道) |
| receiverAlias | String | 否 | 接收者别名 |
| receiverGroupId | Long | 否 | 接收者账号组 ID |
| accType | Byte | 是 | 账号类型:0-个人(如微信 PERSONAL_OPENID),1-商户 |
| accNo | String | 是 | 分账接收账号 |
| accName | String | 否 | 分账接收人名称 |
| relationType | String | 否 | 分账关系类型(微信要求,如 SERVICE_PROVIDER) |
| relationTypeName | String | 否 | 分账关系类型名称 |
| channelExtInfo | String | 否 | 渠道扩展信息 |
| divisionProfit | String | 否 | 默认分账比例,如 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":"<按签名算法计算>"}'