Restaurar compras en una app para Android con el SDK

Restaurar compras es una función que permite a los usuarios recuperar el acceso a contenido adquirido previamente, como suscripciones o compras in-app, sin que se les vuelva a cobrar. Esta función es especialmente útil para usuarios que han desinstalado y reinstalado la app o que han cambiado de dispositivo y quieren acceder a su contenido sin pagar de nuevo.

Note

En los paywalls creados con Paywall Builder, las compras se restauran automáticamente sin que tengas que añadir código adicional. Si es tu caso, puedes saltarte este paso.

Para restaurar una compra cuando no usas Paywall Builder para personalizar el paywall, llama al método .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
    }
});

Parámetros de respuesta:

Parámetro Descripción

Parámetro	Descripción
Profile	Un objeto `AdaptyProfile`. Este modelo contiene información sobre niveles de acceso, suscripciones y compras únicas. Comprueba el estado del nivel de acceso para determinar si el usuario tiene acceso a la app.

Profile

Un objeto AdaptyProfile. Este modelo contiene información sobre niveles de acceso, suscripciones y compras únicas.

Comprueba el estado del nivel de acceso para determinar si el usuario tiene acceso a la app.

Info

En Adapty Android SDK 4.0.2 y versiones posteriores, restorePurchases() se completa correctamente incluso cuando no hay nada que restaurar: devuelve el perfil actual, así que comprueba el estado del nivel de acceso en él. En versiones anteriores del SDK, el método falla con el error NO_PURCHASES_TO_RESTORE en este caso.

Qué se puede restaurar

restorePurchases recupera las suscripciones activas y las compras únicas no consumidas de Google Play.

En el SDK de Adapty para Android 4.0.2 y versiones posteriores, que usa Google Play Billing Library 8, Play Store ya no devuelve las suscripciones caducadas ni las compras únicas consumidas. Para que los usuarios puedan recuperarlas en otros dispositivos y tras reinstalaciones, identifícalos con Adapty.identify. Adapty restaurará entonces el historial de compras desde su backend en lugar de hacerlo desde el store.

Note

Google Play solo reporta las compras actualmente vigentes, por lo que restorePurchases() no puede encontrar suscripciones que expiraron antes de que integraras Adapty. Para añadirlas a Adapty, importa tus datos históricos.

¿Quieres ver un ejemplo real de cómo se integra el SDK de Adapty en una app móvil? Echa un vistazo a nuestras apps de ejemplo, que muestran la configuración completa, incluyendo la visualización de paywalls, la realización de compras y otras funcionalidades básicas.