Совершение покупок в мобильном приложении с помощью React Native SDK

Отображение пейволов в вашем мобильном приложении — важный шаг к предоставлению пользователям доступа к премиум-контенту и сервисам. Однако само по себе отображение пейвола поддерживает покупки только тогда, когда Adapty отрисовывает экран — то есть это флоу или пейвол из старого Paywall Builder.

Если вы отрисовываете экран в собственном коде, для совершения покупки и открытия нужного контента необходимо использовать отдельный метод .makePurchase(). Именно через него пользователи взаимодействуют с пейволами и выполняют нужные транзакции.

Если на вашем пейволе есть активный promotional offer для продукта, который пользователь собирается купить, 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) {
          // 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
}

Дополнительный параметр запроса:

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, а не с пейвола, поэтому он не содержит контекста пейвола. Метод возвращает тот же AdaptyPurchaseResult, что и makePurchase.

Слушатели аддитивны: если зарегистрировать несколько, каждый из них получает продукт, но ни один из них не завершает покупку за остальных.

Управление предоплаченными планами (Android)

Если пользователи вашего приложения могут приобретать предоплаченные планы (например, купить невозобновляемую подписку на несколько месяцев), вы можете включить отложенные транзакции для таких планов.

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