冲红电子发票

更新时间:2025.09.03

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

接口说明

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

请求方式:【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  包体参数

 sub_mchid  必填   string(32)

【子商户号】 微信支付分配的子商户号,具体请参考服务商模式开发必要参数说明


 reverse_reason  必填   string(200)

【冲红原因】 非数电模式下,填入开票失败原因;
数电模式下,填入可选失败原因枚举:

  • ISSUE_ERROR: 开票有误

  • SALES_RETURN: 销货退回

  • SERVICE_SUSPENTION: 服务中止

  • SALES_DISCOUNT: 销售折让


 fapiao_information  选填   array[object]

【需要冲红的发票信息】 需要冲红的发票信息

属性

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/new-tax-control-fapiao/fapiao-applications/4200000444201910177461284488/reverse \
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    "reverse_reason" : "非数电模式:退款;数电模式:ISSUE_ERROR|SALES_RETURN|SERVICE_SUSPENSION|SALES_DISCOUNT",
9    "fapiao_information" : [
10      {
11        "fapiao_id" : "20200701123456",
12        "fapiao_number" : "12897794"
13      }
14    ]
15  }'
16

应答参数

无应答包体

应答示例

202 Accepted

1'无应答包体'
2

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

请求参数符合参数格式,但不符合业务规则

请使用正确的参数重新调用

400

RESOURCE_ALREADY_EXISTS

发票申请单已存在

请稍后调用【查询电子发票】接口获取开票结果

403

NO_AUTH

商户无权限

请检查是否已经开通电子发票产品相关功能权限,并检查子商户是否接受了服务商的邀请

403

RULE_LIMIT

发票当前状态不允许冲红

请检查发票状态是否为“发票已开具”,可调用【查询电子发票】接口获取当前的发票状态

404

RESOURCE_NOT_EXISTS

发票申请单不存在

请检查发票申请单号是否正确

404

RESOURCE_NOT_EXISTS

要冲红的发票不存在

请检查商户发票单号、发票代码、发票号码是否正确

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

 

反馈
咨询
目录
置顶