iOS App Store Review Guidelines for IAP

在 App Store 上发布应用程序需要仔细遵守苹果的指南，特别是在实施内购和订阅时。这个指南涵盖了您需要知道的所有内容，以便在第一次提交时通过审核。

在提交之前

完成 App Store Connect 设置

在苹果审查您的购买流程之前，请确保应用程序记录本身是完整的：

• 添加__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ 在 App Store Connect 中
• 添加一个 __CAPGO_KEEP_1__ 该链接指向用户的真实联系方式
• 完成 填写年龄等级 问卷以使应用程序可发布
• 添加 应用程序评论联系方式 和清晰的评论者注释
• 如果需要登录，请提供 demo account 不会在审查期间过期

注意

苹果认为支持网站是一个更大的占位符链接。它应该包含真实的联系方式，用户可以通过该联系方式与您联系有关应用程序问题、反馈和功能请求。

准备真实截图

• 使用当前截图，从实际正在审查的构建中
• 对于iPhone， 1290 x 2796 (6.7英寸) 是最简单的默认尺寸
• 如果您的应用程序在iPad上运行，请上传iPad截图
• 当前接受的大型iPad尺寸包括 2064 x 2752 __CAPGO_KEEP_0__和__CAPGO_KEEP_1__ 2048 x 2732 __CAPGO_KEEP_0__英寸
• 不要将iPhone截图拉伸到假装支持iPad

在TestFlight中模拟审阅者旅程

在真实设备上模拟Apple将遵循的确切路径：

• 从TestFlight安装最新的构建
• 使用您打算提供的审阅账户登录
• 在没有隐藏手势或调试菜单的情况下到达付费墙
• 完成购买、恢复和订阅管理流程
• 如果权限被拒绝，验证应用程序仍然正确运行

内购要求

Pricing Transparency (Critical)

Apple要求在任何购买之前，必须清晰地显示价格：

必须包含的元素：

• 在购买按钮之前显示准确的价格
• 显示计费频率（例如，“$9.99/月”）
• 清晰地说明用户为他们的钱得到什么
• 指出费用何时发生

常见拒绝原因：

“Subscription pricing must be clear and upfront.”

:::caution Price Consistency 所有价格必须在以下地方一致：

• App Store metadata listing
• 内购屏幕
• 订阅管理屏幕

即使是 $1 的差异也会触发自动拒绝：应用商店列表 ($4.99) 和应用 ($5.99) 之间的差异。

订阅计划展示

必备披露：

• 同时显示所有可用的订阅等级
• 每个等级的功能清晰对比
• 不通过 UI trick 自动跳转到高级等级
• 易于找到取消订阅的指示

遵守性UI示例：

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

function SubscriptionScreen() {
  return (
    <div>
      <h2>Choose Your Plan</h2>

      {/* Show all tiers equally */}
      <PlanCard
        title="Basic"
        price="$4.99/month"
        features={['Feature A', 'Feature B']}
      />
      <PlanCard
        title="Premium"
        price="$9.99/month"
        features={['All Basic', 'Feature C', 'Feature D']}
        highlighted={false} // Don't force premium
      />

      {/* Clear cancellation info */}
      <Text>
        Cancel anytime in Settings > Subscriptions.
        No refunds for partial periods.
      </Text>
    </div>
  );
}

恢复购买

必备实现：

每个应用程序都必须为用户提供恢复之前购买的方式，而不必联系支持。

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

async function restorePurchases() {
  try {
    await NativePurchases.restorePurchases();

    const { purchases } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.SUBS,
    });

    const activeSub = purchases.find(
      (purchase) => purchase.isActive && purchase.expirationDate,
    );

    if (activeSub) {
      unlockPremiumFeatures();
      showMessage('Purchases restored successfully!');
      return;
    }

    const { purchases: iaps } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.INAPP,
    });
    const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');

    showMessage(
      hasIap ? 'Premium purchase restored!' : 'No previous purchases found.',
    );
  } catch (error) {
    showError('Failed to restore purchases. Please try again.');
  }
}

// Add a visible "Restore Purchases" button
<Button onClick={restorePurchases}>
  Restore Purchases
</Button>

常见拒绝原因

1. 应用程序崩溃或功能损坏

为什么会失败：

• 应用程序在启动时会崩溃
• 购买流程无法完成
• 截图中显示的功能无法正常工作

预防措施：

• 在真实设备上测试（而不是模拟器）
• 测试所有订阅流程的完整性
• 验证收据验证工作正常
• 检查网络错误处理

2. 元数据不匹配

为什么会失败：

• 截图显示的功能不在当前版本中
• 描述提到了不存在的功能
• 元数据中的价格与应用内价格不一致

预防措施：

// Document exactly what's in each tier
const SUBSCRIPTION_FEATURES = {
  basic: ['Ad-free', 'Cloud sync', 'Basic themes'],
  premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']
};

