Guía de integración

Integración de afiliados con RevenueCat: la guía completa.

Este es el compañero técnico de la visión general de RevenueCat affiliate. Si quieres el "porqué" y los precios, empieza allí; esta página es el "cómo".

En resumen

RevenueCat no tiene una función de afiliados integrada, pero su webhook es la base ideal para una. La integración son tres movimientos: el SDK de InfluTo escribe el código de referido del creador como atributo de suscriptor de RevenueCat (influto_code); añades InfluTo como integración de webhook en el dashboard de RevenueCat; InfluTo lee entonces tres tipos de evento — INITIAL_PURCHASE, RENEWAL, CANCELLATION — para crear conversiones, devengar comisión recurrente y mantener los pagos honestos ante reembolsos. Pruébalo de punta a punta con una compra sandbox antes de invitar a creadores.

Por qué el webhook es la fuente de verdad

Un programa de afiliados paga dinero real, así que el disparador de la comisión debe ser algo que ni el dispositivo cliente ni el creador puedan falsificar. El webhook de RevenueCat tiene exactamente las propiedades correctas:

  • Es server-to-server. Los eventos se originan en el backend de RevenueCat después de validar la transacción subyacente de la tienda. Nada en el binario de tu app puede falsificar uno.

  • Ya cubre ambas tiendas. Un solo webhook lleva los eventos de suscripción de iOS y Android en un mismo formato, así que a la capa de afiliados le da igual de qué tienda vino el recibo.

  • Lleva atributos de suscriptor. Esta es la bisagra de toda la integración: pares clave-valor arbitrarios que fijas en un usuario y que viajan con cada evento sobre ese usuario.

En InfluTo, esta es una de las dos vías de verificación soportadas — la otra es la validación directa con App Store Server API / recibos de Google Play para apps sin RevenueCat. Eliges exactamente una por app, nunca ambas: dos fuentes de verdad para el mismo dinero es como nacen los bugs de doble conteo.

Cómo viaja la atribución en el webhook

Paso a paso por la vida de un usuario referido:

  1. 1

    El código llega al SDK. Un creador comparte su código. El usuario instala tu app y el código llega al SDK — tecleado, o llevado por el enlace de referido.

  2. 2

    El SDK etiqueta al usuario en RevenueCat. El SDK de InfluTo lo escribe como el atributo de suscriptor influto_code en RevenueCat. Desde ese momento, la identidad del creador viaja con el usuario dentro del propio RevenueCat. Los clics en el enlace del creador ya se deduplicaron y marcaron contra fraude en el lado de InfluTo; la coincidencia del código, en cambio, es determinista — sin fingerprinting, sin IDFA, sin diálogo ATT.

  3. 3

    El webhook se dispara; se crea la conversión. Cuando el usuario se suscribe, RevenueCat valida la transacción de la tienda y dispara el webhook. InfluTo lee influto_code del evento, empareja al creador y crea la conversión.

Los tres eventos que importan

  • INITIAL_PURCHASE. La primera transacción de suscripción del usuario. Crea la conversión y bloquea la tasa de comisión: la tasa al inicio de la suscripción es la tasa para toda la vida de ese suscriptor, así que los cambios de tasa a mitad de campaña nunca reprecian en silencio a los suscriptores existentes de un creador. Un detalle crítico: comprueba el period type del evento. El inicio de una prueba también llega como INITIAL_PURCHASE, y una prueba no es un ingreso — no devenga comisión.

  • RENEWAL. El motor recurrente. Cada evento de renovación añade un devengo de comisión para el creador emparejado. Aquí es también donde un usuario en prueba se vuelve comisionable: cuando la prueba convierte a pago, aparece la transacción pagada y la comisión empieza. La regla que mantiene todo honesto es simple — la comisión sigue al dinero verificado, así que los creadores ganan con las conversiones de pruebas, nunca con sus inicios. Eso también significa que los creadores no pueden farmear comisión generando altas de prueba desechables, lo que protege tu depósito y tus datos.

  • CANCELLATION. El mecanismo de honestidad. Con la renovación automática apagada, las renovaciones dejan de llegar y el devengo se detiene con ellas. Un reembolso significa que el dinero sobre el que se calculó comisión se ha revertido — por eso InfluTo retiene la comisión durante la ventana de reembolso antes de hacerla pagadera. Con la retención, una suscripción reembolsada simplemente nunca se paga; no persigues a un creador para que devuelva dinero que ya salió. (Los eventos de expiración cierran el ciclo cuando el acceso termina de verdad.)

Configuración, en cuatro pasos

  1. 1

    Instala el SDK y fija el atributo. Swift, Kotlin, Flutter o React Native/Expo — open source en github.com/influto, unos 5 minutos. El SDK se encarga de escribir influto_code; tú solo le pasas el código con el que llegó el usuario. Snippets exactos por plataforma: docs.influ.to/integrations/revenuecat.

  2. 2

    Añade el webhook en RevenueCat. En el dashboard de RevenueCat, añade InfluTo como integración de webhook con tu URL de endpoint y cabecera de autorización. RevenueCat soporta múltiples integraciones de webhook por proyecto, así que tus webhooks existentes siguen funcionando intactos. Trata la cabecera de autorización como un secreto; InfluTo rechaza eventos no autenticados y puedes rotar el secreto si se filtra.

  3. 3

    Prueba en sandbox. RevenueCat marca cada evento con su entorno, así que las compras sandbox se distinguen de las de producción. Ejecuta tu app contra una cuenta sandbox de la tienda, aplica un código de referido de prueba, completa una suscripción sandbox y observa aparecer la conversión atribuida. Si has conectado un agente de IA por MCP, influto_integration_status informa exactamente de qué piezas ha visto la plataforma — actividad del SDK, eventos del webhook, conversiones de prueba atribuidas — e influto_test_integration ejecuta la comprobación en vivo. No te lo saltes: un programa roto en silencio el día del lanzamiento quema una confianza de los creadores que no recuperarás.

  4. 4

    Sal a producción. Fondea el monedero en depósito (reembolsable, vía Stripe), crea la campaña, invita a creadores. Desde aquí el pipeline es autónomo: llegan eventos, se devenga comisión, Stripe Connect paga a los creadores desde el monedero con un mínimo de $1. Configuración gratis, comisión de plataforma del 10% sobre comisiones.

claude mcp add --transport http influto https://influ.to/mcp

Lo que no tienes que cambiar

Nada de tu configuración actual de RevenueCat se mueve. Entitlements, offerings, paywalls, tus webhooks y analítica actuales — todo intacto. RevenueCat sigue siendo tu fuente de verdad de ingresos; la capa de afiliados es un atributo de suscriptor más un consumidor de webhook adicional. Si algún día la quitas, borras la integración de webhook y las escrituras del atributo, y tu stack de suscripciones queda exactamente como estaba. El resumen a nivel de producto vive en la página de la función de integración con RevenueCat, enlazada abajo — y puedes configurarla gratis hoy.

Integración con RevenueCat, respondido.

Conéctalo esta misma tarde.

Un atributo de suscriptor, un webhook, una prueba sandbox. Configuración gratis — 10% solo sobre las comisiones que los creadores ganan de verdad.

Empieza gratis