Realizar compras en la aplicación móvil con el SDK de Capacitor

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, en un flow o en 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 el usuario quiere 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

try {
  const result = await adapty.makePurchase({ product });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('User is now subscribed!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

Parámetros de respuesta:

Cambiar de 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 el App Store, la suscripción se actualiza automáticamente dentro del grupo de suscripciones. Si un usuario compra una suscripción de un grupo mientras ya tiene una suscripción de otro, ambas suscripciones estarán activas al mismo tiempo.
• En Google Play, la suscripción no se actualiza automáticamente. Deberás gestionar el cambio en el código de tu aplicación tal 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 result = await adapty.makePurchase({ 
    product,
    params: {
      android: {
        subscriptionUpdateParams: {
          oldSubVendorProductId: 'old_product_id',
          prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
      }
    }
  });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('Subscription updated successfully!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

Parámetro de solicitud adicional:

La estructura MakePurchaseParamsInput incluye:

{
  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:

• Sobre 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 las reducciones.
• Modo de reemplazo DEFERRED. Nota: el cambio de suscripción efectivo solo se producirá cuando finalice el período de facturación actual.

Gestionar planes prepagos (Android)

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

await adapty.activate({
  apiKey: 'YOUR_PUBLIC_SDK_KEY',
  params: {
    android: {
        pendingPrepaidPlansEnabled: true,
    },
  }
});

Canjear códigos de oferta en iOS

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

try {
  await adapty.presentCodeRedemptionSheet();
} catch (error) {
  console.error('Failed to present code redemption sheet:', error);
}

Compras in-app promocionadas desde el App Store

Cuando un usuario inicia una compra desde la página de tu producto en App Store y la transacción se transfiere a tu app, el SDK la completa automáticamente: la pantalla del sistema de compras 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 el momento de la compra. La oferta se lee desde el intent de compra de 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.

Para gestionar tú mismo el proceso de compra —por ejemplo, para mostrar primero tu propia pantalla— escucha el evento 'onPromotedPurchaseReceived' y pasa el producto a makePromotedPurchase:

const listener = await adapty.addListener('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 en lugar de un paywall, por lo que no tiene contexto de paywall. Devuelve el mismo AdaptyPurchaseResult que makePurchase.

Llamar a adapty.removeAllListeners() elimina el listener de compras promocionadas junto con el resto, y la finalización automática del SDK retoma su lugar. Vuelve a registrar el listener si tu aplicación sigue siendo responsable de la finalización.