创建iOS自动续费订阅

GitHub

复制一个包含安装步骤和本插件的完整Markdown指南的设置提示。

自动续订订阅提供 iOS 应用程序中的内容、服务或高级功能的连续访问。本指南将指导您在 App Store Connect 中创建订阅。

概述

自动续订订阅将在每个billing周期结束时自动续订，直到用户取消。它们适用于:

高级内容和功能
无广告体验
云存储和同步
流媒体服务
专业工具和实用程序

前提条件

在创建订阅之前，您必须：

创建订阅组以组织您的订阅
拥有有效的Apple Developer Program会员资格
在App Store Connect中完成银行和税务信息

创建订阅

导航到订阅

在App Store Connect中，选择您的应用并转到 收入 > 订阅.

选择您的订阅组或如果需要则创建一个新的
创建新订阅

点击 + 订阅组旁边的图标添加新订阅。
输入基本信息

参考名称:用于内部使用的描述性名称（不向客户显示)
- 例如：“Premium 月度”，“Ultimate 年度”，“基本计划”
产品 ID:此订阅的唯一标识符（不能在以后更改)
- 格式： com.yourcompany.yourapp.premium_monthly
- 使用描述性、小写的名称，使用下划线
- Required for configuring the native-purchases plugin
配置时长

选择可用的订阅时长:
- 1 周
- 1 个月
- 2 个月
- 3 个月
- 6 个月
- 1 年
时长决定用户被计费的频率。
设置定价

点击 添加订阅价格 配置定价:

基础地区: 选择您的主要市场（通常是您的国家）

价格: 设置订阅价格
- 苹果会自动将价格转换为其他货币
- 选择苹果的价格等级
- 考虑到人们的价值观和市场价格
家庭共享（可选）

决定是否启用家庭共享，允许最多6名家庭成员访问订阅。

一旦启用家庭共享，它就不能在此产品中关闭。

启用条件:
- 内容适合家庭使用
- 您希望增加价值提议
- 您的商业模式支持它
不启用条件:
- 订阅仅限个人使用
- 内容针对个人用户
- 您希望最大化每用户收入
添加本地化

在您的应用程序支持的所有语言中添加订阅显示信息：

订阅显示名称: 客户端名称（例如，“每月高级”）

描述: 订阅所包含的简要描述
- 保持简洁，重点突出好处
- 提及关键功能
- 突出价值提议
App Store 推广图片（选填）

上传此订阅的推广图片（312x390像素）:
- 在 App Store 订阅页面显示
- 应与您的应用设计保持一致
- 包含订阅名称以提高清晰度
虽然图像在初始提交中是可选的，但在 App Store 的促销显示中是必需的。您可以稍后添加它们。
保存并提交

点击保存为创建订阅而点击

首次订阅:
- 必须与新应用版本一起提交
- 包含在您的下一个App Store提交中
- 无法独立提交
对于后续订阅：
- 可以直接从订阅页面提交
- 不需要新应用程序版本
- 在首次订阅批准后可用

订阅状态

您的订阅将具有以下状态之一：

状态	描述	是否可以测试?
缺少元数据	设置不完整	是（沙盒）
准备提交	已完成但未提交	是（沙盒）
等待审查	已提交到苹果	是（沙盒）
正在审查	苹果正在审查	是（沙盒）
已通过	可供购买	是
被拒绝	需要修改	是（沙盒）

在您的应用中使用

创建后，请使用产品 ID 在应用中引用订阅：

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// Fetch subscription products direct from StoreKit
const { products } = await NativePurchases.getProducts({
  productIdentifiers: [
    'com.yourcompany.yourapp.premium_monthly',
    'com.yourcompany.yourapp.premium_annual',
  ],
  productType: PURCHASE_TYPE.SUBS,
});

products.forEach((product) => {
  console.log(`${product.title}: ${product.priceString}`);
  console.log(`Duration: ${product.subscriptionPeriod}`);
  console.log(`Description: ${product.description}`);
});

// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)
try {
  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: 'com.yourcompany.yourapp.premium_monthly',
    productType: PURCHASE_TYPE.SUBS,
  });

  console.log('Transaction ID:', transaction.transactionId);

  // StoreKit receipts are included on iOS for server-side validation
  await sendReceiptToBackend(transaction.receipt);
} catch (error) {
  console.error('Purchase failed:', error);
}

// Check subscription status using the store's data
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const premium = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',
);

if (premium?.isActive) {
  console.log('Expires:', premium.expirationDate);
  console.log('Will renew:', premium.willCancel === false);
  console.log('Store state:', premium.subscriptionState);
  unlockPremiumFeatures();
} else {
  showPaywall();
}

每月付款计划（12个月承诺）

如果您的App Store Connect订阅配置为每月付款计划和12个月承诺，StoreKit可以返回该产品的额外定价条款。使用这些条款显示每月费用、总承诺价格和全承诺期前购买。

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',
);

const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });
}

查看完整的付费墙和权利流程，请参见 iOS每月承诺付款计划.

最佳实践

每月付款计划

Section titled “Monthly with 12-Month Commitment Plans”: 简化入门，培养习惯
年度计划: 更高的价值，高回报率，低流失率
多个等级: 基础、精英、至尊等级适用于不同用户群
竞争分析: 研究类似应用的定价

产品ID

保持一致的命名: company.app.tier_duration
包含等级和持续时间在ID中: premium_monthly, ultimate_annual
避免更改产品ID（它们是永久的）
为团队记录所有产品 ID

为家庭导向的应用程序（游戏、教育、娱乐）启用
考虑到收入的影响
彻底测试共享行为
在营销中传达共享能力

本地化

将所有订阅名称和描述都翻译成
考虑区域价格差异
在所有支持的语言中测试显示
使用适当的市场语言

促销图片

保持一致的视觉风格
包含订阅名称和关键优势
更新季节促销
与应用的整体设计语言相匹配

常见订阅模式

单层（免费）

Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)

多层级 (好,更好,最好)

- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99

- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99

可消耗 + 订阅混合

- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

故障排除

订阅未在应用中加载：

确认产品 ID 与订阅 ID 匹配（大小写敏感）
检查订阅是否在订阅组中
确保 App Store Connect 的包标识符与应用包标识符匹配
创建产品后等待2-3小时

无法提交订阅:

完成所有必填字段（名称、描述、价格）
添加至少一个本地化
验证银行/税务信息已批准
检查首次订阅（需要应用程序版本）

家庭共享开关禁用:

已启用（无法禁用）
检查订阅详细信息
如果卡住，请联系Apple支持

价格级别不可用:

可能在某些地区受限制
选择替代等级
联系苹果询问价格问题

“无效产品ID”错误：

必须以反向域名格式
不能包含空格或特殊字符
检查拼写错误
验证所有产品的唯一性

下一步

创建引流新订阅者吸引新订阅者的月度承诺付款计划
下一步为支持的年度订阅计划
配置沙盒测试测试您的订阅
设置促销活动以实现回归和保留
实施订阅分析跟踪

额外资源

更多详细信息，请参阅苹果官方文档关于自动续订订阅.

继续从创建iOS自动续订订阅

如果您正在使用 创建 iOS 自动续订订阅 为了计划商店审批和发布，连接它使用 @capgo/native-purchases 对于在使用 @capgo/native-purchases 中的原生能力 @capgo/capacitor-in-app-review 对于在 @capgo/capacitor-in-app-review 中的实现细节使用 @capgo/capacitor-in-app-review 对于在使用 @capgo/capacitor-in-app-review 中的原生能力 @capgo/capacitor-native-market 对于在 @capgo/capacitor-native-market 中的实现细节，以及使用 @capgo/capacitor-native-market 对于在使用 @capgo/capacitor-native-market 中的原生能力