Clase 03 · Módulo 11
Compras dentro de la app con RevenueCat
Compras dentro de la app con RevenueCat
Qué logras en esta clase
Entenderás cómo funciona una compra dentro de la app y podrás dirigir a Claude Code para integrarla con RevenueCat.
- Qué resuelve RevenueCat y qué no.
- Productos, derechos de acceso, ofertas y paquetes.
- El recorrido de una compra, paso a paso.
- Cómo decide tu app qué desbloquear.
02
El problema: dos tiendas, dos sistemas
Apple y Google tienen cada una su propio sistema de compras, con reglas, formatos y avisos distintos.
Para cobrar bien necesitas, en ambas:
- Mostrar productos y precios.
- Iniciar la compra y validarla.
- Saber si una suscripción sigue activa, se canceló o falló el cobro.
Hacerlo directo es posible, pero es mucho código delicado.
03
Qué es RevenueCat
Es un servicio que envuelve las compras de Apple y de Google con un solo SDK (paquete de código que agregas a tu app) y lleva el estado de cada cliente en sus servidores.
Tu app le pregunta a RevenueCat «¿esta persona tiene acceso?» y recibe la misma respuesta en iPhone y en Android.
04
Lo bueno y lo malo
| A favor | En contra |
|---|---|
| Un solo código para dos tiendas | Dependes de un tercero más |
| Lleva renovaciones y vencimientos | Cobra 1 % sobre 2.500 USD mensuales |
| Panel para ver clientes y compras | Hay que aprender su vocabulario |
La alternativa es usar las librerías de cada tienda y validar tú en el servidor. Conviene solo con equipo y experiencia.
05
RevenueCat no reemplaza a las tiendas
El dinero lo cobran Apple y Google, y ellas te pagan. RevenueCat solo ordena la información de quién compró qué.
06
Las cuatro palabras del vocabulario
| Término | Qué es |
|---|---|
| Producto | Lo que se vende en la tienda, con precio |
| Derecho de acceso (entitlement) | Lo que el usuario puede hacer |
| Oferta (offering) | El conjunto de productos que muestras |
| Paquete (package) | Un producto dentro de la oferta |
Las cuatro se configuran en el panel de RevenueCat. Las siguientes láminas las explican una por una.
07
Producto: lo que existe en la tienda
Un producto se crea en App Store Connect y en Play Console (clase 4): por ejemplo, «plan mensual» y «plan anual».
Cada tienda tiene el suyo, con su identificador y su precio. En RevenueCat registras ambos para que sepa que representan lo mismo.
08
Derecho de acceso: lo que tu app consulta
Un derecho de acceso es un nivel de permiso, como premium.
Asocias uno o varios productos a ese derecho. El plan mensual y el anual, de Apple y de Google, pueden dar todos el mismo derecho premium.
09
Oferta y paquetes: lo que muestras
Una oferta agrupa los paquetes que aparecen en tu pantalla de venta. Cada paquete apunta al producto equivalente de cada tienda.
La app pide «la oferta actual» y dibuja lo que venga. Si mañana cambias los planes en el panel, la pantalla cambia sin publicar una versión nueva.
10
Cómo se conectan las piezas
La oferta sirve para vender. El derecho de acceso sirve para desbloquear. Son caminos separados.
11
Preguntas por el derecho, no por el producto
El producto es un detalle de la tienda. Tu app solo necesita saber si el derecho de acceso está activo.
12
Qué se instala
La guía oficial para Expo indica instalar con npx expo install:
react-native-purchases: el SDK principal.react-native-purchases-ui: opcional, trae pantallas de venta ya armadas.expo-dev-client: para el development build.
Después de instalar hay que generar un build nuevo. Sin eso aparecen errores de módulo nativo al abrir la app.
13
Expo Go no sirve para comprar
El SDK incluye código nativo. En Expo Go funciona en un modo de vista previa que simula las llamadas: puedes ver la pantalla, pero no comprar.
Las compras reales exigen un development build (módulo 3, clase 5).
14
Las claves de RevenueCat
En el panel, cada app de tu proyecto (la de iOS y la de Android) tiene su propia clave pública de API.
- Son claves públicas: están pensadas para ir dentro de la app.
- Se elige una u otra según la plataforma en que corre.
- Las claves secretas de RevenueCat, usadas desde un servidor, nunca van en la app.
15
Configurar al arrancar
El SDK se inicia una sola vez, al abrir la app, con Purchases.configure y la clave de la plataforma.
const apiKey = Platform.OS === 'ios' ? CLAVE_IOS : CLAVE_ANDROID;
Purchases.configure({ apiKey });Es un fragmento ilustrativo. Los nombres exactos de cada función se confirman en la documentación de RevenueCat, que Claude Code puede leer.
16
A quién pertenece la compra
RevenueCat identifica a cada cliente con un identificador de usuario.
- Si no le das uno, crea uno anónimo ligado a ese teléfono.
- Si tu app tiene cuentas, le pasas el identificador del usuario de Supabase al iniciar sesión.
17
El recorrido de una compra
- La app pide la oferta actual a RevenueCat.
- Muestra los paquetes con el precio que entrega la tienda.
- El usuario elige uno y la app inicia la compra.
- Aparece la hoja de pago del sistema: la tienda cobra.
- RevenueCat valida la compra y devuelve la información del cliente.
- La app revisa el derecho de acceso y desbloquea.
18
Quién hace qué en ese recorrido
Tu app nunca ve la tarjeta del usuario ni maneja el cobro. Solo muestra, inicia y consulta.
19
Consultar el acceso
La información del cliente trae sus derechos activos. La guía oficial lo muestra con Purchases.getCustomerInfo().
const info = await Purchases.getCustomerInfo();
const esPremium = info.entitlements.active['premium'] !== undefined;Se consulta al abrir la app y antes de mostrar algo de pago. El SDK mantiene una copia local de la última respuesta; su documentación explica cuánto dura.
20
La pantalla de venta
Puedes construirla tú con los datos de la oferta o usar las pantallas del paquete de interfaz de RevenueCat.
Toda pantalla de venta necesita:
- Precio y período tal como los entrega la tienda.
- Qué incluye el plan.
- Botón para restaurar compras.
- Enlaces a términos y política de privacidad.
No escribas el precio a mano: cambia por país.
21
Restaurar compras es obligatorio
Apple exige una forma de recuperar lo comprado (pauta 3.1.1).
Un botón «Restaurar compras» le pide a RevenueCat revisar las compras de la cuenta de la tienda y reactivar los derechos.
22
Cuando la compra no termina
No toda compra iniciada termina en pago.
| Situación | Qué hace la app |
|---|---|
| El usuario cierra la hoja de pago | Nada: no es un error |
| Pago pendiente de aprobación | Avisa que se activará al confirmarse |
| Falla de red o de tienda | Mensaje claro y opción de reintentar |
Pídele a Claude que trate la cancelación del usuario aparte de los errores reales.
23
La app no es la fuente de verdad
Lo que la app ve sirve para mostrar u ocultar pantallas. Lo que cuesta dinero se valida en el servidor.
Si una función de pago gasta recursos tuyos, como llamadas de IA, la Edge Function debe comprobar el acceso por su cuenta. Eso se resuelve en la clase 6.
24
Cómo trabajarlo con Claude Code
- Pídele leer la guía oficial de RevenueCat para Expo antes de escribir código.
- Dale los nombres de tus derechos de acceso y de tu oferta.
- Pide un cambio por vez: configurar, pantalla de venta, restaurar, bloqueo de funciones.
- Prueba cada uno en el development build.
25
Lo que te llevas
- RevenueCat unifica las compras de Apple y Google; el dinero lo siguen cobrando las tiendas.
- Producto se vende, oferta se muestra, derecho de acceso se consulta.
- Las compras reales necesitan development build, no Expo Go.
- El identificador de RevenueCat debe ser el de tu usuario.
- Restaurar compras y manejar cancelaciones no son opcionales.
26
Hazlo ahora
En 10 minutos, en papel o en tu especificación:
- Nombra tu derecho de acceso (por ejemplo,
premium). - Lista qué funciones exactas desbloquea.
- Define los paquetes de tu oferta: cuáles planes y con qué período.
- Anota qué pantalla lleva a la pantalla de venta y dónde va «Restaurar compras».
Con eso, la configuración del panel de la clase 4 es mecánica.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026