在 React Native SDK 中进行应用内购买

在移动应用中展示付费墙，是向用户提供高级内容或服务访问权限的关键步骤。但只有当 Adapty 负责渲染页面时——即使用流程或旧版付费墙编辑工具构建的付费墙——展示付费墙本身才能直接支持购买操作。

如果页面由您自己的代码渲染，则需要单独调用 .makePurchase() 方法来完成购买并解锁相应内容。该方法是用户与付费墙交互、完成目标交易的入口。

如果您的付费墙为用户尝试购买的产品设置了有效的促销活动，Adapty 将在购买时自动应用该促销活动。

请确保已完成初始配置，每一步都不能跳过。否则我们将无法验证购买。

发起购买

try {
    const purchaseResult = await adapty.makePurchase(product);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // Grant access to the paid features
        }
        break;
      case 'user_cancelled':
        // Handle the case where the user canceled the purchase
        break;
      case 'pending':
        // Handle deferred purchases (e.g., the user will pay offline with cash)
        break;
    }
} catch (error) {
    // Handle the error
}

请求参数：

响应参数：

购买时变更订阅

当用户选择新订阅而非续订当前订阅时，具体行为取决于应用商店：

• 对于 App Store，订阅会在同一订阅组内自动更新。如果用户在已有某个组的订阅的情况下购买了另一个组的订阅，两个订阅将同时处于激活状态。
• 对于 Google Play，订阅不会自动更新。你需要按照以下说明在移动应用代码中手动处理切换逻辑。

要在 Android 上将订阅替换为另一个订阅，请调用 .makePurchase() 方法并传入额外参数：

try {
    const purchaseResult = await adapty.makePurchase(product, params);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // 授予付费功能访问权限
        }
        break;
      case 'user_cancelled':
        // 处理用户取消购买的情况
        break;
      case 'pending':
        // 处理延迟购买（例如，用户将以现金线下支付）
        break;
    }
} catch (error) {
    // 处理错误
}

额外请求参数：

makePurchase(product, {
    android: {
        subscriptionUpdateParams: {
            oldSubVendorProductId: 'old_product_id',
            prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
    }
});

如需了解更多关于订阅和替换模式的内容，请参阅 Google 开发者文档：

• 关于替换模式
• Google 对替换模式的建议
• 替换模式 CHARGE_PRORATED_PRICE。注意：此方法仅适用于订阅升级，不支持降级。
• 替换模式 DEFERRED。注意：实际的订阅变更仅在当前订阅计费周期结束时才会生效。

在 iOS 中兑换优惠码

要在应用中显示优惠码兑换页面：

adapty.presentCodeRedemptionSheet();

来自 App Store 的推广应用内购买

当用户从 App Store 产品页面发起购买，并且交易流转到你的应用时，SDK 会自动完成该购买——Apple 购买系统界面会立即弹出，Adapty 像处理其他购买一样处理该交易。这无需你编写任何代码。

如果推广产品附带订阅优惠，SDK 会在购买时自动应用该优惠。该优惠从 App Store 购买意图中读取，此功能仅在 iOS 18.0 及以上版本可用。在 iOS 16.4–17.x 上，购买将以原价进行。

如需自行接管购买完成流程（例如先展示自定义页面），请监听 'onPromotedPurchaseReceived' 事件，并将产品传入 makePromotedPurchase：

adapty.addEventListener('onPromotedPurchaseReceived', async product => {
  const result = await adapty.makePromotedPurchase(product);
  // process the purchase result
});

makePromotedPurchase 不接受任何购买参数——促销产品来自 App Store 而非付费墙，因此不携带任何付费墙上下文。它返回与 makePurchase 相同的 AdaptyPurchaseResult。

监听器是累加的：如果你注册了多个监听器，每个监听器都会收到该产品，但任何一个监听器都不会替其他监听器完成购买。

管理预付费计划（Android）

如果您的应用用户可以购买预付费计划（例如，购买数月的非续期订阅），您可以为预付费计划启用待处理交易。

adapty.activate("PUBLIC_SDK_KEY", {
    android: { pendingPrepaidPlansEnabled: true }
});