开发指引（自建/第三方模式）

本开发指引对微信支付电子发票的标准流程、关键场景的开发思路和最佳实践展开介绍。你可以阅读开发指引，并结合【API文档】完成微信支付电子发票的接入流程。

1. 前置条件

为降低开发指引环节的阅读和实践成本，建议在阅读本指引前，确保你已经：

2. 开发指引

你可以根据商户的不同需求，调用微信的电子发票能力，进行场景应用。

业务时序图

步骤一 商户根据接入前准备确认开通电子发票权限，并完成相关的开票模式选择和产品设置后，先调用《配置开发选项》接口设置回调地址、支付开票入口标识等，用于接收获取用户抬头等信息通知；调用《创建电子发票卡券模板》接口创建电子发票的卡券模板；

步骤二 申请开具电子发票

用户通过微信支付消费，商户可在支付账单页展示开票入口。通过《微信支付下单接口》传入电子发票入口开放标识字段（仅指定订单展示）或通过《配置开发选项》设置支付订单标识（设置后全部订单展示）；用户支付完成后，收到带「开发票」入口的支付消息账单通知，通过支付账单页填写发票抬头，并提交申请；

用户通过其他方式消费，可通过《获取抬头填写链接》，生成开票二维码或在订单小程序展示，用户扫码或点击后，填写发票抬头信息。

步骤三 用户填写抬头后，会收到《用户发票抬头填写完成通知》，然后通过《获取用户填写的抬头》，获取用户填写的信息；获取填写抬头后，匹配相关订单信息，向自建/第三方开票平台发起开票申请；开票完成后，调用《上传电子发票文件》接口，根据授权信息《将电子发票插入微信用户卡包》，交付消费者；

步骤四 如需对已开具的电子发票进行冲红（开具红票），可调用卡券核销接口进行冲红，并将其从用户的微信卡包中删除；

步骤五 调用《将电子发票插入微信用户卡包》和卡券核销接口接口成功后，可调用《查询电子发票》接口，获取已开具/冲红/插卡的电子发票信息，建立发票与插卡信息的关联关系，可用于卡券cell位跳转发票详情等。