En resumen. Recurly no incluye ninguna función de afiliados, así que un programa de afiliados en Recurly significa añadir una capa de seguimiento: un reenvío de webhooks casero, una agencia con hojas de cálculo o una plataforma con integración nativa con Recurly. La ruta nativa es una clave de API de solo lectura, un webhook XML y un campo personalizado rekomi_ref en la suscripción. A partir de ahí, las facturas pagadas, las renovaciones, los reembolsos y las anulaciones liquidan las comisiones por sí solos.

Un programa de afiliados en Recurly parte de un hecho que la mayoría de las guías pasa por alto: Recurly es facturación de suscripciones que funciona sobre la pasarela de pago que ya usas, y no incluye seguimiento de afiliados propio. Esa combinación decide todo sobre cómo tiene que funcionar el seguimiento de referidos, y en cuanto le ves la forma, la configuración entera es, sinceramente, bastante limpia. Rekomi, el software de afiliados que yo construyo, tiene una integración nativa con Recurly que escribí yo mismo, así que conozco esta mecánica hasta el nombre de cada notificación.
Esta guía cubre por qué los negocios de suscripción en Recurly son tan buenos candidatos para un canal de afiliados, las tres formas de llevar uno de verdad, qué implica la configuración nativa (incluida la única limitación de plan de Recurly que deberías conocer antes de empezar) y exactamente qué se registra una vez que estás conectado.
Por qué los negocios en Recurly añaden programas de afiliados
Porque la facturación recurrente convierte un solo referido en un flujo de pagos, y eso cambia las cuentas de todo el canal. Cuando un cliente referido en un plan de $79/mes se queda un año, una comisión recurrente del 20% le paga al afiliado $15.80 al mes, $189.60 a lo largo del año, frente a los $948 que cobraste tú. Pagaste por la retención, no solo por un clic, y el afiliado construyó algo más parecido a un MRR que a una recompensa única. Ese trato es bueno de verdad para las dos partes, y por eso los afiliados de SaaS buscan programas con condiciones recurrentes.
Los equipos eligen Recurly por el control: orquesta planes, pruebas, gestión de impagos y facturación mientras los pagos siguen pasando por tu propia pasarela, ya sea Stripe, Adyen, Braintree o GoCardless. La buena noticia para el seguimiento es que Recurly es la fuente de verdad de todas y cada una de esas facturas. Una capa de seguimiento que escucha a Recurly ve cada pago exactamente igual, sin importar qué pasarela procesó la tarjeta, así que el enrutamiento de tus pagos nunca cambia. Si quieres el contexto a fondo de cómo funciona esta categoría de herramientas, mi guía sobre software de seguimiento de afiliados lo explica desde cero.
Tres formas de llevar un programa de afiliados en Recurly
Ruta 1: constrúyelo tú sobre los webhooks de Recurly. Recurly publica notificaciones por webhook para facturas, pagos, reembolsos y eventos del ciclo de vida de la suscripción, así que un desarrollador puede perfectamente montar un reenvío que acredite los referidos. Eso sí, calcula el alcance real: tendrías que procesar cargas XML, deduplicar los reintentos de entrega de Recurly, llevar el referido desde el navegador del visitante hasta el registro de la suscripción, tratar los reembolsos y los pagos anulados como reversiones, y después todavía construir el registro de afiliados, los paneles, los pagos y los formularios fiscales. El primer 20% es un fin de semana divertido; el otro 80% es un producto.
Ruta 2: una agencia o una hoja de cálculo. Muchos programas empiezan con alguien de partnerships conciliando referidos en una hoja cada mes, y con 3 partners funciona. Deja de funcionar el mes en que un afiliado pregunta por qué su número no coincide con el tuyo y no tienes ningún registro de eventos con el que responder. La conciliación manual además se salta los reembolsos sin que nadie lo note, lo que significa que pagas de más y nunca te enteras.
Ruta 3: una plataforma con integración nativa con Recurly. Aquí la lista es más corta de lo que esperarías. FirstPromoter e impact.com tienen integraciones con Recurly del lado del servidor creíbles, y son productos sólidos; Rewardful, la herramienta que conocen la mayoría de los fundadores que empiezan en Stripe, no admite Recurly a día de hoy. La integración de Rekomi también está en este grupo, y como es mía, el resto del artículo recorre esa configuración como ejemplo concreto. Las partes que importan (el campo personalizado, el webhook, la pega del plan) valen para cualquier ruta del lado del servidor que elijas.

