RevenueCat: configurar una suscripción in-app en iOS

Por qué usar RevenueCat en lugar de StoreKit solo

StoreKit, el framework de Apple, te permite vender una suscripción sin ningún servicio externo. Pero para un principiante, escribir uno mismo toda la lógica de compra, restauración y verificación de accesos significa mucho código que mantener, con casos límite fáciles de olvidar: cambio de dispositivo, vencimiento, reembolso.

RevenueCat se ubica entre App Store Connect y tu app: lee tus productos, gestiona las suscripciones activas y te ahorra escribir esa capa tú mismo. Sigues controlando el precio y las ofertas desde un panel, sin volver a publicar tu app con cada cambio.

Paso 1: crear tus productos en App Store Connect

Antes de RevenueCat, los productos tienen que existir del lado de Apple. En App Store Connect, crea un grupo de suscripciones y luego uno o varios niveles con su duración, por ejemplo mensual o anual, y su precio por territorio. Completa también los textos que verá el usuario en cada nivel: Apple los pide antes de aceptar el producto en revisión.

Un olvido frecuente en este punto: un producto creado pero nunca enviado a la primera revisión de la app junto con su versión asociada. Un producto pendiente que nunca se incluyó en un envío de la app sigue invisible para tus usuarios, aunque RevenueCat ya lo vea.

Paso 2: conectar RevenueCat con tu app

En RevenueCat creas un proyecto, vinculas tu clave de API de App Store Connect para que RevenueCat sincronice tus productos automáticamente y luego defines los "entitlements", es decir, los derechos de acceso. Un entitlement representa lo que desbloquea la suscripción, por ejemplo el acceso completo a la app, sin importar qué producto exacto lo activó.

Esta capa intermedia es útil: si más adelante cambias la estructura de tus ofertas, por ejemplo al agregar un nivel anual, simplemente vinculas el nuevo producto al mismo entitlement, sin tocar el código que verifica el acceso en tu app.

Del lado de la app, el SDK de RevenueCat para React Native se instala en un proyecto Expo con un plugin dedicado y ofrece una función sencilla para saber si el usuario actual tiene un entitlement activo.

Paso 3: construir tu paywall

El paywall es la pantalla que presenta la oferta y lanza la compra. RevenueCat ofrece paywalls configurables desde el panel, que puedes modificar sin volver a publicar la app, o puedes construir el tuyo con el SDK si quieres control total sobre el diseño.

La ubicación importa tanto como el diseño. Un paywall que aparece antes de que la persona haya visto el valor de la app suele convertir peor que uno colocado justo después de una primera acción exitosa. La guía de errores de paywall en iOS para principiantes detalla las trampas más comunes en esta etapa, más allá de la simple integración técnica.

Paso 4: probar la compra, la restauración y el vencimiento

Es el paso que más se hace a la ligera, y sin embargo el que más revisa Apple. Tres escenarios tienen que funcionar antes del envío:

La compra. Con una cuenta de prueba sandbox, la compra debe desbloquear el entitlement de inmediato, y tu app debe reaccionar a ese cambio sin necesidad de reiniciarla.

La restauración. En un dispositivo nuevo o después de reinstalar, con la misma cuenta de Apple, un botón "Restaurar compras" debe recuperar la suscripción activa. Apple revisa sistemáticamente este flujo, y su ausencia o mal funcionamiento es un motivo de rechazo frecuente bajo la guideline 3.1.1.

El vencimiento. En el entorno sandbox, las suscripciones vencen en unos minutos en lugar de varios meses, lo que te permite verificar que el acceso se cierra correctamente al terminar el periodo, sin esperar un ciclo de facturación real.

Lo que RevenueCat no reemplaza

RevenueCat gestiona la mecánica de compra, no el cumplimiento de tu ficha ni de tu paywall respecto a la guideline 3.1.2. Sigue siendo tu responsabilidad describir correctamente la suscripción en tu descripción de la App Store, indicar su precio exacto y su duración, y completar tus términos de uso. La página suscripción o compra única en iOS te ayuda a elegir el modelo correcto antes incluso de llegar a esta etapa técnica.

