查询分账回退结果

更新时间:2025.09.29

商户需要核实回退结果,可调用此接口查询回退结果。

  1. 如果分账回退接口返回状态为处理中,可调用此接口查询回退结果

接口说明

支持商户:【普通商户】

请求方式:【GET】/v3/profitsharing/return-orders/{out_return_no}

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


path  路径参数

 out_return_no  必填   string(64)

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


query  查询参数

 out_order_no  必填   string(64)

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

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/profitsharing/return-orders/R20190516001?out_order_no=P20190806125346 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

 order_id  必填   string(64)

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


 out_order_no  必填   string(64)

【商户分账单号】 商户系统内部的分账单号,在商户系统内部唯一,同一分账单号多次请求等同一次


 out_return_no  必填   string(64)

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


 return_id  必填   string(64)

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


 return_mchid  必填   string(32)

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


 amount  必填   integer

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


 description  必填   string(80)

【回退描述】 分账回退的原因描述


 result  必填   string

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

可选取值

  • PROCESSING:  处理中,非终态

  • SUCCESS:  已成功,终态

  • FAILED:  已失败,终态


 fail_reason  选填   string

【失败原因】 在回退结果为FAILED(已失败)时返回

可选取值

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

  • BALANCE_NOT_ENOUGH:  余额不足

  • TIME_OUT_CLOSED:  超时关单

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

  • INVALID_REQUEST:  描述参数设置失败


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


 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  "order_id" : "3008450740201411110007820472",
3  "out_order_no" : "P20150806125346",
4  "out_return_no" : "R20190516001",
5  "return_id" : "3008450740201411110007820472",
6  "return_mchid" : "86693852",
7  "amount" : 10,
8  "description" : "用户退款",
9  "result" : "SUCCESS",
10  "fail_reason" : "TIME_OUT_CLOSED",
11  "create_time" : "2015-05-20T13:29:35.120+08:00",
12  "finish_time" : "2015-05-20T13:29:35.120+08:00"
13}
14

 

错误码

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

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

404

RESOURCE_NOT_EXISTS

记录不存在

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

429

FREQUENCY_LIMITED

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

请降低频率后重试

 

元宝AI
反馈
目录
置顶