创建 iOS 自动续订订阅

GitHub

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

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

概述

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

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

前提条件

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

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

创建订阅

前往订阅

在 App Store Connect 中，选择您的应用并转到 在 App Store Connect 中，选择您的应用并转到.

订阅 > 订阅
前往订阅

创建新订阅 + 点击
订阅组旁边的图标添加一个新的订阅。

输入基本信息参考名称
- : 为内部使用而设计的描述性名称（不向客户显示）
产品 ID: 订阅的唯一标识符（不能在之后更改）
- 格式： com.yourcompany.yourapp.premium_monthly
- 使用描述性、全小写的名称，使用下划线
- 必填项，用于配置 native-purchases 插件
配置时长

从可用选项中选择订阅时长：
- 1 周
- 1 个月
- 2 个月
- 3 个月
- 6个月
- 1年
计费周期决定用户每月被收费的频率。
设置定价

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

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

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

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

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

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

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

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

描述:订阅内容的简要描述
- 保持简洁，重点是利益
- 提及关键功能
- 突出价值主张
App Store 推广图像（可选）

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

点击保存用于创建订阅。

首次订阅:
- 必须与新版应用程序一起提交
- 在下一次App Store提交中包含
- 不能独立提交
后续订阅:
- 可以直接从订阅页面提交
- 不需要新版应用程序
- 在首次订阅获得批准后可用

订阅状态

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

状态	描述	是否可以测试？
缺少元数据	设置不完整	是（沙盒）
准备提交	已完成但未提交	是（沙盒）
等待审查	已提交到 Apple	是 (沙盒)
待审核	正在由 Apple 进行审核	是 (沙盒)
已通过	可用于购买	是
被拒绝	需要修改	是 (沙盒)

在您的应用中使用

创建后，请使用产品 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 每月承诺付款计划.

最佳实践

定价策略

月度计划：降低门槛，培养习惯
年度计划：更好的价值，高回报率，低流失率
多个等级：针对不同用户群的基本，高级，最高级
竞争分析：研究类似应用的定价

产品 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 与 (区分大小写) 匹配
检查订阅是否属于订阅组
确保 bundle identifier 与 App Store Connect 匹配
创建产品后等待 2-3 小时

无法提交订阅:

请完成所有必填字段 (名称、描述、价格)
添加至少一种本地化
请确认银行/税务信息已通过审批
检查首个订阅 (需要应用版本)

家庭共享功能已禁用:

已启用 (无法禁用)
订阅详细信息
如果卡住，请联系苹果支持

价格等级不可用：

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

“无效产品ID”错误：

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

下一步行动

为吸引新订阅者而创建一个引入性优惠为支持的年度订阅计划创建月度承诺付款计划
为支持的年度订阅计划配置沙盒测试为回收和保留而设置促销优惠
实施订阅分析跟踪额外资源
Section titled “额外资源”
欲了解更多详细信息，请参阅

For more details, refer to the __CAPGO_KEEP_0__

For more details, refer to the __CAPGO_KEEP_2__ official Apple documentation on auto-renewable subscriptions.

继续从创建 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 的本地能力