Restaurar compras en la app para Android 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 cobre de nuevo. Esta función es especialmente útil para quienes han desinstalado y reinstalado la app, o han cambiado de dispositivo, y quieren acceder a su contenido ya comprado sin volver a pagar.

Note

Si construiste la pantalla con un builder, no necesitas restaurar las compras manualmente. Conecta su control de restauración — la acción Restore purchases en el Flow & Paywall Builder, o un enlace o botón de restauración en el antiguo — y el SDK completa la restauración.

Si construiste la pantalla tú mismo, 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

A partir del SDK de Adapty para Android 3.17.3 y 4.0.2, 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 suscripciones activas y compras únicas no consumidas de Google Play.

A partir del SDK de Adapty para Android 3.17.3 y 4.0.2, que utilizan Google Play Billing Library 8, el Play Store ya no devuelve suscripciones caducadas ni compras únicas consumidas. Para permitir que los usuarios recuperen esas compras en otros dispositivos y reinstalaciones, identifícalos con Adapty.identify. Adapty entonces restaura el historial de compras desde su backend en lugar de 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.

Tip

¿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.