← Volver al blog

Seguimiento de afiliados en Dodo Payments: cómo un clic se convierte en comisión

8 min de lecturaGraham Caldwell
Seguimiento de afiliados en Dodo Payments: cómo un clic se convierte en comisión

El seguimiento de afiliados en Dodo Payments se reduce a una clave de metadatos y un evento de webhook. Adjuntas un ID de referido al checkout como metadatos, Dodo lo lleva a través del pago, y un webhook payment.succeeded se lo devuelve a tu software de afiliados con el dinero adjunto. Todo lo demás (renovaciones, reembolsos, disputas, impuestos) son variaciones de ese bucle, y este artículo recorre cada una con los nombres reales de los eventos.

Para que sepas quién habla: Rekomi es lo que construyo todo el día, y la propia documentación de afiliados de Dodo nos lista como uno de sus tres partners de integración, junto a Affonso y Dub Partners. Voy a contar la mecánica con honestidad y a nombrar los campos exactos, porque en una plataforma merchant of record los detalles son donde se esconde el dinero.

Resumen de sesenta segundos:

La atribución viaja en los metadatos: rekomi_ref en los checkouts por API, o ?metadata_rekomi_ref= añadido a un enlace de pago estático.

Un solo evento lleva todo el dinero: payment.succeeded se dispara en las ventas únicas, los primeros cobros de suscripción y cada renovación.

Las comisiones son antes de impuestos: Dodo es el merchant of record, así que los afiliados ganan sobre el importe de la venta, nunca sobre el IVA que cobra Dodo.

Cómo funciona el seguimiento de afiliados en Dodo Payments de serie

Dodo no construye su propio motor de seguimiento, pero es inusualmente acogedor con las herramientas que sí lo hacen. Hay una sección Affiliates directamente en el panel de Dodo (impulsada por Affonso), y la documentación describe el patrón de metadatos sobre el que se apoya cualquier herramienta de seguimiento. Mérito a quien lo merece: Dodo tomó aquí una decisión de plataforma deliberada, y es buena: los metadatos adjuntos a un checkout, una suscripción o un pago se conservan durante toda la vida del objeto, que es exactamente la propiedad que necesita la atribución.

Si lo que comparas son las herramientas en sí, eso es otro artículo: el mejor software de afiliados para Dodo Payments cubre el panorama. Aquí nos quedamos debajo del capó.

Paso uno: el clic guarda un referido

Un enlace de afiliado no es más que tu URL con un parámetro reconocible: yoursite.com?via=maria. Un script en el head de tu sitio lo recoge al cargar la página, guarda el slug en el navegador del visitante con una ventana de 90 días y registra el clic en el servidor con su referrer y sus etiquetas UTM. El script de Rekomi también acepta los parámetros a los que otras plataformas acostumbraron a internet (?ref=, ?fpr=, 19 en total), un detalle pequeño que ahorra dolores de migración reales: nadie tiene que volver a imprimir sus enlaces.

El clic está ahora en el navegador como un referido guardado. Todavía no ha conocido a Dodo. Esa entrega es el paso dos, y es el único paso con algo de ingeniería real.

Paso dos: el referido entra en el pago

Este es el mecanismo: Dodo acepta un objeto metadata en checkouts, suscripciones y pagos únicos, y copia cualquier parámetro de consulta metadata_* de un enlace de pago a ese mismo objeto. Eso te da dos rutas, una para cada tipo de vendedor.

Enlaces de pago estáticos (sin código): añade el parámetro plano con guion bajo y listo:

https://your-checkout-link?metadata_rekomi_ref=maria

Checkouts por API (en el servidor): recoge el referido guardado en el cliente con window.Rekomi.getReferral(), pásalo a tu servidor e inclúyelo en el cuerpo de la petición:

"metadata": { "rekomi_ref": "maria" }