Además, RevenueCat cobra una comisión sobre los ingresos a partir de cierto umbral mensual, que se suma a la comisión de Apple sobre las suscripciones vendidas en la app. Revisa los niveles actuales en su propio sitio antes de construir tu modelo de negocio en torno a estas dos comisiones.

Los errores más frecuentes de un principiante

Olvidar el estado de carga. Al iniciar, RevenueCat necesita un instante para obtener los accesos del usuario. Si tu app muestra el contenido de pago por defecto antes de esa respuesta, un usuario sin suscripción puede ver por un momento contenido que no pagó. Prevé un estado de carga explícito en lugar de una visualización optimista por defecto.

Verificar los accesos en el lugar equivocado. Un entitlement activo debe volver a verificarse cada vez que se abre una pantalla de pago, no solo una vez al inicio. Si el usuario cancela o su suscripción vence mientras usa la app, la siguiente pantalla debe reflejar ese cambio.

Confundir sandbox y producción. Los identificadores de producto y las cuentas de prueba sandbox son distintos de los de producción. Una prueba que funciona en sandbox con la cuenta de Apple equivocada, o un producto creado solo en producción, puede dar la falsa impresión de que todo está listo.

Una app verificada, no solo una app que compila

Una suscripción que "funciona" en una prueba rápida con tu propia cuenta no garantiza que sobreviva a una restauración en otro dispositivo o a un vencimiento real. Eso es exactamente lo que revisa un reviewer de Apple. La página suscripción in-app en iOS detalla toda esta cadena, desde la creación de los productos hasta la verificación final.

Si quieres partir de una base donde el paywall y las suscripciones ya están en el código, eso es lo que incluye el código inicial del iOS Kit. Para verificar tu suscripción como lo hará el reviewer, el Apple Review Kit reúne mi checklist previa al envío y las notas que debes dejar al revisor para la compra integrada.

Preguntas frecuentes

¿Cómo configurar una suscripción con RevenueCat en iOS?

En cuatro pasos. Primero crea tus productos en App Store Connect. Luego conecta RevenueCat con tu clave de API de App Store Connect y define tus entitlements (los derechos de acceso), y después construye el paywall. Termina probando la compra, la restauración y el vencimiento: es el paso que suele hacerse a la ligera, y sin embargo Apple lo revisa.

¿RevenueCat es obligatorio para vender una suscripción en iOS?

No. StoreKit, el framework de Apple, permite vender una suscripción sin un servicio externo. Pero en ese caso escribes toda la lógica de compra, restauración y verificación de accesos, con casos límite fáciles de olvidar: cambio de dispositivo, vencimiento, reembolso. RevenueCat se ubica entre App Store Connect y tu app para ahorrarte esa capa.

¿Qué es un entitlement en RevenueCat?

Un entitlement es un derecho de acceso: representa lo que desbloquea la suscripción, por ejemplo el acceso completo a la app, sin importar qué producto exacto lo activó. Si más adelante agregas un nivel anual, simplemente vinculas el nuevo producto al mismo entitlement. El código que verifica el acceso en tu app no tiene que cambiar.

¿Cómo probar una suscripción de RevenueCat antes de enviarla a Apple?

Tres escenarios tienen que funcionar antes del envío. Compra: con una cuenta de prueba sandbox, el acceso se desbloquea de inmediato, sin reiniciar la app. Restauración: en un dispositivo nuevo o después de reinstalar, con la misma cuenta de Apple, el botón de restauración recupera la suscripción activa. Vencimiento: en sandbox, las suscripciones vencen en unos minutos, lo que te permite verificar que el acceso se cierra.

¿Por qué un producto visible en RevenueCat sigue invisible para los usuarios?

A menudo porque el producto nunca se incluyó en un envío de la app. Un producto creado en App Store Connect pero nunca enviado a la primera revisión junto con su versión asociada sigue invisible para tus usuarios, aunque RevenueCat ya lo vea. Es un olvido frecuente en la etapa de creación de los productos.

¿RevenueCat cobra una comisión sobre las suscripciones?

RevenueCat cobra una comisión sobre los ingresos a partir de cierto umbral mensual. Se suma a la de Apple sobre las suscripciones vendidas en la app. Revisa los niveles actuales en el sitio de RevenueCat antes de construir tu modelo de negocio en torno a estas dos comisiones.