// Use these in both your app AND App Store description

3. 权限说明缺失

为什么会失败：

• 未提供解释的摄像头/位置/健康权限请求
• 权限请求深藏在多个屏幕中
• 模糊或通用的权限描述

预防：

更新你的 Info.plist 用清晰的说明：

<key>NSCameraUsageDescription</key>
<string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location helps us show relevant local content in your Premium subscription.</string>

4. 欺骗式营销

为什么会失败：

• 没有证据的说法，如“世界上最受欢迎的应用”
• 有隐含限制的“无限”功能
• 制造假紧迫感的策略（‘仅剩下2个位置！’）

预防措施：

• 在描述中要具体、事实性
• 避免在描述中使用无据之谈的超级词语
• 不要用假的紧迫感来压迫用户

5. 隐藏的取消流程

为什么会失败：

• 没有说明如何取消
• 取消按钮被隐藏或遮挡
• 没有使用苹果原生流程的多步取消流程

__CAPGO_KEEP_0__

// Always inform users about cancellation
function SubscriptionInfo() {
  return (
    <div>
      <h3>How to Cancel</h3>
      <ol>
        <li>Open iPhone Settings</li>
        <li>Tap your name at the top</li>
        <li>Tap Subscriptions</li>
        <li>Select this app and tap Cancel</li>
      </ol>

      <p>Or manage directly in the App Store app.</p>

      <Button onClick={openSubscriptionManagement}>
        Manage Subscription in Settings
      </Button>
    </div>
  );
}

async function openSubscriptionManagement() {
  // Direct link to iOS subscription management
  await NativePurchases.showManageSubscriptions();
}

隐私和数据使用（第 5.1.1 节）

苹果在 2025 年严格了隐私要求。

必备披露

每个权限：

1. 为什么需要它（具体用例）
2. 何时使用
3. 数据如何存储/共享
4. 是否可选或必需

Example: 正确的权限流程

async function requestCameraPermission() {
  // Show explanation BEFORE requesting
  await showDialog({
    title: 'Camera Access',
    message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.',
    buttons: ['Not Now', 'Allow']
  });

  // Then request permission
  const result = await Camera.requestPermissions();
  return result.camera === 'granted';
}

隐私营养标签

确保您的App Store隐私标签准确反映：

• 购买历史收集
• 电子邮件地址（用于收据）
• 设备ID（用于欺诈防御）
• 使用数据（用于分析）

2025年，错误的隐私标签是常见的拒绝原因。审查您的数据收集非常重要。

提交前检查清单

1. 测试所有购买流程

   • 购买每个订阅等级
   • 测试免费试用
   • 验证正确的引导价
   • 测试恢复购买
   • 验证家庭共享功能（如果启用）
   • 测试多台设备

2. 验证价格一致性

   • 检查App Store元数据与内购价格匹配
   • 验证所有货币正确
   • 确认试用期限与描述相符
   • 检查引导性优惠条款是否准确

3. 复核所有文案

   • 移除占位文本
   • 验证声明可测试
   • 检查语法和拼写
   • 确保描述与当前构建相符
   • 移除竞争对手提及

4. 测试权限

   • 只请求必要权限
   • 在请求前显示明确的说明
   • 测试“拒绝”流程（应用程序仍应正常工作）
   • 确保 Info.plist 描述清晰

5. 准备测试账户

   • 创建一个在审查期间有效的审查账户
   • 在 App Review 信息中记录登录凭证
   • 验证审查者可以访问付墙并完成购买流程
   • 如果需要，请在 Notes field 中包含额外账户或 App 特定 switch

6. 检查元数据

   • 截图与当前 UI 匹配
   • 支持 URL 包含真实联系方式
   • 隐私政策 URL 已填写
   • 年龄等级与构建中的内容匹配
   • 如果有，应用预览视频显示当前版本
   • __CAPGO_KEEP_0__准确描述了功能
   • __CAPGO_KEEP_0__隐私政策在应用内和商店列表中可访问

7. 详细写评论笔记

   Contact:
   Name: Jane Developer
   Email: review@yourapp.com
   Phone: +1 555-0100
   
   Test Account:
   Email: reviewer@test.com
   Password: TestPass123!
   This account does not expire during review.
   
   Testing Instructions:
   1. Log in with test account above
   2. Tap "Upgrade to Premium" button
   3. Select "Monthly Premium" subscription
   4. Complete purchase (no charge in sandbox)
   5. Verify premium features unlock
   
   Note: Subscription pricing is clearly shown before purchase.
   Cancellation instructions are in Settings > Account.

评论时间线

标准评论： 24-48小时 高峰期： 3-5天（App Store节日发布） 周末： 无评分处理 加速审核： 可用于关键bug修复（通过App Store Connect提出请求）

您在App Store Connect中常见的状态：

• Waiting for Review
• In Review
• Pending Developer Release
• Rejected

