Usar flows de Adapty con tu propio sistema de pagos

No necesitas mover tus compras a Adapty para usar sus flows. En el modo Observer, tu código sigue gestionando cada compra, mientras Adapty renderiza el paywall o el onboarding, decide quién lo ve, lo somete a pruebas A/B y registra los resultados.

Esta guía explica qué cambia, qué no cambia y qué requiere la configuración.

Tip

¿Nuevo en los flows? El Flow & Paywall Builder explica qué puedes crear antes de conectar todo esto.

Qué sigue siendo tuyo y qué gestiona Adapty

Tu código mantiene:

  • La llamada de compra
  • Finalizar y confirmar transacciones
  • Conceder y revocar accesos
  • Renovaciones y reintentos de facturación

Adapty gestiona:

Tu facturación no cambia en nada. Adapty renderiza el flow y pasa el toque de compra a tu código, que realiza el cargo.

Crea tus productos en Adapty

Omite esta sección si ninguna pantalla de tu flow muestra un precio o realiza una compra — un flow formado únicamente por pantallas de onboarding no necesita productos en Adapty.

En cuanto una pantalla presente productos, crea un producto en Adapty por cada suscripción o compra única que ofrezca. El flow lee el precio de la tarjeta a partir del producto, de modo que la tarjeta muestra el precio actual de la store, puedes hacer una prueba A/B con ese precio y Adapty agrupa los ingresos por producto en los análisis.

Un producto en Adapty apunta al producto del store que ya tienes a la venta, así que crearlo no activa ningún cobro: tu código sigue gestionando cada cargo. Cada producto tiene asociado un nivel de acceso y, en modo Observer, Adapty no lo concede — tu código sigue controlando el acceso — pero el producto necesita uno.

La CLI de Adapty crea productos sin abrir el dashboard. Instálala (Node.js 18 o posterior) e inicia sesión:

npm install -g adapty
adapty auth login

Obtén el ID de tu app y, a continuación, el nivel de acceso que quieres asociar — cada nueva app empieza con uno llamado premium:

adapty apps list
adapty access-levels list --app <app-id>

Luego crea un producto de Adapty por cada producto que vendas en el store, usando los IDs de producto de App Store Connect y Google Play Console:

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly --android-product-id com.example.monthly --android-base-plan-id monthly

Pasa --period lifetime para una compra única, y --stripe-product-id con --stripe-price-id (o el par de Paddle) para algo que vendas en la web. products create lista todos los flags. Los IDs de producto del store no se pueden cambiar tras la creación, así que si necesitas apuntar un producto a un store product diferente, tendrás que crear un producto nuevo.

Warning

Un elemento de producto sin nada asignado bloquea el guardado y la publicación, por lo que lo descubrirás en el constructor. Una acción de Purchase sin producto asignado se guarda correctamente pero falla en el dispositivo: el botón no hace nada. Asigna un producto a cada acción de Purchase.

O salta los productos y escribe los precios como texto estático

Un flow sin elemento de producto se guarda y publica correctamente, así que puedes escribir los precios en el texto y dejar que tu propio código decida qué compra un toque. Lo que te cuesta:

  • Mantienes el precio en dos sitios: el store y el texto del flow, y en cuanto cambias uno se desincroniza el otro.
  • Sin pruebas A/B de precio, que es precisamente para lo que sirve un flow.
  • Los gráficos e integraciones agrupan los ingresos con menos precisión, ya que Adapty solo conoce el producto a partir de la transacción que tú reportas.
  • Tu código mapea cada elemento pulsado a un producto en vez de recibirlo directamente del flow.

