查询分账结果

更新时间:2025.09.29

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

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/brand/profitsharing/orders

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


query  查询参数

 sub_mchid  必填   string(32)

【特约商户号】 订单收款方商户号,填写微信支付分配的商户号,可以是品牌主商户号,也可以是门店商户号


 transaction_id  必填   string(32)

【微信订单号】 微信支付订单号


 out_order_no  必填   string(64)

【商户分账单号】 请求分账时的商户分账单号

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders?sub_mchid=1900000109&transaction_id=4208450740201411110007820472&out_order_no=P20150806125346 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数
折叠全部参数

200 OK

 sub_mchid  必填   string(32)

【特约商户号】 订单收款方商户号,填写微信支付分配的商户号,可以是品牌主商户号,也可以是门店商户号


 transaction_id  必填   string(32)

【微信订单号】 微信支付订单号


 out_order_no  必填   string(64)

【商户分账单号】 请求分账时的商户分账单号


 order_id  必填   string(64)

【微信分账单号】 微信分账单号,微信系统返回的唯一标识


 status  必填   string(32)

【分账单状态】 可选取值:

  • PROCESSING: 处理中,非终态,分账结果存在非终态,可稍后再次查询,直到状态为FINISHED。

  • FINISHED: 分账完成,终态,仅代表分账动账执行完毕,每个接收方的分账结果请查看receivers中的result字段


 receivers  必填   array[object]

【分账接收方列表】 分账接收方列表

属性

 type  必填   string(32)

【接收方类型】 

  • MERCHANT_ID:商户号

  • PERSONAL_OPENID:个人OpenID(用户在商户appid下的唯一标识,详见 OpenID获取

  • PERSONAL_SUB_OPENID:个人OpenID(用户在品牌主appid下的唯一标识,详见 OpenID获取


 account  必填   string(64)

【接收方账号】 

  • 分账接收方类型为MERCHANT_ID时,分账接收方账号为商户号(mch_id或者sub_mch_id)

  • 分账接收方类型为PERSONAL_OPENID时,分账接收方账号为个人OpenID(由服务商的AppID转换得到)

  • 分账接收方类型为PERSONAL_SUB_OPENID时,分账接收方账号为个人OpenID(由品牌主的AppID转换得到)


 amount  必填   integer

【分账金额】 分账金额,单位为分,只能为整数


 description  必填   string(80)

【分账描述】 分账的原因描述,会在查询分账结果接口和分账账单中原样返回


 result  必填   string(32)

【分账结果】 

  • PENDING: 待分账,非终态

  • SUCCESS: 分账成功,终态

  • CLOSED: 已关闭,终态


 finish_time  必填   string

【分账完成时间】 分账完成时间,需遵循 RFC3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。示例:2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。


 fail_reason  选填   string(64)

【分账失败原因】 分账失败原因,当分账结果result为CLOSED(已关闭)时,返回该字段,具体处理方案请参考分账失败处理指引
可选取值:

  • ACCOUNT_ABNORMAL: 分账接收账户异常

  • NO_RELATION: 分账关系已解除

  • RECEIVER_HIGH_RISK: 高风险接收方

  • RECEIVER_REAL_NAME_NOT_VERIFIED: 接收方未实名

  • NO_AUTH: 分账权限已解除

  • RECEIVER_RECEIPT_LIMIT: 超出用户月收款限额

  • PAYER_ACCOUNT_ABNORMAL: 分出方账户异常

  • INVALID_REQUEST: 描述参数设置失败


 detail_id  必填   string(64)

【分账明细单号】 微信分账明细单号,每笔分账业务执行的明细单号,可与资金账单对账使用,对应资金账单中的“业务凭证号”


 finish_amount  选填   integer

【分账完结金额】 分账完结的分账金额,单位为分, 仅当查询分账完结的执行结果时,存在本字段


 finish_description  选填   string(80)

【分账完结描述】 分账完结的原因描述,仅当查询分账完结的执行结果时,存在本字段

应答示例

200 OK

1{
2  "sub_mchid" : "1900000109",
3  "transaction_id" : "4208450740201411110007820472",
4  "out_order_no" : "P20150806125346",
5  "order_id" : "3008450740201411110007820472",
6  "status" : "FINISHED",
7  "receivers" : [
8    {
9      "type" : "MERCHANT_ID",
10      "account" : "1900000109",
11      "amount" : 10,
12      "description" : "分帐1900000110",
13      "result" : "SUCCESS",
14      "finish_time" : "2015-05-20T13:29:35.120+08:00",
15      "fail_reason" : "NO_RELATION",
16      "detail_id" : "36011111111111111111111"
17    }
18  ],
19  "finish_amount" : 100,
20  "finish_description" : "分账完结"
21}
22

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

404

RESOURCE_NOT_EXISTS

记录不存在

请检查请求的单号是否正确

429

FREQUENCY_LIMITED

商户发起分账查询的频率过高

请降低频率后重试

 

元宝AI
反馈
目录
置顶