# iOS 端接入

微信小程序现已支持 iOS 端的虚拟支付服务，开发者可按照以下指引接入：

# 一、基础功能

开发者需先开通小程序虚拟支付，并完成基础配置。可参考：虚拟支付-产品介绍

# 二、功能开通

小程序同时满足以下条件：

• 已开通小程序虚拟支付
• 已配置小程序简称，配置指引：微信开放社区

操作页面：微信公众平台-虚拟支付-基础配置

注：为满足 Apple 支付对用户展示 display name 的要求，小程序需配置小程序简称

# 三、道具、代币配置

开发者配置的道具、代币均为 Android、iOS 双端互通，已配置的道具、代币可直接使用。

如需新增道具、代币也可直接使用原有方式，详见上文基础功能。

# 四、用户下单

如需使用 Apple 支付，用户需同时满足如下条件：

• 用户使用 iPhone、iPad，且升级至 iOS 15 及以上；
• 用户微信客户端升级至 8.0.68 及以上；
• 最低支付金额为 1 元；

可直接调用 wx.requestVirtualPayment，平台会根据不同的设备类型、路由至对应的支付系统：

注：Apple 支付不支持使用沙箱环境，仅支持使用现网环境

# 五、订单展示

平台提供页面、API 两种方式查看订单

• 页面：虚拟支付-交易订单，可通过支付渠道切换「普通支付」、「Apple 支付」
• API：可直接使用虚拟支付已提供的 query_order 接口查询订单

# 六、用户退款

Apple 支付不支持开发者主动向用户发起退款，用户可在 App Store 申请退款，用户申请方式：

用户申请后，Apple 支付会根据自身策略判断，并会向开发者发起重复三次的退款问询，开发者可根据自身策略响应问询。

Apple 支付只会参考开发者的问询结果，最终结果依然由 Apple 支付处理，详情可咨询苹果公司 (Apple) 。

消息推送和原有规范保持一致：消息推送

# 响应接口：xpay_subscribe_ios_refund_query_notify

如果连续 3 次、在 3 秒内均未应答退款问询，微信平台会向 Apple 支付返回「不确定」作为退款参考，也即退款决定权交由苹果公司 (Apple) 处理。

# 消息内容：WxaVirtualPayIosRefundQueryNotifyEvent

# 应答响应：IosRefundQueryResponse

如 Apple 支付发起退款、并退款成功，平台会通过原有的退款推送 xpay_refund_notify

# 七、结算入账

用户在 iOS 端支付的订单，由苹果公司 (Apple) 负责结算，详情可问询苹果公司 (Apple) 。

苹果公司 (Apple) 通常在自然月结束后 30～50 天内结算，并在扣除 15% 服务费后，将款项结算给腾讯。

腾讯收到汇款后，会在第一时间将结算资金划转至开发者的虚拟支付账户，到账后即可提现。

# 八、服务费率

在 iOS 端上进行的小程序虚拟支付，标准费率：20%。该部分费率包含苹果公司 (Apple) 、腾讯公司收取的两部分服务费。

为激励小程序开发者成长，推动小程序虚拟行业发展，腾讯的技术服务费在 2026 年限时减免。