Configúralo

  1. Activa el SDK en modo Observer. Activa observerMode al configurar el SDK: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
  2. Crea tus productos en Adapty, salvo que el flow no muestre ningún precio. Un comando CLI por producto — consulta Crea tus productos en Adapty.
  3. Construye el flow. Consulta el Flow & Paywall Builder para las pantallas, configura las compras para los productos en una pantalla de paywall, y crea un placement para decidir dónde aparece el flow en tu app.
  4. Muestra el flow y realiza la compra en tu propio código. Adapty delega el tap de compra a un handler que tú registras.
  5. Registra la transacción con el ID de variante del paywall del producto comprado, para que la compra llegue a analíticas atribuida al paywall que la generó.

Los pasos 4 y 5 varían según la plataforma. En cada fragmento, flow es el AdaptyFlow que obtuviste para el placement, product es el AdaptyPaywallProduct que el usuario seleccionó, y myPurchaseApi o yourBillingClient representa el código de compra que ya tienes.

Límites del modo Observer

  • Adapty no concede acceso: No responde a los eventos de compra otorgando ni restringiendo acceso de pago, y no gestiona renovaciones ni reintentos de facturación. Tu propio código es el responsable de los niveles de acceso.
  • Tu código finaliza sus propias transacciones: Adapty no cierra ni confirma las compras que realiza tu código, así que cerrar cada una sigue siendo tu responsabilidad.
  • Reportar no es opcional: El variationId que pasas con un reporte es el único vínculo entre una compra y el flow que la generó. Reporta cada transacción, o las métricas de tu flow y los resultados de las pruebas A/B serán incorrectos.

Si ya usas otro proveedor

El modo observador solo requiere que tu código realice la compra, no qué SDK usa ese código. Los flows funcionan igual sobre RevenueCat, Superwall o Qonversion que sobre tu propio código de StoreKit o Billing Library.

Tres decisiones que tomar antes de publicar:

  • Un sistema finaliza cada transacción: Dos SDKs finalizando la misma compra es el error más habitual aquí.
  • Un sistema gestiona el acceso: Adapty no otorga nada en el modo Observer, así que mantén los niveles de acceso donde están.
  • Registra cada compra una sola vez: Registrar la misma transacción desde dos lugares distorsiona tus analíticas.

Para migrar completamente desde otro proveedor, consulta Migrar desde RevenueCat o Migrar desde Superwall.

Deja que Adapty gestione la compra

Tip

Aquí tu app compra a través de Adapty, por lo que el lado del código es una integración normal de Adapty. Sigue la guía de inicio rápido o Migra desde RevenueCat, o delégalo al skill de integración del SDK.

El modo Observer es la forma más rápida de empezar. Si quieres conservar los análisis de RevenueCat pero evitar las limitaciones del modo Observer, invierte los roles: Adapty funciona en modo completo y gestiona cada compra, mientras RevenueCat opera en su propio modo observer y registra las compras que realiza Adapty.

Adapty sabe entonces qué flow, placement y variante de prueba A/B generó cada cobro, y se encarga de conceder niveles de acceso y gestionar renovaciones, reintentos de facturación y reembolsos.

En el lado de RevenueCat, establece purchasesAreCompletedBy en tu app al configurar su SDK — .myApp en iOS, MY_APP en Android. El artículo Using the SDK with your own IAP code de RevenueCat incluye la configuración para cada plataforma, la versión de StoreKit que requiere iOS y la llamada syncPurchases() que importa las compras que un cliente ya realizó. Asigna el mismo ID de usuario a ambos SDKs — el customer user ID de Adapty y el appUserID de RevenueCat — o los dos dashboards mostrarán datos de personas distintas.

Warning

Este cambio convierte los niveles de acceso de Adapty en tu fuente de verdad, en lugar de los entitlements de RevenueCat. RevenueCat sigue observando y su dashboard sigue generando informes, pero ahora se entera de cada compra de forma indirecta y dentro de los límites que su propia documentación indica. Todo lo que hoy lee los entitlements de RevenueCat — tu app, tu backend, una versión web o de escritorio — debe migrarse a Adapty o leer una copia. Resuélvelo antes de publicar. El resto no cambia: la cuenta de RevenueCat, su historial y sus integraciones se quedan donde están.