最新更新时间:2020.09.15 版本说明
对带有补差标识的订单,如果不需要补差,可在发起分账前,可调用这个接口进行取消补差。
• 取消补差完成后,商户可以对未补差的订单进行分账。
• 订单补差取消的前置条件是订单发生退款。
• 发起方维度=200QPS。
• 特约商户维度=200QPS。
• 订单维度1QPS。
适用对象:电商平台
请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/subsidies/cancel
请求方式:POST
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
二级商户号 |
sub_mchid | string[1,32] | 是 | body 补差的电商平台二级商户,填写微信支付分配的商户号。 示例值:1900000109 |
微信订单号 | transaction_id | string[1,64] | 是 | body 微信支付订单号。 示例值: 4208450740201411110007820472 |
取消补差描述 | description | string[1,80] | 是 | body 取消补差描述,查询的时候原样带回。 示例值:订单退款 |
{
"sub_mchid": "1900013401",
"transaction_id": "4208450740201411110007820472",
"description": "订单退款"
}
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
二级商户号 | sub_mchid | string[1,32] | 是 | 补差的电商平台二级商户,填写微信支付分配的商户号。 示例值:1900013401 |
微信订单号 | transaction_id | string[1,64] | 是 | 微信支付订单号。 示例值: 4208450740201411110007820472 |
取消补差结果 | result | string[1,16] | 是 | 取消补差结果,枚举值: SUCCESS:成功 FAIL:失败 示例值:SUCCESS |
取消补差描述 | description | string[1,80] | 是 | 取消补差描述 示例值:订单退款 |
{
"sub_mchid": "1900013401",
"transaction_id": "4208450740201411110007820472",
"result": "SUCCESS",
"description": "订单退款"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
400 | INVALID_REQUEST | 参数错误 | 请使用正确的参数重新调用 |
429 | FREQUENCY_LIMITED | 频率限制 | 请降低频率后重试 |