查询分账订单
接口说明
通过分账单号查询分账订单详情，包含分账状态、金额、各接收方明细结果等信息。仅查询本地数据，不调用通道；需要实时通道状态请走 分账同步。
请求地址
POST /unipay/query/alloc-order
- 认证：RSA 签名（
@PaymentVerify） - 响应：
DaxResult<AllocOrderResult>
请求参数
基础参数同 统一支付 - 基础参数，业务参数：
| 参数 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| allocNo | string | 否* | 100 | 平台分账单号 |
| bizAllocNo | string | 否* | 100 | 商户分账单号 |
*两个单号至少传一个，优先级：allocNo > bizAllocNo
请求示例
json
{
"mchNo": "M200000001",
"appId": "APP001",
"reqId": "REQ20241201032",
"reqTime": "2024-12-01 12:32:00",
"sign": "Base64签名值",
"allocNo": "A2024120112345700001"
}响应参数
DaxResult<AllocOrderResult>，data 字段结构：
| 参数 | 类型 | 描述 |
|---|---|---|
| allocNo | string | 平台分账单号 |
| bizAllocNo | string | 商户分账单号 |
| tradeNo | string | 原支付资金交易号 |
| bizOrderNo | string | 原支付商户业务订单号 |
| outAllocNo | string | 通道分账单号 |
| amount | long | 分账总金额（分） |
| status | string | 分账状态（AllocOrderStatusEnum） |
| finishTime | string | 分账完成时间（北京时间，yyyy-MM-dd HH:mm:ss） |
| channel | string | 支付通道 |
| attach | string | 商户扩展参数 |
| errorMsg | string | 错误信息 |
| details | object[] | 分账明细列表（各接收方结果） |
details 明细元素
| 参数 | 类型 | 描述 |
|---|---|---|
| receiverType | string | 接收方类型（AllocReceiverTypeEnum） |
| receiverAccount | string | 接收方账号 |
| receiverName | string | 接收方姓名 |
| amount | long | 分账金额（分） |
| result | string | 明细结果（pending 待分账 / success 成功 / fail 失败） |
| errorMsg | string | 错误信息 |
| finishTime | string | 明细完成时间（北京时间，yyyy-MM-dd HH:mm:ss） |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"allocNo": "A2024120112345700001",
"bizAllocNo": "ALOC20241201001",
"tradeNo": "T2024120112345700001",
"bizOrderNo": "ORDER20241201001",
"outAllocNo": "202412012200000000000001",
"amount": 10000,
"status": "success",
"finishTime": "2024-12-01 12:40:00",
"channel": "alipay",
"attach": "{\"orderId\": 123}",
"details": [
{
"receiverType": "USER_ID",
"receiverAccount": "2088xxxxxxxxxxxx",
"receiverName": "张三",
"amount": 3000,
"result": "success",
"finishTime": "2024-12-01 12:40:00"
},
{
"receiverType": "USER_ID",
"receiverAccount": "2088yyyyyyyyyyyy",
"amount": 7000,
"result": "success",
"finishTime": "2024-12-01 12:40:00"
}
]
},
"sign": "Base64签名值",
"resTime": "2024-12-01 12:32:00",
"reqId": "REQ20241201032"
}使用建议
- 查询为幂等操作，仅返回本地已落库的数据；分账状态可能滞后于通道，实时状态请优先使用 分账同步。
- 通过
details可核对各接收方是否到账，result为fail的明细可查看errorMsg定位原因。 - 金额字段单位为分（
details[].amount同），与发起分账时传入的元单位不同，注意换算。