Realizar compras in-app en una aplicación móvil con el SDK de Kotlin Multiplatform

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, presentar un paywall solo gestiona las compras de forma autónoma cuando Adapty renderiza la pantalla — es decir, un flow, o un paywall del antiguo Paywall Builder.

Si renderizas la pantalla con tu propio código, 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 lleven a cabo sus transacciones.

Si tu paywall tiene una oferta promocional activa para el producto que un usuario intenta comprar, Adapty la aplicará automáticamente en el momento de la compra.

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

Realizar una compra

Adapty.makePurchase(product = product).onSuccess { purchaseResult ->
    when (purchaseResult) {
        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)
        }
    }
}.onError { error ->
    // Handle the error
}

Parámetros de respuesta:

Cambiar la 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. Tendrás que gestionar el cambio en el código de tu aplicación móvil 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:

val subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    oldSubVendorProductId = "old_subscription_product_id",
    replacementMode = AdaptyAndroidSubscriptionUpdateReplacementMode.CHARGE_FULL_PRICE
)

val purchaseParams = AdaptyPurchaseParameters.Builder()
    .setSubscriptionUpdateParams(subscriptionUpdateParams)
    .build()

Adapty.makePurchase(
    product = product,
    parameters = purchaseParams
).onSuccess { purchaseResult ->
    when (purchaseResult) {
        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
        }
    }
}.onError { error ->
    // Handle the error
}

Parámetro de solicitud adicional:

Puedes leer más sobre suscripciones y modos de reemplazo en la documentación de Google Developer:

• 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 cambios a planes inferiores.
• Modo de reemplazo DEFERRED. Nota: el cambio de suscripción real solo se producirá cuando finalice el período de facturación de la suscripción actual.

Canjear códigos de oferta en iOS

Para mostrar la pantalla de canje de códigos en tu app:

Adapty.presentCodeRedemptionSheet()
    .onSuccess {
        // code redemption sheet presented successfully
    }
    .onError { error ->
        // handle the error
    }

Gestionar planes prepago (Android)

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

Adapty.activate(
    AdaptyConfig.Builder("PUBLIC_SDK_KEY")
        .withGoogleEnablePendingPrepaidPlans(true)
        .build()
).onSuccess {
    // successful activation
}.onError { error ->
    // handle the error
}

Compras in-app promocionadas desde la App Store

Cuando un usuario inicia una compra desde la página de tu producto en la App Store y la transacción llega a tu app, el SDK te entrega el producto a través de un OnPromotedPurchaseListener. Completar la compra depende de tu app: pasa el producto a makePromotedPurchase. Como tú controlas cuándo ocurre esto, puedes mostrar tu propia pantalla antes de que comience la compra.

Para admitir compras promocionadas, registra el listener y completa la compra desde él:

Adapty.setOnPromotedPurchaseListener(OnPromotedPurchaseListener { product ->
    scope.launch {
        Adapty.makePromotedPurchase(product)
            .onSuccess { result -> /* process the purchase result */ }
            .onError { error -> /* handle the error */ }
    }
})

Registra el listener al iniciar la app, justo después de Adapty.activate. Una compra promocionada normalmente lanza la app en frío, por lo que suele llegar al SDK antes de que tu registro se ejecute. El SDK retiene una de estas compras y la entrega en cuanto te registras, conservando solo la más reciente, y escribe una advertencia en la consola cada vez que retiene una compra.

Si el producto promocionado incluye una oferta de suscripción, el SDK la aplica automáticamente en el momento de la compra. La oferta se lee desde el intent de compra del App Store, que la expone en iOS 18.0 y versiones posteriores. En iOS 16.4–17.x, la compra se realiza al precio base.

makePromotedPurchase no acepta parámetros de compra — un producto promocionado proviene del App Store y no de un paywall, por lo que no lleva contexto de paywall. Devuelve el mismo AdaptyPurchaseResult que makePurchase.

AdaptyPromotedProduct incluye vendorProductId, localizedTitle, localizedDescription, price, regionCode, isFamilyShareable y una subscription de tipo AdaptyProductSubscription.