查询分账回退结果

更新时间:2025.09.29

商户需要核实回退结果,可调用此接口查询回退结果。如果分账回退接口返回状态为处理中,可调用此接口查询回退结果

接口说明

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

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

请求域名:【主域名】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)

【特约商户号】 微信支付分配的特约商户号,分账回退的接收商户,对应原分账出资的分账方商户


 out_return_no  必填   string(64)

【商户回退单号】 调用 请求分账回退 接口时传入的商户回退单号


 order_id  选填   string(64)

【微信分账单号】 原发起分账请求时,微信返回的微信分账单号,与商户分账单号一一对应。 微信分账单号与商户分账单号二选一填写


 out_order_no  选填   string(64)

【商户分账单号】 原发起分账请求时使用的商户系统内部的分账单号。微信分账单号与商户分账单号二选一填写

请求示例

curl
Java
Go

GET

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

应答参数

200 OK

 sub_mchid  必填   string(32)

【特约商户号】 微信支付分配的特约商户号,分账回退的接收商户,对应原分账出资的分账方商户


 order_id  必填   string(64)

【微信分账单号】 原发起分账请求时,微信返回的微信分账单号,与商户分账单号一一对应。


 out_order_no  必填   string(64)

【商户分账单号】 原发起分账请求时使用的商户后台系统内部的分账单号。


 out_return_no  必填   string(64)

【商户回退单号】 此回退单号是商户在自己后台生成的一个新的回退单号,在商户后台唯一。只能是:[0-9a-zA-Z_*@-]


 return_no  必填   string(64)

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


 return_mchid  必填   string(32)

【回退商户号】 对应请求分账接口时传入的receiver_account:分账接收方账号


 amount  必填   integer

【回退金额】 需要从分账接收方回退的金额,单位为分,只能为整数


 result  必填   string(32)

【回退结果】 如果请求返回为处理中,则商户可以通过调用回退结果查询接口获取请求的最终处理结果。如果查询到回退结果在处理中,请勿变更商户回退单号,使用相同的参数再次发起分账回退,否则会出现资金风险。在处理中状态的回退单如果5天没有成功,会因为超时被设置为已失败。
可选取值:

  • PROCESSING:处理中,非终态

  • SUCCESS:已成功,终态

  • FAIL:已失败,终态


 fail_reason  选填   string(64)

【失败原因】 在回退结果为FAILED(已失败)时返回。
可选取值:

  • ACCOUNT_ABNORMAL : 原分账接收方账户异常

  • TIME_OUT_CLOSED : 超时关单

  • PAYER_ACCOUNT_ABNORMAL : 原分账分出方账户异常

  • INVALID_REQUEST : 描述参数设置失败


 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秒。

应答示例

200 OK

1{
2  "sub_mchid" : "1900000109",
3  "order_id" : "3008450740201411110007820472",
4  "out_order_no" : "P20150806125346",
5  "out_return_no" : "R20190516001",
6  "return_no" : "3008450740201411110007820472",
7  "return_mchid" : "86693852",
8  "amount" : 10,
9  "result" : "SUCCESS",
10  "fail_reason" : "TIME_OUT_CLOSED",
11  "finish_time" : "2015-05-20T13:29:35.120+08:00"
12}
13

 

错误码

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

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

404

RESOURCE_NOT_EXISTS

记录不存在

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

429

FREQUENCY_LIMITED

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

请降低频率后重试

 

元宝AI
反馈
目录
置顶