uni-app如何实现微信小程序发票抬头功能 uni-app调用微信发票

冬萱姑娘_4512

冬萱姑娘_4512

2026-05-20

344人浏览

原创

uni-app调用微信小程序发票抬头api需满足:仅mp-weixin平台、基础库≥2.0.0真机环境;manifest勾选微信小程序并开通电子发票权限;用户微信卡包已绑定有效抬头。

uni-app如何实现微信小程序发票抬头功能 uni-app调用微信发票

uni-app 调用微信小程序发票抬头 API 的前提条件

微信小程序的发票抬头功能依赖原生 wx.chooseInvoiceTitle,而 uni-app 默认 H5/APP 端不支持该 API。只有在 微信小程序平台编译 且 基础库 >= 2.0.0 的真机环境(开发者工具模拟有时失效)下才能调用成功。

  • 必须使用 uni.getProvider 检查当前是否运行在微信小程序环境:uni.getProvider({service: 'invoice'}) 返回空数组?说明未启用发票能力,需确认 manifest.json 中已勾选「微信小程序」并重新编译
  • 小程序后台需开通「微信支付」和「电子发票」权限(即使不走支付流程,仅调用抬头选择也需要发票类目资质)
  • 用户需已绑定微信卡包,否则 wx.chooseInvoiceTitle 会直接失败并报错 errCode: -1

uni-app 中正确调用 chooseInvoiceTitle 的写法

uni-app 不提供跨平台封装的发票 API,必须通过 uni.$on('wx') 或条件编译调用原生微信方法:

  • 使用条件编译(推荐):

    // #ifdef MP-WEIXIN
    wx.chooseInvoiceTitle({
    success(res) {
      console.log('发票抬头', res)
      // res.title:单位名称
      // res.taxNumber:纳税人识别号
      // res.companyAddress:地址电话
      // res.bankAccount:开户行及账号
    },
    fail(err) {
      console.error('调用失败', err.errMsg) // 如 'chooseInvoiceTitle:fail cancel' 或 'fail not support'
    }
    })
    // #endif
    
  • 不要用 uni.chooseInvoiceTitle —— 这个 API 不存在,uni-app 官方未封装

    微信聊天分析及预测工具
    微信聊天分析及预测工具

    微信聊天分析助手 v2.1.0 — 完全本地运行的隐私保护工具。 分析聊天记录,推断 MBTI 与大五人格,检测情感趋势,生成可视化报告。 支持 jieba 精准分词、否定识别、反讽检测、风险预警。 内置 RAG 检索增强预测和多智能体博弈模拟,完全本地化、零数据外传。 可选 MiroFish 群体智能引擎增强对话预测。

    下载
  • 不能在 onLoad/onShow 中直接调用:部分机型会因页面未完全 ready 导致白屏或静默失败,建议绑定按钮点击触发

常见错误与对应处理
  • fail not support:基础库版本过低(检查 project.config.json 中 minPlatformVersion 是否 ≥ 2.0.0),或当前运行环境不是微信小程序(如调试时误选 H5 模式)
  • fail cancel:用户手动取消,无需报错,但需判断 res.errMsg 是否含 cancel 字符串来区分主动放弃和异常
  • 返回字段缺失(如无 taxNumber):用户在微信卡包中未填写完整信息,不能假设所有字段必填;后端接收时应允许空值或做默认占位
  • 多次调用卡死:微信原生限制连续调用会阻塞,建议加防抖(setTimeout + 标志位)或禁用按钮直到回调完成

发票抬头数据如何安全传给后端

微信返回的抬头信息是明文,但敏感字段(如 taxNumber)可能涉及合规要求:

  • 不要直接将 res 整体透传给后端;提取必要字段,剔除 timestamp、encryptData 等冗余项
  • 若后端需要验签,微信未提供发票抬头的签名机制,只能靠业务层约定加密(如 AES 加密 taxNumber 后传输)
  • 注意字符长度限制:title 最长 50 字符,taxNumber 最长 20 字符,超长需截断或前端提示

微信发票抬头功能本身不依赖支付,但整个链路对环境、权限、用户状态高度敏感——哪怕 manifest 配置差一个勾选,或用户微信卡包里少填一项,都会静默失败。真机测试前务必确认三件事:基础库版本、小程序后台发票类目开通状态、用户微信「我 → 卡包 → 发票抬头」里至少有一条有效记录。

相关文章

微信app下载
微信app下载

微信是一款手机通信软件,支持通过手机网络发送语音短信、视频、图片和文字。微信可以单聊及群聊,还能根据地理位置找到附近的人,带给大家全新的移动沟通体验,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2283

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4923

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6010

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5518

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2015

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2922

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

996

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3299

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习