订单发送退款的时候，可以对补差成功的补差单发起回退。

1. 补差回退以原补差单位依据，支持多次回退，申请回退总金额不能超过补差金额。
2. 此接口采用同步处理模式，即在接收到商户请求后，会实时返回处理结果。
3. 一笔微信退款单只允许补差回退一次。
4. 系统异常（如返回SYSTEM_ERROR），请使用相同参数稍后重新调用，请务必用原商户补差回退单号和原参数来重入此接口。

接口说明

支持商户：

【普通服务商】

请求方式：

【POST】/v3/ecommerce/subsidies/return

请求域名：

【主域名】

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)
【电商平台二级商户号】 补差的电商平台二级商户，填写微信支付分配的商户号
out_order_no 必填 string(64)
【商户补差回退单号】 商户系统内部的补差回退单号，在商户系统内部唯一，同一补差回退单号多次请求等同一次。只能是数字、大小写字母_-|*@
transaction_id 必填 string(64)
【微信订单号】 微信支付订单号
refund_id 选填 string(64)
【微信退款单号】 微信退款单号，微信系统退款返回的唯一标识。因用户账户异常而无法退款时可不传，其他情况必传
amount 必填 integer
【补差回退金额】 补差回退金额，单位为分，只能为整数，不能超过补差单的补差金额。如果指定了出资账户及金额，则必须为所有出资账户的金额之和
description 必填 string(80)
【补差回退描述】 补差回退描述，查询的时候原样带回来
subsidy_id 选填 string(64)
【微信补差单号】 微信补差单号，微信系统返回的唯一标识
from 选填 array[ReturnFrom]
【回退出资账户及金额】 回退需要从指定账户出资时，传递此参数指定出资金额（币种的最小单位，只能为整数）。 当前仅支持从一个账户出资。使用场景需要满足以下条件：1、本次回退金额和已回退金额之和不超过该补差单的补差金额；2、本次回退的金额不超过指定的账户的实际可用资金
• 属性

请求示例

POST

应答参数

200OK
sub_mchid 必填 string
【电商平台二级商户号】 补差的电商平台二级商户，填写微信支付分配的商户号
transaction_id 必填 string
【微信订单号】 微信支付订单号
subsidy_refund_id 必填 string
【微信补差回退单号】 微信补差回退单号，微信补差回退系统返回的唯一标识
refund_id 选填 string
【微信退款单号】 微信退款单号，微信系统退款返回的唯一标识。因用户账户异常而无法退款时可不传，其他情况必传
out_order_no 必填 string
【商户补差回退单号】 商户系统内部的补差回退单号，在商户系统内部唯一，同一补差回退单号多次请求等同一次。只能是数字、大小写字母_-|*@
amount 必填 integer
【补差回退金额】 补差回退金额
description 必填 string
【补差回退描述】 补差回退描述
result 必填 string
【补差回退结果】 补差回退结果
可选取值：

• SUCCESS: 已成功
• FAIL: 已失败
success_time 必填 string
【补差回退完成时间】 补差回退完成时间，遵循RFC3339标准格式
subsidy_id 选填 string(64)
【微信补差单号】 微信补差单号，微信系统返回的唯一标识
from 选填 array[object]
【回退出资账户及金额】 回退出资账户及金额
• 属性

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
429	FREQUENCY_LIMITED	频率限制	请降低频率后重试