请求分账回退

更新时间:2025.09.29

如果订单已经分账,在退款时,可以先调此接口,将已分账的资金从商户类型的分账接收方的账户回退给分账方,再发起退款。
注意:

  1. 分账回退以原分账单为依据,支持多次回退,申请回退总金额不能超过原分账单分给该接收方的金额。

  2. 此接口采用同步处理模式,即在接收到商户请求后,会实时返回处理结果。

  3. 对同一笔分账单最多能发起50次分账回退请求。

  4. 退款和分账回退没有耦合,分账回退可以先于退款请求,也可以后于退款请求。

  5. 此功能需要接收方在商户平台-交易中心-分账-分账接收设置下,开启同意分账回退后,才能使用。

  6. 仅支持对分账给MERCHANT_ID:商户号类型,且分账单状态为 FINISHED(处理完成)、分账结果 result为 SUCCESS(分账成功)的分账单执行回退操作。

  7. 不支持“分账给个人”的分账单发起分账回退。

  8. 分账回退的时限是180天。

接口说明

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

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

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


body  包体参数

 sub_mchid  必填   string(32)

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


 order_id  选填   string(64)

【微信分账单号】 微信分账单号,微信系统返回的唯一标识。微信分账单号和商户分账单号二选一填写


 out_order_no  选填   string(64)

【商户分账单号】 商户系统内部的分账单号,在商户系统内部唯一(单次分账、多次分账、完结分账应使用不同的商户分账单号),同一分账单号多次请求等同一次。微信分账单号和商户分账单号二选一填写,只能是数字、大小写字母_-|*@


 out_return_no  必填   string(64)

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


 return_mchid  必填   string(32)

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


 amount  必填   integer

【回退金额】 需要从分账接收方回退的金额,单位为分,只能为整数,不能超过原始分账单分出给该接收方的金额


 description  必填   string(80)

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

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/brand/profitsharing/returnorders \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sub_mchid" : "1900000109",
8    "order_id" : "3008450740201411110007820472",
9    "out_order_no" : "P20150806125346",
10    "out_return_no" : "R20190516001",
11    "return_mchid" : "R20190516001",
12    "amount" : 10,
13    "description" : "分账回退"
14  }'
15

应答参数

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_mchid  必填   string(32)

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


 amount  必填   integer

【回退金额】 需要从分账接收方回退的金额,单位为分,只能为整数,不能超过原始分账单分出给该接收方的金额


 return_no  必填   string(64)

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


 result  必填   string(32)

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

  • PROCESSING:处理中,非终态

  • SUCCESS:已成功,终态

  • FAIL:已失败,终态


 fail_reason  选填   string(64)

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

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

  • TIME_OUT_CLOSED:超时关单

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


 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_mchid" : "86693852",
7  "amount" : 10,
8  "return_no" : "3008450740201411110007820472",
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

系统异常,请稍后重试

请稍后重试

403

NO_AUTH

回退方未开通分账回退功能

请先让回退方开通分账回退功能

403

NOT_ENOUGH

剩余可回退的金额不足

调整回退金额

429

FREQUENCY_LIMITED

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

请降低频率后重试

 

元宝AI
反馈
目录
置顶