开发指引
更新时间：2025.09.08本开发指引对微信支付电子发票的标准流程、关键场景的开发思路和最佳实践展开介绍。你可以阅读开发指引，并结合【API文档】完成微信支付电子发票的接入流程。
1、前置条件
为降低开发指引环节的阅读和实践成本，建议在阅读本指引前，确保你已经：
2、开发指引
你可以根据商户的不同需求，调用微信的电子发票能力，进行场景应用。
业务时序图
步骤一 邀请商户开通
1、邀请商户开通：通过《获取邀请商户开通服务商电子发票能力》接口获取授权链接，可生成邀请二维码或按钮邀请商户超管/法人开通；
2、查询开通商户：通过《获取邀请开通的商户信息》接口，查询指定时间内邀请的商户列表；
3、查询授权状态：通过《检查子商户开票功能状态》查询已邀请的商户授权功能状态；
步骤二 初始化配置
1、创建卡券模板：通过《创建电子发票卡券模板》接口为商户创建电子发票的卡券模板（by 商户号维度），用于交付电子发票。
2、配置开发选项：通过《配置开发选项》接口设置回调地址等，用于接收微信的授权通知、开票通知、插卡通知等相关通知，设置是否打开支付账单开票入口，是否支持开电子专用发票等。
步骤三 用户申请开票
场景1、微信支付账单申请开票
用户微信支付完成后，收到带「开发票」入口的微信支付消息通知，用户可通过支付账单页进入微信官方页填写发票抬头，并提交申请。用户填写抬头后，会收到用户发票抬头填写完成通知，然后通过《获取用户填写抬头信息》接口，获取用户填写的申请信息等；
场景2、扫码/小程序等其他场景申请开票
用户也可通过扫描开票二维码或在订单小程序申请开票，用户扫码或点击后，可通过《获取用户抬头填写链接》由用户填写抬头，填写后，会收到用户发票抬头填写完成通知，然后通过《获取用户填写抬头信息》接口，获取用户填写的申请信息。
步骤四 开具发票
获取用户开票申请后，根据用户申请订单号匹配订单信息开票
模式一【腾讯数电发票模式】：为了便于服务商开发，腾讯提供了数电发票能力，可实现发票的开具生成、查询、下载等（腾讯生成电子发票文件）；
1、开具发票：获取用户填写抬头后，根据订单号匹配相关订单信息，然后调用《开具通用行业电子发票》/《开具不动产租赁行业电子发票》为用户开具电子发票，并收到发票开具成功通知和发票插入用户卡包成功通知；
2、冲红发票：如商户需对已开具的电子发票进行冲红（开具红票），可调用《冲红数电发票》进行冲红，并收到发票冲红成功通知和发票卡券作废通知，将其从用户的微信卡包中删除；
3、查询发票：调用开具电子发票接口或冲红电子发票接口成功后，可通过《查询电子发票》查询电子发票开具/冲红结果，并获取已开具/冲红/插卡的电子发票信息；
4、下载发票：如需下载电子发票，可先通过《查询电子发票》获取电子发票相关参数信息，然后通过《获取发票下载信息》，获取发票信息，调取《下载发票文件》，下载发票版式文件。
模式二【自建/第三方平台模式】：如果商户/服务商已经自建或者选择了其他发票平台，且具备发票的开具、生成等能力，可通过「自建/第三方平台模式」自行开具发票，并通过微信卡包交付发票等；
1、开具发票：获取用户授权的信息后，根据订单号匹配相关订单信息，然后调用自建/第三方开票平台发起开票申请；
2、发票插卡：开票完成后，调用《上传电子发票文件》接口和《将电子发票插入微信用户卡包》，交付消费者卡包，并收到发票插入用户卡包成功通知；可调用《查询电子发票》接口，获取插卡信息。
|
