开发指引(自建/第三方模式)

更新时间:2025.09.18

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

1、前置条件

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

  • 阅读【接入前准备】文档,完成AppID、商户证书等相关参数和材料的准备

  • 阅读【接口规则】文档,了解微信支付API v3通用的基础约定,包括认证机制、请求规则、数据格式、参数兼容性、错误处理等

2、开发指引

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

业务时序图

步骤一 邀请商户开通

1、邀请商户开通:通过《获取邀请商户开通服务商电子发票能力接口获取授权链接,可生成邀请二维码或按钮邀请商户超管/法人开通;

2、查询开通商户:通过《获取邀请开通的商户信息接口,查询指定时间内邀请的商户列表;

3、查询授权状态:通过《检查子商户开票功能状态查询已邀请的商户授权功能状态;

 

步骤二 初始化配置

1、创建卡券模板:通过《创建电子发票卡券模板接口为商户创建电子发票的卡券模板(by 商户号维度),用于交付电子发票。

2、配置开发选项:通过配置开发选项接口设置回调地址等,用于接收微信的授权通知、开票通知、插卡通知等相关通知,设置是否打开支付账单开票入口,是否支持开电子专用发票等。

 

步骤三 用户申请开票

场景1、微信支付账单申请开票

用户微信支付完成后,收到带「开发票」入口的微信支付消息通知,用户可通过支付账单页进入微信官方页填写发票抬头,并提交申请。用户填写抬头后会收到用户发票抬头填写完成通知,然后通过获取用户填写抬头信息》接口,获取用户填写的申请信息等;

场景2、扫码/小程序等其他场景申请开票

用户也可通过扫描开票二维码或在订单小程序申请开票,用户扫码或点击后,可通过获取用户抬头填写链接由用户填写抬头,填写后,会收到用户发票抬头填写完成通知,然后通过获取用户填写抬头信息接口,获取用户填写的申请信息。

 

步骤四 开具发票

获取用户开票申请后,根据订单号匹配相关订单信息,商户/服务商然后调用【自建/第三方开票平台】发起开票申请;

 

步骤五、发票插卡

开票完成后,调用《上传电子发票文件接口和《将电子发票插入微信用户卡包,交付消费者卡包,并收到发票插入用户卡包成功通知;可调用《查询电子发票接口,获取插卡信息。

 

元宝AI
反馈
目录
置顶