商户对已开具的电子发票进行冲红（开具红票），并将其从微信用户的卡包中删除。仅在微信支付侧开具的电子发票才允许发起冲红。 注意：本接口成功返回仅代表冲红请求已被受理，当冲红完成时，微信支付会根据商户配置的回调地址进行回调通知，商户也可以通过【查询电子发票】接口获取冲红结果及红票信息。

接口说明

支持商户：

【普通商户】

请求方式：

【POST】/v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/reverse

请求域名：

【主域名】

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

Path 路径参数
fapiao_apply_id 必填 string(32)
【发票申请单号】 开票时指定的发票申请单号

Body 包体参数
reverse_reason 必填 string(200)
【冲红原因】 冲红原因
fapiao_information 选填 array[ReverseFapiaoInfo]
【需要冲红的发票信息】 需要冲红的发票信息
• 属性

请求示例

POST

应答参数

无应答包体

应答示例

202 Accepted

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请使用正确的参数重新调用
400	RESOURCE_ALREADY_EXISTS	发票冲红请求已被受理	请稍后调用【查询电子发票】接口获取冲红结果
401	SIGN_ERROR	签名错误或签名信息不完整	请检查签名参数和方法是否都符合签名算法要求
403	NO_AUTH	商户无权限	请检查是否已经开通电子发票产品相关功能权限，若是服务商模式，还需确认子商户是否接受了服务商的邀请
403	NO_AUTH	服务商无权限操作该发票申请单（仅服务商模式）	请检查发票申请单是否属于服务商
403	RULE_LIMIT	发票当前状态不允许冲红	请检查发票状态是否为“发票已开具”，可调用【查询电子发票】接口获取当前的发票状态
404	RESOURCE_NOT_EXISTS	发票申请单不存在	请检查发票申请单号是否正确
404	RESOURCE_NOT_EXISTS	要冲红的发票不存在	请检查商户发票单号、发票代码、发票号码是否正确
429	FREQUENCY_LIMITED	频率超限	请降低请求接口频率