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

>更新时间：2025.07.04

## 应用场景

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

接口频率：80QPS

## 接口说明

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

## 请求参数

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

举例如下：

```
<xml>
   <mch_id>10000100</mch_id>
   <sub_mch_id>1415701182</sub_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 | 调用接口时提供的商户号 |
| 子商户号 | sub\_mch\_id | 是 | string(32) | 1900000109 | 微信支付分配的子商户号，即分账的出资商户号。 |
| 随机字符串 | nonce\_str | 是 | string(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 微信返回的随机字符串 |
| 签名 | sign | 是 | string(64) | C380BEC2BFD727A4B6845133519F3AD6 | 微信返回的签名，详见[签名算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.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) | 内容见下方示例 | 分账接收方列表，json对象详细说明见下文，仅当查询分账请求结果时，存在本字段<br>点击下行的>展开字段详情 |
| 分账金额 | receivers.amount | 是 | int | 888 | 分账完结的分账金额，单位为分， 仅当查询分账完结的执行结果时，存在本字段 |
| 分账描述 | receivers.description | 是 | string(80) | 分给商户A | 分账完结的原因描述，仅当查询分账完结的执行结果时，存在本字段 |
| 分账接收方类型 | receivers.type | 是 | string(32) | MERCHANT\_ID | MERCHANT\_ID：商户号（mch\_id或者sub\_mch\_id）<br>PERSONAL\_OPENID：个人openid（由父商户APPID转换得到）PERSONAL\_SUB\_OPENID: 个人sub\_openid（由子商户APPID转换得到） |
| 分账接收方账号 | receivers.account | 是 | string(64) | 1900000109 | 类型是MERCHANT\_ID时，是商户号（mch\_id或者sub\_mch\_id）<br>类型是PERSONAL\_OPENID时，是个人openid<br>类型是PERSONAL\_SUB\_OPENID时，是个人sub\_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/partner/4015505153.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(64) | 36011111111111111111111 | 微信分账明细单号，每笔分账业务执行的明细单号，可与资金账单对账使用 |

举例如下：

```
<xml>
   <return_code><![CDATA[SUCCESS]]></return_code>
   <return_msg><![CDATA[OK]]></return_msg>
   <result_code><![CDATA[SUCCESS]]></result_code>
   <mch_id>10000100</mch_id>
   <nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
   <sub_mch_id>1415701182</sub_mch_id>
   <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": "MERCHANT_ID",
      "account":"190001001",
     "amount":100,
     "description": "分到商户",
     "result": "SUCCESS",
     "finish_time": "20180608170132"
     "detail_id": "36011111111111111111111"
     },
     {
     "type": "PERSONAL_WECHATID",
     "account":"86693952",
      "amount":888,
     "description": "分到个人",
     "result": "SUCCESS",
     "finish_time": "20180608170132"
     "detail_id": "36011111111111111111111"
     }
     ]
   </receivers>
</xml>
```

## 错误码列表

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