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

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

Note

Если экран создан в билдере, вручную восстанавливать покупки не нужно. Подключите соответствующий элемент управления — действие Restore purchases во Flow & Paywall Builder или ссылку/кнопку восстановления в старом билдере — и SDK выполнит восстановление самостоятельно.

Если экран создан вручную, вызовите метод .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 3.17.3 и 4.0.2, restorePurchases() завершается успешно, даже если нечего восстанавливать: метод возвращает текущий профиль, поэтому проверяйте в нём статус уровня доступа. В более ранних версиях SDK метод в этом случае завершается с ошибкой NO_PURCHASES_TO_RESTORE.

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

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

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

Note

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

Tip

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