---
url: "https://pay.weixin.qq.com/doc/v2/merchant/4011983179.md"
title: "查询分账结果"
doc_id: 4011983179
---

>更新时间：2025.07.04

## 应用场景

发起分账请求后，可调用此接口查询分账结果；发起分账完结请求后，可调用此接口查询分账完结的执行结果。

接口频率：80QPS

## 接口说明

|     |     |
| --- | --- |
| 请求Url | https://api.mch.weixin.qq.com/pay/profitsharingquery |
| 是否需要证书 | 否 |
| 请求方式 | post |
| 签名方式 | HMAC-SHA256 |

## 请求参数

| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 商户号 | mch\_id | 是 | string(32) | 1900000100 | 微信支付分配的商户号 |
| 微信订单号 | transaction\_id | 是 | string(32) | 4208450740201411110007820472 | 微信支付订单号 |
| 商户分账单号 | out\_order\_no | 是 | string(64) | P20150806125346 | 查询分账结果，输入申请分账时的商户分账单号； 查询分账完结执行的结果，输入发起分账完结时的商户分账单号 |
| 随机字符串 | nonce\_str | 是 | string(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md) |
| 签名 | sign | 是 | string(64) | C380BEC2BFD727A4B6845133519F3AD6 | 签名，详见[签名生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md) |
| 签名类型 | sign\_type | 否 | string(32) | HMAC-SHA256 | 签名类型，目前只支持HMAC-SHA256 |

举例如下：

```
<xml>
<mch_id>10000100</mch_id>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
<out_order_no>P20150806125346</out_order_no>
<transaction_id>4006252001201705123297353072</transaction_id>
<sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
<sign_type>HMAC-SHA256</sign_type>
</xml>
```

## 返回结果

| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 返回状态码 | return\_code | 是 | string(32) | SUCCESS | SUCCESS/FAIL 此字段是通信标识，非交易标识 |
| 返回信息 | return\_msg | 否 | string(256) | 参数格式校验错误 | 返回信息，如非空，为错误原因 |

以下字段在return\_code为SUCCESS的时候有返回

| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 业务结果 | result\_code | 是 | string(32) | SUCCESS | SUCCESS：分账申请接收成功，结果通过分账查询接口查询<br>FAIL ：提交业务失败 |
| 错误代码 | err\_code | 否 | string(32) | SYSTEMERROR | 列表详见错误码列表 |
| 错误代码描述 | err\_code\_des | 否 | String(128) | 系统超时 | 结果信息描述 |
| 商户号 | mch\_id | 是 | string(32) | 1900000100 | 调用接口时提供的商户号 |
| 随机字符串 | nonce\_str | 是 | string(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 微信返回的随机字符串 |
| 签名 | sign | 是 | string(64) | C380BEC2BFD727A4B6845133519F3AD6 | 微信返回的签名，详见[签名算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md) |

以下字段在return\_code和result\_code都为SUCCESS的时候返回

| 名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| :-- | :-- | :-- | :-- | :-- | :-- |
| 微信订单号 | transaction\_id | 是 | string(32) | 4208450740201411110007820472 | 微信支付订单号 |
| 微信分账单号 | order\_id | 是 | string(64) | 3008450740201411110007820472 | 微信分账单号 |
| 分账单状态 | status | 是 | string(16) | FINISHED | 分账单状态：<br>PROCESSING—处理中<br>FINISHED—处理完成 |
| 分账接收方列表 | receivers | 是 | string(10240) | 示例如下 | 分账接收方列表，不超过50个json对象，不能设置分账方作为分账接受方<br>点击行前的+展开字段详情 |
| 分账金额 | receivers.amount | 是 | int | 888 | 分账完结的分账金额，单位为分， 仅当查询分账完结的执行结果时，存在本字段 |
| 分账描述 | receivers.description | 是 | string(80) | 分给商户A | 分账完结的原因描述，仅当查询分账完结的执行结果时，存在本字段 |
| 分账接收方类型 | receivers.type | 是 | string(32) | PERSONAL\_OPENID | MERCHANT\_ID：商户号（mch\_id或者sub\_mch\_id）<br>PERSONAL\_OPENID：个人openid |
| 分账接收方账号 | receivers.account | 是 | string(64) | 1900000109 | 类型是MERCHANT\_ID时，是商户号（mch\_id或者sub\_mch\_id）<br>类型是PERSONAL\_OPENID时，是个人openid |
| 分账结果 | receivers.result | 是 | string(32) | SUCCESS | 分账结果，枚举值：<br>PENDING:待分账<br>SUCCESS:分账成功<br>CLOSED: 分账失败已关闭 |
| 分账完成时间 | receivers.finish_time | 是 | string(16) | 20180608170132 | 分账完成时间 |
| 分账失败原因 | receivers.fail_reason | 否 | string(32) | ACCOUNT\_ABNORMAL | 分账失败原因，当分账结果result为CLOSED（已关闭）时，返回该字段，具体处理方案请参考[分账失败处理指引](https://pay.weixin.qq.com/doc/v2/merchant/4015504995.md)。<br>枚举值：<br>1、ACCOUNT\_ABNORMAL : 分账接收账户异常<br>2、NO\_RELATION : 分账关系已解除<br>3、RECEIVER\_HIGH\_RISK : 高风险接收方<br>4、RECEIVER\_REAL\_NAME\_NOT\_VERIFIED : 接收方未实名<br>5、NO\_AUTH : 分账权限已解除<br>6、RECEIVER\_RECEIPT\_LIMIT : 超出用户月收款限额<br>7、PAYER\_ACCOUNT\_ABNORMAL : 分出方账户异常<br>8、INVALID\_REQUEST: 描述参数设置失败 |
| 分账明细单号 | receivers.detail_id | 是 | string\[1,64\] | 36011111111111111111111 | 微信分账明细单号，每笔分账业务执行的明细单号，可与资金账单对账使用 |

举例如下：

```
<xml>
<mch_id>1900000100</mch_id>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
<out_order_no>P20150806125346</out_order_no>
<status>FINISHED</status>
<transaction_id>4006252001201705123297353072</transaction_id>
<order_id>3008450740201411110007820472</order_id>
<sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
<receivers>
[
{
"type": "PERSONAL_OPENID",
"account":"190001001",
"amount":100,
"description": "分到商户",
"result": "SUCCESS",
"finish_time": "20180608170132",
"detail_id": "36011111111111111111111"
},
{
"type": "PERSONAL_OPENID",
"account":"86693952",
"amount":888,
"description": "分到个人",
"result": "SUCCESS",
"finish_time": "20180608170132",
"detail_id": "36011111111111121111111"
}
]
</receivers>
</xml>
```

## 错误码列表

| 名称 | 描述 | 原因 | 解决方案 |
| --- | --- | --- | --- |
| SYSTEMERROR | 接口返回错误 | 系统超时 | 请尝试再次掉调用API。 |
| ORDERNOTEXIST | 分账单不存在 | 订单号错误或分账单号错误 | 请检查订单号或分账单号是否有误 |
| INVALID\_TRANSACTIONID | 无效transaction\_id | 请求参数未按指引进行填写 | 请求参数错误，检查原交易号是否存在或发起支付交易接口返回失败 |
| PARAM\_ERROR | 参数错误 | 请求参数未按指引进行填写 | 请求参数错误，请检查参数再调用分账申请 |
| INVALID\_REQUEST | 请求不合法 | 参数中APPID或 MCHID不存在等 | 请检查请求参数 |