Cómo es la configuración nativa
Tres piezas, aquí solo en resumen; la guía de configuración de Recurly tiene cada clic y cada fragmento de código.
- Una clave de API de solo lectura y tu región. Recurly tiene una región de EE. UU. (v3.recurly.com) y una región de la UE (v3.eu.recurly.com), así que eliges la tuya y después creas una clave de API privada en Integrations > API Credentials con la casilla de solo lectura marcada. Rekomi valida la clave en vivo contra tu región, y si en realidad la clave pertenece a la otra región, recibes una sugerencia de región en lugar de un error críptico. La clave nunca se usa para cambiar nada en tu sitio de Recurly.
- Un webhook XML con autenticación básica. En el panel de administración de Recurly, en Integrations > Webhooks, añades un único endpoint: la URL por espacio de trabajo que genera Rekomi, el formato XML y las credenciales de autenticación básica que Rekomi crea por ti. Ese paso de autenticación importa porque Recurly firma sus webhooks JSON pero no los XML, y las cargas XML son las que llevan los datos completos de la factura, así que cada entrega se autentica antes de procesar nada.
- Un campo personalizado
rekomi_refen la suscripción. Recurly aloja el checkout en su propio dominio, así que el referido tiene que viajar desde el navegador del visitante hasta el registro de la suscripción. El script de cabecera de Rekomi captura el clic del afiliado en tu web de marketing, tu frontend lo lee conwindow.Rekomi.getReferral()y tu backend lo guarda como campo personalizadorekomi_refal crear la suscripción. Este paso es obligatorio para atribuir clientes nuevos: sáltatelo y las facturas pagadas llegarán sin ningún referido asociado.
Una pega honesta antes de empezar: los campos personalizados son una función de los planes Pro y Elite de Recurly (hasta 5 y 10 campos respectivamente), y el plan Starter de Recurly no los admite. En Starter no hay campo donde estampar el referido, así que la atribución de clientes nuevos no está disponible; las renovaciones de clientes ya atribuidos se siguen registrando bien en cualquier plan. Si estás en Starter y vas en serio con un canal de afiliados, incluye el costo de subir de plan en la decisión.
La fiabilidad es mejor de lo que imaginarías para un sistema basado en webhooks, y esta es la parte que me encanta del diseño de Recurly: las entregas que fallan se reintentan automáticamente, hasta 10 veces a lo largo de unos tres días, y cada notificación conserva un botón Retry manual en tu consola de Recurly durante los 15 días siguientes. Una caída breve en cualquiera de los dos lados se cura sola en el siguiente reintento, y las entregas reintentadas se deduplican para que nada se cuente dos veces.

