Clase 06 · Módulo 11
Saber quién pagó desde tu servidor
Saber quién pagó desde tu servidor
Qué logras en esta clase
Tu base de datos sabrá, sin depender de la app, quién tiene acceso de pago y hasta cuándo.
- Recibir los avisos de RevenueCat en una Edge Function.
- Guardar el acceso en una tabla protegida.
- Tratar bien cancelaciones, fallas de cobro y reembolsos.
- Evitar duplicados y avisos falsos.
02
Por qué no basta con lo que ve la app
En la clase 3 la app consulta el derecho de acceso a RevenueCat. Eso alcanza para mostrar u ocultar pantallas.
No alcanza cuando:
- Una función de pago gasta dinero tuyo, como la IA.
- Hay datos que solo deben ver quienes pagan.
- Quieres avisar o actuar cuando alguien cancela.
En esos casos decide el servidor.
03
El servidor necesita su propia copia
Tus políticas RLS y tus Edge Functions no pueden preguntarle a la app. Necesitan el acceso escrito en tu base de datos.
04
Cómo se entera tu servidor
RevenueCat llama a tu webhook cada vez que algo cambia: una compra, una renovación, una cancelación. Tu función actualiza una tabla, y el resto del servidor lee esa tabla.
05
Antes de empezar: revisa tu plan
La documentación de webhooks de RevenueCat indica que la función requiere un plan determinado. Comprueba en su página de precios que tu plan la incluye; el tramo sin costo llega hasta 2.500 USD mensuales registrados, al 18-11-2026.
El webhook se registra en el panel de RevenueCat, en la sección de integraciones, con la dirección HTTPS de tu Edge Function.
06
La tabla de accesos
Una tabla mínima en Supabase:
| Columna | Para qué |
|---|---|
usuario_id | A quién pertenece |
derecho | Por ejemplo, premium |
vence_el | Hasta cuándo dura |
estado | Activo, en problema de cobro, terminado |
RLS: cada usuario puede leer solo su fila y nadie puede escribir desde la app. Solo escribe la Edge Function, con privilegios de servidor.
07
El aviso trae lo que necesitas
Cada evento de RevenueCat incluye, entre otros campos:
app_user_id: el identificador del cliente.entitlement_ids: los derechos de acceso involucrados.expiration_at_ms: cuándo vence, en milisegundos.environment:SANDBOXoPRODUCTION.id: identificador único del evento.
Por esto en la clase 3 usaste el identificador de Supabase como identificador de RevenueCat: aquí llega de vuelta.
08
Los eventos que importan
| Evento | Qué significa |
|---|---|
INITIAL_PURCHASE | Suscripción nueva |
RENEWAL | Se renovó o volvió a suscribirse |
CANCELLATION | Canceló o hubo reembolso |
BILLING_ISSUE | Falló un cobro |
EXPIRATION | Terminó: se retira el acceso |
Hay más, como compras que no se renuevan y cambios de plan. La lista completa está en la documentación de tipos de evento.
09
Cancelar no es perder el acceso
Quien cancela ya pagó su período. El acceso se retira con el evento de expiración, no con el de cancelación.
10
Qué hace tu servidor con cada caso
- Compra y renovación: acceso activo, nueva fecha de vencimiento.
- Cancelación: el acceso sigue hasta
vence_el; puedes anotar que no renovará. - Falla de cobro: la suscripción puede no haber vencido aún; marca el estado y avisa al usuario.
- Expiración: acceso terminado.
11
Reembolsos
Un reembolso llega como evento de cancelación, con el motivo indicado en el propio evento y el monto en negativo.
- Puede ocurrir sin que se haya apagado la renovación automática.
- Si el reembolso se revierte, llega un evento aparte.
Por eso, ante una cancelación, no supongas: consulta el estado actual del cliente antes de decidir.
12
La estrategia simple: avisar y consultar
RevenueCat recomienda no interpretar cada tipo de evento por separado. Al recibir cualquier aviso, tu función consulta el estado actual del cliente en la API de RevenueCat y guarda eso.
Menos casos especiales y menos errores. La consulta usa una clave secreta de RevenueCat, guardada como secreto de la función.
13
Validar que el aviso es de RevenueCat
Tu webhook es una dirección pública. Dos protecciones, según su documentación:
- Una cabecera de autorización con un valor secreto que tú defines y RevenueCat envía en cada llamada.
- Una firma opcional del contenido, que tu función recalcula y compara.
14
Esta función no recibe a un usuario
Las Edge Functions que llama tu app verifican la sesión del usuario. El webhook lo llama RevenueCat, que no tiene sesión.
Se protege con el secreto compartido, no con el inicio de sesión. Pídele a Claude Code configurar la función para aceptar llamadas sin sesión de usuario, siguiendo la documentación de Edge Functions, y verificar el secreto en la primera línea.
15
Responder rápido y con 200
Lo que espera RevenueCat, al 18-11-2026:
- Respuesta con código 200; cualquier otro cuenta como falla.
- Si tu servidor tarda más de 60 segundos, corta y reintenta.
- Reintenta hasta 5 veces, espaciando los intentos, durante unos 80 minutos.
Puedes reenviar a mano los eventos fallidos desde el panel.
16
El mismo aviso puede llegar dos veces
La entrega es «al menos una vez». Los reintentos repiten el mismo id de evento.
- Guarda cada
idprocesado en una tabla con restricción de único. - Si el
idya existe, responde 200 y no hagas nada más.
Si usas la estrategia de consultar el estado actual, procesar dos veces deja el mismo resultado. Aun así, registra los eventos: sirven para investigar reclamos.
17
Los avisos no son instantáneos
La mayoría llega entre 5 y 60 segundos después del hecho. Los de cancelación pueden tardar hasta unas 2 horas.
Consecuencia: justo después de comprar, la app ya ve el derecho activo, pero tu tabla puede no estar al día.
18
Separar pruebas de producción
El campo environment distingue compras de sandbox de compras reales. RevenueCat permite además registrar webhooks distintos por entorno.
- Apunta los avisos de sandbox a tu proyecto Supabase de pruebas.
- Apunta los de producción al proyecto real.
19
Restaurar compras y cambio de cuenta
Cuando alguien restaura en otro teléfono o con otra cuenta de tu app, RevenueCat puede traspasar las compras de un identificador a otro y avisa con un evento de transferencia.
Tu tabla debe reflejarlo: el acceso pasa al identificador nuevo y deja el anterior. Consultar el estado actual de ambos clientes lo resuelve sin lógica adicional.
20
Usar el acceso en el servidor
Con la tabla al día, protegerás lo que cuesta:
- Edge Functions: antes de llamar a la IA, leen la tabla y niegan si no hay acceso vigente.
- RLS: una política puede exigir acceso vigente para leer contenido de pago.
- Cuotas: el límite de uso puede depender del plan (módulo 10, clase 5).
La app sigue usando el SDK para decidir qué pantalla mostrar.
21
El mismo patrón sirve para la pasarela
Lo que hiciste con Mercado Pago en la clase 5 es idéntico en estructura:
| Paso | RevenueCat | Mercado Pago |
|---|---|---|
| Aviso | Evento | Notificación |
| Validar | Cabecera o firma | Firma x-signature |
| Confirmar | Estado del cliente | Consultar el pago |
| Guardar | Tabla de accesos | Estado del pedido |
22
Errores comunes
- Quitar el acceso al recibir la cancelación.
- No guardar la fecha de vencimiento.
- Procesar dos veces el mismo evento.
- Hacer trabajo lento antes de responder al aviso.
- No registrar los eventos recibidos.
23
Lo que te llevas
- Lo que cuesta dinero se decide con una tabla en tu servidor, no con lo que dice la app.
- Un webhook validado mantiene esa tabla al día.
- Cancelar no quita acceso; expirar sí. Los reembolsos se confirman consultando.
- Los avisos se repiten y se demoran: guarda el
idy la fecha de vencimiento. - Sandbox y producción van a proyectos separados.
24
Hazlo ahora
En 10 minutos, en tu especificación:
- Diseña tu tabla de accesos: columnas y quién puede leer o escribir.
- Lista qué funciones del servidor deben consultar esa tabla antes de responder.
- Decide qué ve el usuario cuando falla un cobro y cuando su plan termina.
Con eso escrito, pedirle a Claude Code el webhook es un encargo acotado y revisable.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026