微信小程序虚拟商品付费功能需要接入微信官方提供的虚拟支付通道。自 2026 年 4 月 1 日起,涉及虚拟商品的小程序必须完成全终端(iOS、安卓、Windows、鸿蒙)的虚拟支付接入,否则可能面临功能受限或服务暂停。本文整理了从开通流程、iOS 单独配置到测试踩坑的完整指南。

一、开通流程
前置条件
- 小程序必须完成认证,个人主体不行,需企业、事业单位或个体工商户(个体户主体现已支持)
- 主体信息要完备:营业执照、提现账户、支付管理员等
开通步骤
在微信公众平台后台左侧菜单找到「虚拟支付」,点击「开通」按钮。流程包括:阅读协议 → 提交营业执照和银行账户 → 设置支付管理员 → 等待审核(1-7 个工作日)→ 账户验证 → 签约。

签约完成后,虚拟支付栏目会变成完整的商户管理模块,包含基础配置、代币/道具管理、资金管理、交易订单等功能。

⚠️ 注意:开通基础虚拟支付后,iOS 苹果支付不是默认开启的,需要单独在后台「虚拟支付 - 基础配置」中手动打开苹果支付开关。这是两个独立的步骤。
二、道具与代币配置
进入「虚拟支付 - 基本配置 - 道具配置」新增道具,填写 ID、名称、价格等信息。道具需要发布到现网才能使用,发布前可保存为开发版本在安卓沙箱环境调试(iOS 不支持沙箱)。


如果选择代币模式,需在「代币配置」中设置兑换比例(常见 1:10 或 1:100)。比例一旦发布就无法修改,上线前务必确认。

Android 和 iOS 两端道具/代币是互通的,配置一次双端可用。
三、费率说明

- 安卓端:技术服务费 1%
- iOS 端:走 Apple IAP,标准费率 17%(苹果 12% + 腾讯 5%)。2026 年腾讯限时减免自身部分到 0%,实际费率 12%
四、接入踩坑指南
1. 简称没配置,无法开启 IAP 支付
iOS 苹果支付展示付款信息时会用到小程序的「简称」字段,未配置则无法开启 IAP 支付。

解决方法:在「设置 - 基本设置」中配置简称并提交审核。
2. 后台没开苹果支付开关
基础虚拟支付和 iOS 苹果支付是两个独立开关。默认苹果 IAP 支付开关是关闭的,需手动开启。开启后约 10 分钟生效,期间测试仍会失败。

3. iOS 不支持沙箱环境
安卓可用沙箱环境随便测,但 iOS 苹果支付完全不支持沙箱,只能走现网环境。

在 iOS 上测试必须使用 env: 0(现网参数)和真实 Apple ID,测试扣款也是真实的。建议配置价格最低的商品(1 元起步),测试完成后在苹果账户申请退款。
4. 结算周期与到账延迟
iOS 端结算周期为月结,当月收益次月 27-28 日结算到微信商户账户,存在结算延迟属正常现象。
5. 用户端版本要求
iOS 用户需要系统版本 iOS 15 及以上,微信客户端 8.0.68 及以上版本才能使用苹果支付。

五、总结
接入虚拟支付最耗时的不是写代码,而是配置项的先后顺序和生效时机:
- 简称要先配好
- 苹果支付开关需手动开启
- 开启后需等待约 10 分钟生效
- iOS 必须用现网环境测试
- 测试用 Apple ID 需有购买能力