服务商下单的时候带上补差标识，微信订单支付成功并结算完成后，发起分账前，调用这个接口进行补差。

1. 电商平台下单时传入补差金额，详见【合单下单API】文档中补差字段说明。
2. 确保账户余额充足。
3. 补差金额需要和下单的时候的补差金额保持一致(当订单发生用户退款时，该金额可以小于下单填写的补差金额)。
4. 该接口支持重入，请求参数相同只会扣款一次，重入有效期180天。
5. 系统异常（如返回SYSTEM_ERROR），请使用相同参数稍后重新调用，请务必用原参数来重入此接口，如更换金额重试，可能会导致重复扣款，系统会在1天后回退到原账户。
6. 一笔订单只能补差一笔。

接口说明

支持商户：

【普通服务商】

请求方式：

【POST】/v3/ecommerce/subsidies/create

请求域名：

【主域名】

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)
【电商平台二级商户号】 补差的电商平台二级商户，填写微信支付分配的商户号
transaction_id 必填 string(64)
【微信订单号】 微信支付订单号
amount 必填 integer
【补差金额】 补差金额，单位为分，只能为整数，不能超过下单时候的最大补差金额
description 必填 string(80)
【补差描述】 补差备注描述，查询的时候原样带回来
out_subsidy_no 选填 string
【商户补差单号】 商户系统内部的补差单号，在商户系统内部唯一，同一补差单号多次请求等同一次。只能是数字、大小写字母_-|*@

请求示例

POST

应答参数

200OK
sub_mchid 必填 string
【电商平台二级商户号】 补差的电商平台二级商户，填写微信支付分配的商户号
transaction_id 必填 string
【微信订单号】 微信支付订单号
subsidy_id 必填 string(64)
【微信补差单号】 微信补差单号，微信系统返回的唯一标识
description 必填 string
【补差描述】 补差描述
amount 选填 integer
【补差金额】 补差金额
result 必填 string
【补差单结果】 补差单结果
可选取值：

• SUCCESS: 补差成功
• FAIL: 补差失败
• REFUND: 全额回退补差
success_time 必填 string
【补差完成时间】 补差完成时间，遵循RFC3339标准格式
out_subsidy_no 选填 string
【商户补差单号】 商户系统内部的补差单号，在商户系统内部唯一，同一补差单号多次请求等同一次。只能是数字、大小写字母_-|*@

应答示例

200 OK

错误码

公共错误码

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

业务错误码

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