Realizar compras in-app en React Native 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, presentar un paywall solo gestiona las compras por sí solo cuando Adapty renderiza la pantalla — es decir, un flow, o un paywall del antiguo Paywall Builder.

Si renderizas la pantalla en tu propio código, debes usar un método separado 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 un usuario intenta comprar, Adapty la aplicará automáticamente en el momento de la compra.

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

Realizar una compra

try {
    const purchaseResult = await adapty.makePurchase(product);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // Grant access to the paid features
        }
        break;
      case 'user_cancelled':
        // Handle the case where the user canceled the purchase
        break;
      case 'pending':
        // Handle deferred purchases (e.g., the user will pay offline with cash)
        break;
    }
} catch (error) {
    // Handle the error
}

Parámetros de respuesta:

Cambiar de suscripción al realizar una compra

Cuando un usuario opta por una nueva suscripción en lugar de renovar la actual, el funcionamiento depende del store:

• En el App Store, la suscripción se actualiza automáticamente dentro del grupo de suscripciones. Si un usuario adquiere una suscripción de un grupo mientras ya tiene activa otra de un grupo diferente, ambas suscripciones estarán activas al mismo tiempo.
• En Google Play, la suscripción no se actualiza automáticamente. Debes gestionar el cambio en el código de tu app como se describe a continuación.

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

try {
    const purchaseResult = await adapty.makePurchase(product, params);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // Grant access to the paid features
        }
        break;
      case 'user_cancelled':
        // Handle the case where the user canceled the purchase
        break;
      case 'pending':
        // Handle deferred purchases (e.g., the user will pay offline with cash)
        break;
    }
} catch (error) {
    // Handle the error
}

Parámetro de solicitud adicional:

makePurchase(product, {
    android: {
        subscriptionUpdateParams: {
            oldSubVendorProductId: 'old_product_id',
            prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
    }
});

Puedes leer más sobre suscripciones y 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 cambios a un plan inferior.
• 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 hoja de canje de códigos en tu app:

adapty.presentCodeRedemptionSheet();

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 se transfiere a tu app, el SDK la completa automáticamente: la pantalla de compra de Apple aparece de inmediato y Adapty procesa la transacción como cualquier otra compra. Esto no requiere ningún código de tu parte.

Si el producto promocionado incluye una oferta de suscripción, el SDK la aplica automáticamente en la compra. La oferta se lee del 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 procesa al precio base.

Para gestionar la finalización tú mismo — por ejemplo, para mostrar primero tu propia pantalla — escucha el evento 'onPromotedPurchaseReceived' y pasa el producto a makePromotedPurchase:

adapty.addEventListener('onPromotedPurchaseReceived', async product => {
  const result = await adapty.makePromotedPurchase(product);
  // process the purchase result
});

makePromotedPurchase no recibe 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.

Los listeners son aditivos: si registras varios, cada uno recibe el producto, y ninguno completa la compra por los demás.

Gestionar planes prepagos (Android)

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

adapty.activate("PUBLIC_SDK_KEY", {
    android: { pendingPrepaidPlansEnabled: true }
});