Señalo aquí un detalle bonito y específico de Dodo: como cualquier parámetro de consulta metadata_* se copia directamente a los metadatos, los enlaces de pago no necesitan ningún campo especial. En Polar, en cambio, los enlaces de checkout solo pasan un único parámetro reference_id, así que las herramientas tienen que hacer una lectura de respaldo. El diseño de Dodo es más simple, y cuanto más simple es la tubería de la atribución, menos fugas tiene.

Una vez que los metadatos están en una suscripción, se conservan durante toda su vida. Grábalos en el alta y la renovación del mes 20 sigue sabiendo quién trajo al cliente.

Paso tres: un evento de webhook, cada dólar

Esta es mi parte favorita del modelo de eventos de Dodo, y la que más vale la pena entender antes de confiar en cualquier herramienta sobre él. payment.succeeded se dispara en cada cobro: una compra única, el primer pago de una suscripción, cada renovación mensual, el cobro inmediato de una subida de plan, incluso el cobro de recuperación cuando una suscripción sale de la espera. Escucha ese único evento y habrás oído todo el dinero.

La trampa del doble conteo: Dodo también emite subscription.renewed, y se dispara junto con payment.succeeded en cada renovación. Una herramienta que acredite los dos eventos paga la comisión dos veces, y una que se base solo en subscription.renewed lee el importe del plan antes de impuestos en lugar de lo que de verdad se cobró. Cuando evalúes cualquier herramienta de seguimiento en Dodo, esta es sinceramente la pregunta que yo haría primero: ¿qué eventos acreditas y cómo los deduplicas? (La respuesta de Rekomi: solo payment.succeeded, deduplicado por ID de pago.)

Los eventos del ciclo de vida de la suscripción (subscription.active, on_hold, failed, cancelled, expired) no mueven dinero. Existen para que un panel pueda decirte que un cliente referido se dio de baja, algo que importa más para las expectativas del afiliado que para el registro.

Flujo del seguimiento de afiliados en Dodo Payments, de los metadatos del enlace de pago al webhook payment.succeeded y a la comisión antes de impuestos

Reembolsos y disputas: el bucle de descuento

Una comisión que sobrevive a su reembolso es una fuga en tu margen. Dodo cierra ese bucle con dos familias de eventos:

  • refund.succeeded anula la comisión por cada reembolso. Dodo permite reembolsos hasta 30 días después de la transacción, cada reembolso parcial llega como su propio evento con su propio ID, y los descuentos siguen llegando hasta agotar la comisión original, nunca más allá.
  • dispute.opened descuenta de inmediato. Dodo retiene los fondos en disputa en el momento en que se abre un contracargo, así que la comisión se anula en ese mismo momento. Es una ventaja muy real frente a plataformas sin ninguna señal de disputa (Polar, sin ir más lejos, no tiene ninguna).

Una asimetría, por ser honesto: si después ganas la disputa, la comisión no se restaura automáticamente. Las disputas ganadas son lo bastante raras como para que sea un intercambio razonable, pero es real, y el registro de auditoría te muestra exactamente cuándo ocurre para que puedas volver a acreditar al afiliado a mano.

La lista de ventas y conversiones en el panel de Rekomi con los estados de comisión, incluida una venta reembolsada (datos de demostración)
La vista de ventas y conversiones en Rekomi (datos de demostración)

A quién se acredita, y sobre qué importe

Cuando llega payment.succeeded, la resolución es una escalera corta: los metadatos rekomi_ref ganan si coinciden con un afiliado aprobado; si no, gana el historial del cliente (una compra anterior atribuida del mismo cliente de Dodo acredita al mismo afiliado, que es lo que mantiene honestas las renovaciones incluso cuando los metadatos desaparecen); si no, la venta se registra sin atribuir y espera en una cola de revisión. Conviene decirlo claro: en Dodo no hay respaldo por código de cupón. Una promoción de "usa mi código" sin clic no se atribuye aquí, así que los enlaces son el mecanismo, y punto.

