# 会员订阅：iOS

# 一、概述

# 1. 能力说明

小程序虚拟支付在 iOS 端提供的会员订阅能力，用户完成一次签约后，由 Apple 按周期自动扣费。

# 2. 支持的签约类型

# 3. 准入条件

# 二、接入流程

# Step 1：申请开通

收件人：wx_virtualpayment@tencent.com

前置条件：

1. 已接入小程序虚拟支付
2. 小程序首次发布时间至今 ≥ 90 天
3. 小程序完成认证备案
4. 近 30 天日均 DAU ≥ 1 万

邮件主题：申请开通小程序订阅 - 小程序昵称 - 申请日期

邮件正文：

小程序昵称：
小程序appid：
虚拟支付商户号：
小程序主体：
小程序类目：
业务模式：主营业务，小程序dau，交易金额
申请用途：苹果订阅相关产品
页面交互：（开通、续费、管理流程，图片jpg、png格式，文件大小不超过2MB）

交互示意：

交互图片注意事项：

1. 不允许使用拍照图片
2. 需把完整的交互都放在一张图片里
3. 购买记录页面需要出现客服电话，且客服电话需要完成认证

# Step 2：物品配置

在 MP 后台配置订阅道具，配置方式与安卓订阅一致：

小程序后台 → 虚拟支付 → 基础配置 → 道具配置 → 添加道具 → 选择「会员订阅」

物品的 product_id 在安卓和苹果端通用，不需要为苹果端单独创建新的订阅物品。

# Step 3：苹果订阅签约

# 3.1 接口说明

# 3.2 入参

# 3.3 签约类型控制

三种签约类型通过 activitySellingPrice 参数控制：

# 3.4 调用示例

原价签约：

wx.requestAppleSubscribeSign({
  signData: JSON.stringify({
    offerId: '1450032323',
    productId: 'subscription_vip_monthly',
    goodsPrice: 3000,
    attach: 'uid=12345'
  }),
  paySig: '...',
  signature: '...',
  success(res) { /* 拉起成功 */ },
  fail(err) { /* 用户取消或失败 */ }
})

优惠价签约（首开 9.9 元，续费恢复原价 30 元）：

wx.requestAppleSubscribeSign({
  signData: JSON.stringify({
    offerId: '1450032323',
    productId: 'subscription_vip_monthly',
    goodsPrice: 3000,
    activitySellingPrice: 990,
    attach: 'uid=12345'
  }),
  paySig: '...',
  signature: '...',
  success(res) { /* 拉起成功 */ },
  fail(err) { /* 用户取消或失败 */ }
})

免费试用签约（首开 0 元，续费恢复原价）：

wx.requestAppleSubscribeSign({
  signData: JSON.stringify({
    offerId: '1450032323',
    productId: 'subscription_vip_monthly',
    goodsPrice: 3000,
    activitySellingPrice: 0,
    attach: 'uid=12345'
  }),
  paySig: '...',
  signature: '...',
  success(res) { /* 拉起成功 */ },
  fail(err) { /* 用户取消或失败 */ }
})

注意：该接口返回值不能作为签约成功的判定标准，需以签约成功通知或签约查询结果为准。

# Step 4：接收通知

# 4.1 通知场景

# 4.2 签约成功通知（xpay_apple_subscribe_signing_result_notify）

触发时机：用户首次签约成功时下发一次。续费场景不会再次发送本通知。

基础字段：

AppleSubscriptionInfo 内容：

# 4.3 扣款发货通知（xpay_goods_deliver_notify）

触发时机：每次扣款成功后下发（首次扣款与后续自动续费扣款通知格式一致）。

基础字段：

GoodsInfo 内容：

AppleSubscriptionInfo 内容：

# 4.4 返回参数

两类通知的返回格式一致，开发者收到通知后需按以下格式返回：

XML 示例：

<xml>
  <ErrCode>0</ErrCode>
  <ErrMsg>success</ErrMsg>
</xml>

# Step 5：平台自动写入苹果订阅订单

# 5.1 背景

苹果订阅的扣款由 Apple 自动发起，小程序平台无法主动发起扣款，只能被动接收 Apple 的扣款通知。为保证订单数据的完整性，平台会在收到 Apple 扣款通知后，自动在虚拟支付订单表中写入一条苹果订阅扣款成功的订单记录，订单类型标记为苹果订阅。

# 5.2 写入时机

平台收到 Apple 的扣款通知后：

• 向开发者推送 xpay_goods_deliver_notify（开发者处理发货）
• 同步在平台订单库写入一条订单记录（订单类型 = 苹果订阅）

# Step 6：订阅状态查询

开发者可随时查询用户的订阅状态，包括自动续费开关、下次续费时间等。

# 6.1 接口说明

# 6.2 请求参数

# 6.3 响应参数

公共响应：

apple_subscription_info 内容：

# 6.4 响应示例（mode=apple）

{
  "errcode": 0,
  "errmsg": "ok",
  "authorization_state": "SIGNED",
  "apple_subscription_info": {
    "original_transaction_id": "2000001147426510",
    "auto_renew_status": 1,
    "recent_subscription_start_date": 1775226065000,
    "renewal_date": 1775226245000
  }
}

# Step 7：退款处理

# 7.1 退款基本规则

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

# 7.2 用户申请退款流程

1. 用户在 App Store 提出退款申请
2. Apple 支付根据自身策略判断，并向开发者发起重复三次的退款问询
3. 开发者可根据自身策略响应问询
4. Apple 支付只会参考开发者的问询结果，最终结果依然由 Apple 支付处理

详情可咨询苹果公司 (Apple)。

# 7.3 退款问询通知（xpay_subscribe_ios_refund_query_notify）

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

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

问询消息内容（WxaVirtualPayIosRefundQueryNotifyEvent）：

# 7.4 应答响应（IosRefundQueryResponse）

# 7.5 退款成功后续通知

如 Apple 支付发起退款并退款成功，平台会通过原有的退款推送接口通知开发者：

• 接口名：xpay_refund_notify
• 详细文档参考：虚拟支付-退款推送