Realizar compras in-app en Android SDK

Mostrar paywalls en tu aplicación móvil es un paso esencial para ofrecer a los usuarios acceso a contenido o servicios premium. Sin embargo, simplemente mostrar estos paywalls solo es suficiente para gestionar compras si usas Paywall Builder para personalizarlos.

Si no usas el Paywall Builder, debes usar un método independiente llamado .makePurchase() para completar una compra y desbloquear el contenido deseado. Este método es la puerta de entrada para que los usuarios interactúen con los paywalls y procedan con sus transacciones. Si tu paywall tiene una oferta promocional activa para el producto que el usuario quiere comprar, Adapty la aplicará automáticamente en el momento de la compra.

Ten en cuenta que la oferta introductoria se aplicará automáticamente solo si utilizas paywalls configurados con el Paywall Builder. En otros casos, deberás verificar la elegibilidad del usuario para una oferta introductoria en iOS. Saltarte este paso puede provocar que tu app sea rechazada durante la revisión. Además, podría suponer cobrar el precio completo a usuarios que tienen derecho a una oferta introductoria.

Asegúrate de haber completado la configuración inicial sin saltarte ningún paso. Sin ella, no podemos validar las compras.

Realizar compra

¿Usas Paywall Builder? Las compras se procesan automáticamente; puedes saltarte este paso.

¿Buscas una guía paso a paso? Consulta la guía de inicio rápido para instrucciones de implementación completas con todo el contexto.

Adapty.makePurchase(activity, product, null) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            when (val purchaseResult = result.value) {
                is AdaptyPurchaseResult.Success -> {
                    val profile = purchaseResult.profile
                    if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
                        // Grant access to the paid features
                    }
                }

                is AdaptyPurchaseResult.UserCanceled -> {
                    // Handle the case where the user canceled the purchase
                }

                is AdaptyPurchaseResult.Pending -> {
                    // Handle deferred purchases (e.g., the user will pay offline with cash)
                }
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle the error
        }
    }
}

Adapty.makePurchase(activity, product, null, result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPurchaseResult purchaseResult = ((AdaptyResult.Success<AdaptyPurchaseResult>) result).getValue();

        if (purchaseResult instanceof AdaptyPurchaseResult.Success) {
            AdaptyProfile profile = ((AdaptyPurchaseResult.Success) purchaseResult).getProfile();
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");

            if (premium != null && premium.isActive()) {
                // Grant access to the paid features
            }
        } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
            // Handle the case where the user canceled the purchase
        } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
            // Handle deferred purchases (e.g., the user will pay offline with cash)
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle the error
    }
});

Parámetros de la solicitud:

Parámetro	Presencia	Descripción
Product	obligatorio	Un objeto `AdaptyPaywallProduct` obtenido del paywall.

Parámetros de la respuesta:

Parámetro	Descripción
Profile	Si la solicitud se ha completado correctamente, la respuesta contiene este objeto. Un objeto AdaptyProfile proporciona información completa sobre los niveles de acceso, suscripciones y compras únicas de un usuario dentro de la app. Comprueba el estado del nivel de acceso para determinar si el usuario tiene el acceso requerido a la app.

Parámetro

Descripción

Profile

Si la solicitud se ha completado correctamente, la respuesta contiene este objeto. Un objeto AdaptyProfile proporciona información completa sobre los niveles de acceso, suscripciones y compras únicas de un usuario dentro de la app.

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

Nota: si todavía usas una versión de StoreKit de Apple inferior a v2.0 y una versión del SDK de Adapty inferior a v2.9.0, debes proporcionar el secreto compartido de Apple App Store en su lugar. Apple ha declarado este método como obsoleto.

Cambiar suscripción al realizar una compra

Cuando un usuario elige una nueva suscripción en lugar de renovar la actual, el funcionamiento depende del store. En Google Play, la suscripción no se actualiza automáticamente: tienes que gestionar el cambio en el código de tu app como se describe a continuación.

Para reemplazar la suscripción por otra en Android, llama al método .makePurchase() con el parámetro adicional:

Adapty.makePurchase(
    activity, 
    product, 
    AdaptyPurchaseParameters.Builder()
        .withSubscriptionUpdateParams(subscriptionUpdateParams)
        .build()
) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            when (val purchaseResult = result.value) {
                is AdaptyPurchaseResult.Success -> {
                    val profile = purchaseResult.profile

                    // successful cross-grade
                }

                is AdaptyPurchaseResult.UserCanceled -> {
                    // user canceled the purchase flow
                }

                is AdaptyPurchaseResult.Pending -> {
                    // the purchase has not been finished yet, e.g. user will pay offline by cash
                }
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle the error
        }
    }
}

Parámetro de solicitud adicional:

Parámetro	Presencia	Descripción
subscriptionUpdateParams	obligatorio	un objeto `AdaptySubscriptionUpdateParameters`.

Adapty.makePurchase(
    activity, 
    product, 
    new AdaptyPurchaseParameters.Builder()
        .withSubscriptionUpdateParams(subscriptionUpdateParams)
        .build(),
    result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPurchaseResult purchaseResult = ((AdaptyResult.Success<AdaptyPurchaseResult>) result).getValue();

        if (purchaseResult instanceof AdaptyPurchaseResult.Success) {
            AdaptyProfile profile = ((AdaptyPurchaseResult.Success) purchaseResult).getProfile();

            // successful cross-grade
        } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
            // user canceled the purchase flow
        } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
            // the purchase has not been finished yet, e.g. user will pay offline by cash
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle the error
    }
});

Parámetro de solicitud adicional:

Parámetro	Presencia	Descripción
subscriptionUpdateParams	obligatorio	un objeto `AdaptySubscriptionUpdateParameters`.

Puedes leer más sobre las suscripciones y los modos de reemplazo en la documentación para desarrolladores de Google:

Acerca de los modos de reemplazo
Recomendaciones de Google para los modos de reemplazo
Modo de reemplazo CHARGE_PRORATED_PRICE. Nota: este método solo está disponible para actualizaciones de suscripción. No se admiten degradaciones.
Modo de reemplazo DEFERRED. Nota: el cambio real de suscripción solo se producirá cuando finalice el período de facturación actual.

Gestionar planes prepago

Si los usuarios de tu app pueden adquirir planes prepago (por ejemplo, comprar una suscripción no renovable por varios meses), puedes habilitar las transacciones pendientes para planes prepago.


AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withEnablePendingPrepaidPlans(true)
    .build()


new AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withEnablePendingPrepaidPlans(true)
    .build();