Ahora el importe. Dodo es un merchant of record: cobra el impuesto sobre ventas y el IVA en tu nombre, y el cobro que ve el cliente lo incluye. La aritmética de la comisión tiene que tenerlo en cuenta. Digamos que vendes un producto de $49 con una comisión del 20%, y un cliente en Alemania paga $58.31 con un 19% de IVA encima. El afiliado gana el 20% de $49, que son $9.80, no el 20% de $58.31, que pagaría de más $1.86 sin que nadie se diera cuenta en cada venta alemana. La base antes de impuestos es, al 100%, el comportamiento correcto en cualquier plataforma MoR, y vale la pena confirmar que la herramienta que elijas lo hace.

Esos $1.86 parecen poco hasta que los escalas: con 500 ventas internacionales al mes, las comisiones con impuestos incluidos pagarían de más a los afiliados unos $900/mes de margen que nunca pensaste regalar. ¡Toda esa mecánica se amortiza rápido!

Qué ve el afiliado

Desde la silla del afiliado, todo esto se reduce a algo agradablemente aburrido: un enlace, un panel con clics y conversiones, y comisiones que aparecen cuando los pagos se completan y se reducen cuando hay reembolsos. Lo recurrente es donde los productos de Dodo brillan para los afiliados: una suscripción de $25/mes al 30% son $7.50 que llegan cada mes por cada cliente retenido, porque el payment.succeeded de cada renovación lleva los mismos metadatos de la suscripción. Cuando los saldos se convierten en pagos, Rekomi mueve el dinero por sí mismo y se encarga de los formularios fiscales; los detalles de la vía de pago están en la guía de configuración de Dodo Payments.

Las preguntas que de verdad hace la gente

¿Dodo Payments admite seguimiento de afiliados de forma nativa?

En parte. Dodo tiene una función Affiliates dentro del panel impulsada por Affonso, y su documentación lista a Affonso, Dub Partners y Rekomi como partners de integración. La mecánica del seguimiento (metadatos más webhooks) es la misma por debajo elijas la que elijas.

¿Las renovaciones pagan comisiones recurrentes en Dodo?

Sí. Los metadatos grabados en el alta se quedan en la suscripción de forma permanente, y cada renovación dispara su propio payment.succeeded, así que cada renovación acredita al afiliado original automáticamente.

¿La comisión se calcula antes o después de impuestos?

Antes. Dodo es el merchant of record y el impuesto que cobra pertenece a las autoridades fiscales, así que una herramienta bien construida calcula la comisión sobre el importe de la venta antes de impuestos.

¿Se puede acreditar a los afiliados por código de descuento en Dodo?

No. La atribución en Dodo funciona con clics en enlaces transportados por metadatos; no hay una señal fiable de código a afiliado en los eventos de pago.

¿Qué pasa si un cliente presenta un contracargo?

La comisión se anula en el momento en que llega dispute.opened, en línea con el propio comportamiento de Dodo de retener los fondos de inmediato.

Compruébalo tú mismo

Leer sobre atribución está bien; verla atrapar un pago es mejor. La integración con Dodo Payments se conecta con una sola clave de API (Rekomi crea el webhook y obtiene el secreto por sí mismo), ¡así que la conexión es literalmente un solo pegado! A partir de ahí, el siguiente paso honesto es un ensayo en modo de prueba: decora un enlace de pago con ?metadata_rekomi_ref= y el slug de tu afiliado de prueba, paga con una tarjeta de prueba y mira cómo la conversión llega antes de impuestos y correctamente acreditada. Si lo hace en la venta uno, lo hará en la venta diez mil.

Prueba Rekomi

Gestiona un programa de afiliados que haga crecer tus ingresos.

Atribución nativa para Stripe, Paddle, Braintree y más (cualquier otra pasarela con un pequeño fragmento de código), pagos que tienen en cuenta los reembolsos y una red de creadores integrada. Prueba gratis de 14 días: si cancelas antes de que termine, no pagas nada.

¿Empezamos con tu campaña?

Diez minutos hasta el primer clic.

Prueba gratis de 14 días. Stripe, Paddle, Braintree y más, de forma nativa. En marcha esta misma tarde.

  • Prueba gratis de 14 días
  • Cancela cuando quieras, $0 cobrados