Реализация веб-пейволов

Прежде чем начать, убедитесь, что вы настроили веб-пейвол в дашборде и установили Adapty SDK версии 3.6.1 или выше.

Открытие веб-пейволов

Если вы работаете с пейволом, разработанным самостоятельно, для обработки веб-пейволов нужно использовать метод SDK. Метод .openWebPaywall:

Генерирует уникальный URL, позволяющий Adapty связать конкретный пейвол, показанный определённому пользователю, с веб-страницей, на которую он перенаправляется.
Отслеживает возвращение пользователей в приложение и затем запрашивает .getProfile с короткими интервалами, чтобы определить, были ли обновлены права доступа профиля.

Таким образом, если оплата прошла успешно и права доступа обновились, подписка активируется в приложении почти мгновенно.


try {
    await adapty.openWebPaywall(product);
} catch (error) {
    console.warn('Failed to open web paywall:', error);
}

Существует две версии метода openWebPaywall:

openWebPaywall(product) — генерирует URL по пейволу и добавляет в URL данные о продукте.
openWebPaywall(paywall) — генерирует URL по пейволу без добавления данных о продукте. Используйте его, если продукты в пейволе Adapty отличаются от продуктов в веб-пейволе.

Обработка ошибок

Ошибка	Описание	Рекомендуемые действия
AdaptyError.paywallWithoutPurchaseUrl	У пейвола не настроен URL для веб-покупки	Проверьте, правильно ли настроен пейвол в Adapty Dashboard
AdaptyError.productWithoutPurchaseUrl	У продукта отсутствует URL для веб-покупки	Проверьте конфигурацию продукта в Adapty Dashboard
AdaptyError.failedOpeningWebPaywallUrl	Не удалось открыть URL в браузере	Проверьте настройки устройства или предоставьте альтернативный способ оплаты
AdaptyError.failedDecodingWebPaywallUrl	Не удалось правильно закодировать параметры в URL	Убедитесь, что параметры URL корректны и правильно отформатированы

Открытие веб-пейволов во встроенном браузере

Открытие веб-пейволов во встроенном браузере поддерживается начиная с Adapty SDK v. 3.15.

По умолчанию веб-пейволы открываются во внешнем браузере.

Для более удобного пользовательского опыта можно открывать веб-пейволы во встроенном браузере. Это отображает страницу веб-покупки прямо в приложении, позволяя пользователям завершить транзакцию без переключения между приложениями.

Чтобы включить эту возможность, передайте WebPresentation.BrowserInApp вторым аргументом в openWebPaywall:


try {
    await adapty.openWebPaywall(
        product,
        WebPresentation.BrowserInApp, // default – WebPresentation.BrowserOutApp
    );
} catch (error) {
    console.warn('Failed to open web paywall:', error);
}