Qué se registra una vez conectado
Cada movimiento de dinero, en las dos direcciones. Esa segunda dirección es mi única postura firme en esta página: una capa de seguimiento que acredita ventas pero no ve los reembolsos ni los pagos anulados pagará de más a tus afiliados de forma sistemática, y en Recurly en concreto las anulaciones son una notificación distinta de los reembolsos, así que un reenvío que solo gestiona successful_refund_notification se pierde reversiones reales. Este es el cuadro completo:
- Las facturas pagadas registran conversiones. La primera factura de cargo pagada de una suscripción registra la conversión del cliente nuevo y acredita al afiliado correcto a partir del campo
rekomi_ref. - Las renovaciones llegan como más facturas pagadas y registran comisiones recurrentes automáticamente, cruzadas con tu historial de clientes sin ninguna llamada extra a la API. Aquí es donde los $15.80/mes del ejemplo anterior se siguen acumulando sin que nadie toque nada.
- Los reembolsos recuperan la comisión de forma proporcional, por cada transacción de reembolso. Reembolsa el 40% de esa factura de $79 ($31.60 de vuelta al cliente) y exactamente el 40% de la comisión de $15.80 ($6.32) se descuenta del saldo del afiliado. Varios reembolsos parciales siguen descontando hasta agotar el importe original.
- Los pagos anulados revierten el importe completo de la transacción, aparte de los reembolsos, en el mismo registro de auditoría.
Los dos lados del libro mayor se cuadran solos, así que el número que un afiliado ve en su panel es el mismo que obtendrías recalculándolo a mano desde Recurly. ¡Esa simetría es lo que hace que automatizar los pagos sea seguro!
Rekomi en sí es software de afiliados para Recurly y más de una docena de plataformas de facturación y de creadores, con la mitad que ve el afiliado ya incluida: páginas de registro, paneles, pagos automatizados y formularios fiscales. Los planes son de $29/mes, $49/mes o $99/mes más un 3% que se cobra solo sobre lo que los afiliados ganan de verdad, y ese 3% ya cubre los pagos y la gestión fiscal. Todos los planes empiezan con una prueba gratuita de 14 días, así que puedes conectar un sandbox de Recurly y ver cómo una factura de prueba se convierte en comisión antes de pagar nada.
Preguntas frecuentes
¿Recurly tiene un programa de afiliados integrado?
No. Recurly es facturación de suscripciones y gestión de ingresos; no incluye seguimiento de afiliados ni de referidos. Para llevar un programa de afiliados en Recurly añades una capa de seguimiento que consume los webhooks de Recurly, ya sea una que construyas tú o una plataforma con integración nativa.
¿Puedo llevar un programa de afiliados en el plan Starter de Recurly?
Solo en parte. La atribución de clientes nuevos viaja en un campo personalizado de la suscripción, y los campos personalizados necesitan Recurly Pro (hasta 5) o Elite (hasta 10); Starter no los admite, así que en Starter los referidos nuevos no se pueden atribuir. Las renovaciones de clientes ya atribuidos se siguen registrando en cualquier plan.
¿Con qué pasarelas de pago funciona el seguimiento de afiliados en Recurly?
Con todas. Recurly se apoya sobre tu pasarela (Stripe, Adyen, Braintree, GoCardless y las demás), y sus webhooks informan de cada pago de la misma forma sin importar qué pasarela procesó la tarjeta. La capa de seguimiento escucha a Recurly, así que nada cambia en el enrutamiento de tus pagos.
¿Los afiliados siguen ganando cuando se renuevan las suscripciones?
Sí, cuando las condiciones de tu campaña son recurrentes. Cada renovación llega como otra factura de cargo pagada y registra una comisión recurrente durante todo el tiempo que digan tus condiciones, que es justo la razón por la que los afiliados de SaaS con experiencia prefieren los programas de suscripción al estilo de Recurly.
¿Qué pasa si falla la entrega de un webhook?
Recurly la reintenta automáticamente, hasta 10 veces a lo largo de unos tres días, y mantiene un botón Retry manual en cada notificación de tu consola durante 15 días. La conversión se registra en el reintento que tenga éxito, y las entregas se deduplican para que los reintentos nunca cuenten una venta dos veces.
¿Qué plataformas de afiliados admiten Recurly?
Menos de las que admiten Stripe. FirstPromoter e impact.com ofrecen integraciones reales con Recurly del lado del servidor, y Rekomi admite Recurly de forma nativa; Rewardful no admite Recurly a día de hoy. Si la respuesta de una plataforma para Recurly es "usa Zapier", pregunta específicamente cómo se revierten los reembolsos y los pagos anulados antes de comprometerte.
Empieza con una comprobación de 1 minuto
Mira en qué plan de Recurly estás; lleva 1 minuto y es la única barrera real de toda esta configuración. Si estás en Pro o Elite (o estás dispuesto a estarlo), tienes todo lo que necesita un programa de afiliados serio: crea el campo personalizado rekomi_ref, consigue una clave de API de solo lectura, añade el webhook y tu primera factura de prueba aparecerá como comisión el mismo día. La guía de configuración de Recurly recorre cada paso con fragmentos para copiar y pegar, y la prueba de 14 días hace que todo el experimento sea gratis.
Lleva tu programa de afiliados en Recurly con Rekomi
Rekomi se conecta a Recurly con una clave de API de solo lectura y un webhook, registra cada renovación como comisión recurrente, descuenta automáticamente los reembolsos y las anulaciones, y se encarga en tu nombre de los pagos a afiliados y de los formularios fiscales.
Empieza una prueba gratuita


