Восстановление покупок в мобильном приложении с Android SDK

Восстановление покупок — это функция, которая позволяет пользователям снова получить доступ к ранее приобретённому контенту (подпискам или встроенным покупкам) без повторного списания средств. Особенно она полезна тем, кто удалил и переустановил приложение или перешёл на новое устройство и хочет получить доступ к уже оплаченному контенту.

Note

В пейволах, созданных с помощью Paywall Builder, покупки восстанавливаются автоматически — никакого дополнительного кода не требуется. Если вы используете именно его, этот шаг можно пропустить.

Чтобы восстановить покупку без использования Paywall Builder для кастомизации пейвола, вызовите метод .restorePurchases():

Adapty.restorePurchases { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
                      
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
            // successful access restore
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.restorePurchases(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        
        if (profile != null) {
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");
            
            if (premium != null && premium.isActive()) {
                // successful access restore
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Параметры ответа:

Параметр Описание

Параметр	Описание
Profile	Объект `AdaptyProfile`. Эта модель содержит информацию об уровнях доступа, подписках и разовых покупках. Проверьте статус уровня доступа, чтобы определить, есть ли у пользователя доступ к приложению.

Profile

Объект AdaptyProfile. Эта модель содержит информацию об уровнях доступа, подписках и разовых покупках.

Проверьте статус уровня доступа, чтобы определить, есть ли у пользователя доступ к приложению.

Info

В Adapty Android SDK версии 4.0.2 и выше restorePurchases() завершается успешно даже если нечего восстанавливать: метод возвращает текущий профиль, поэтому проверяйте в нём статус уровня доступа. В более ранних версиях SDK метод в этом случае завершается с ошибкой NO_PURCHASES_TO_RESTORE.

Что можно восстановить

restorePurchases восстанавливает активные подписки и неиспользованные разовые покупки из Google Play.

В Adapty Android SDK 4.0.2 и выше, использующем Google Play Billing Library 8, Play Store больше не возвращает истёкшие подписки и использованные разовые покупки. Чтобы пользователи могли восстановить их на другом устройстве или после переустановки, идентифицируйте их с помощью Adapty.identify. В этом случае Adapty восстановит историю покупок из своего бэкенда, а не из стора.

Note

Google Play сообщает только об активных покупках, поэтому restorePurchases() не может найти подписки, которые истекли до интеграции Adapty. Чтобы добавить их в Adapty, импортируйте исторические данные.

Хотите увидеть реальный пример интеграции Adapty SDK в мобильное приложение? Посмотрите наши примеры приложений — они демонстрируют полную настройку: отображение пейволов, совершение покупок и другие базовые функции.