提示

尽早在周一提交，以避免周末延迟。周一提交通常在周三审阅。

2026年提交重点

当前重点领域

1. 订阅清晰度

• 横向比较计划要求
• 不使用“黑暗模式”隐藏更便宜的选项
• 清晰的降级/升级路径

2. 元数据准确性

• 截图必须与正在审查的构建匹配
• 如果启用了iPad支持，则需要iPad截图
• 支持URL和隐私政策应该在提交前就已经发布

3.隐私和审查详细信息质量

• 隐私披露必须与您的SDK实际收集的内容匹配
• 应用程序审查联系信息和备注应该在第一次提交时就完成
• 演示凭证必须在整个审查窗口内保持有效

4.提交准备就绪

• 苹果定期更新最低 SDK 要求，因此在上传发布版之前确认当前截止日期
• TestFlight 是最安全的地方来验证您提交之前的准确审阅者路径

原生购买插件的最佳实践

正确处理错误

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

async function handlePurchase(productId: string) {
  try {
    const transaction = await NativePurchases.purchaseProduct({
      productIdentifier: productId,
      productType: PURCHASE_TYPE.SUBS,
    });

    // Success
    await validateReceiptOnServer(transaction.receipt);
    showSuccess('Subscription activated!');
    unlockFeatures();

  } catch (error: any) {
    // Handle specific error cases
    if (error.code === 'USER_CANCELLED') {
      // User cancelled - don't show error
      console.log('Purchase cancelled by user');
    } else if (error.code === 'PAYMENT_PENDING') {
      showInfo('Payment is pending. Please check back later.');
    } else if (error.code === 'PRODUCT_ALREADY_PURCHASED') {
      // Restore instead
      await NativePurchases.restorePurchases();
    } else {
      // Show user-friendly error
      showError('Unable to complete purchase. Please try again.');
    }
  }
}

显示加载状态

function PurchaseButton({ productId }: { productId: string }) {
  const [loading, setLoading] = useState(false);

  const handlePurchase = async () => {
    setLoading(true);
    try {
      await NativePurchases.purchaseProduct({ productIdentifier: productId });
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={handlePurchase} disabled={loading}>
      {loading ? 'Processing...' : 'Subscribe Now'}
    </button>
  );
}

清晰显示条款

function SubscriptionTerms() {
  return (
    <div className="terms">
      <p>
        Subscription automatically renews unless cancelled at least 24 hours
        before the end of the current period.
      </p>
      <p>
        Your account will be charged for renewal within 24 hours prior to
        the end of the current period.
      </p>
      <p>
        Subscriptions may be managed by the user and auto-renewal may be
        turned off in Account Settings after purchase.
      </p>
      <p>
        <a href="/terms">Terms of Service</a> |
        <a href="/privacy">Privacy Policy</a>
      </p>
    </div>
  );
}

如果您的应用程序被拒绝

解决问题的步骤

1. 仔细阅读拒绝原因

   • 注意具体被引用指南（例如，3.1.1，5.1.1）
   • 准确理解苹果标记的内容

2. 彻底修复问题

   • 不要仅仅修复 - 修复根本原因
   • 测试修复方案
   • 记录您所做的更改

3. Respond in Resolution Center

   Thank you for your feedback. I have addressed the issue:
   
   Issue: Subscription pricing not clear upfront
   
   Fix: Added explicit pricing display on subscription selection
   screen showing "$9.99/month" before purchase button. Also added
   cancellation instructions on the same screen.
   
   The changes are in this submission and can be tested using the
   provided test account.

4. Resubmit promptly

   • Resubmissions are typically reviewed faster
   • Usually within 24 hours

Appeal Process

If you believe the rejection is incorrect:

1. Click “Appeal” in App Store Connect
2. Provide clear evidence:
   • Screenshots showing compliance
   • 具体指南的参考
   • 如何满足要求的说明
3. 保持专业和事实
4. 如果功能难以找到，请包含测试账户

额外资源

• Apple App Store 评审指南
• 内购指南
• 订阅最佳实践
• App Store Connect 帮助
• 截图规范
• 平台版本信息

支持

如果您仍然遇到问题：

• 查看 原生购买指南
• 检查 常见的故障排除问题
• 联系苹果开发者支持团队获取指南解释

需要专家帮助？

在应用程序审查中遇到困难或需要个人化帮助？ 与我们的团队预约一次咨询电话 专门支持:

• IAP实施评审和优化
• App Store评审准备和策略
• 提交清单评审
• 拒绝解决方案和申诉
• 我们的专家已经成功帮助了数百个应用程序通过审查!

继续从iOS App Store Review Guidelines for IAP

标题：继续从iOS App Store Review Guidelines for IAP

iOS App Store Review Guidelines for IAP iOS App Store Review Guidelines for IAP 为了获得商店的批准和分发，连接它到 使用 @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 中的原生能力，