Saltar al contenido principal

​
Introducción

Esta guía te lleva a través de cómo rastrear referencias de afiliados, manejar eventos de comisiones y aumentar tus ingresos con asociaciones de afiliados de confianza a través de Dodo Payments. Ofrecemos integraciones con plataformas de afiliados líderes, incluyendo Affonso y Dub Partners, para ayudarte a gestionar y rastrear tus programas de afiliados sin problemas.

​
Características Clave

Automated Commission Attribution

Sin hojas de cálculo ni seguimiento manual. Las referencias se atribuyen automáticamente y se registran cuando se realiza una compra.

Real-Time Reporting

Tanto tú como tus afiliados podéis supervisar el rendimiento y los leads desde paneles de control dedicados.

Flexible Tracking Options

Utiliza scripts de seguimiento, campos de metadatos y eventos webhook para capturar datos de referencias en inscripciones y transacciones.

Fully Encrypted & Secure

Todas las credenciales sensibles y los datos de webhook se intercambian y almacenan de forma segura utilizando cifrado de primera categoría.

Quick Setup

Lanza tu programa de afiliados en minutos: no se requieren cambios en el código más allá de copiar y pegar fragmentos de script y tokens de API.

Seamless Integration

Conecta el seguimiento de afiliados directamente en tus flujos de pago utilizando nuestras integraciones con Affonso y Dub Partners, plataformas destacadas de marketing de afiliados.

​
Opciones de Integración

Dodo Payments se integra con dos plataformas líderes de gestión de afiliados:
  • Affonso: Una plataforma integral de gestión de afiliados con seguimiento automático de comisiones, informes en tiempo real y paneles dedicados para afiliados.
  • Dub Partners: Utiliza la gestión de enlaces y el seguimiento de conversiones de Dub para potenciar tu programa de afiliados con análisis de atribución detallados.
Elige la plataforma que mejor se adapte a tus necesidades, o utiliza ambas para diferentes casos de uso.

​
Integración con Affonso

Nos hemos asociado con Affonso, una plataforma líder de gestión de afiliados para potenciar tus ventas. Sigue los pasos a continuación para conectar tu cuenta de Dodo Payments con Affonso y comenzar a rastrear ventas impulsadas por afiliados.
1

Connect with Dodo Payments

Para comenzar, conecta tu cuenta de Dodo Payments añadiendo tu clave de API.

​
Cómo Obtener Tu Clave API de Dodo Payments

  • Inicia sesión en tu Panel de Dodo Payments
  • Ve a la sección Desarrollador en el menú de la izquierda
  • Haz clic en Claves API
  • Selecciona Agregar Clave API
  • Dale un nombre (por ejemplo, “Integración con Affonso”)
  • Haz clic en Crear y copia tu clave API

​
Agrega Tu Clave API a Affonso

  • Abre tu Panel de Affonso a través de affonso.io
  • Ve a Detalles del Programa > Conectar
  • Haz clic en la tarjeta de integración de Dodo Payments
  • Pega tu clave API de Dodo Payments
  • Haz clic en Conectar
Tu clave de API se cifrará de forma segura por Affonso.
2

Add Webhook to Dodo Payments

Una vez conectado, recibirás una URL de webhook única de Affonso. Esto permite el seguimiento de pagos y el desencadenamiento de comisiones de afiliados.

​
Agregar URL de Webhook en Dodo Payments

  • En tu Panel de Dodo Payments, ve a Desarrollador → Webhooks
  • Haz clic en Agregar Webhook
  • Pega tu URL de webhook de Affonso (desde la configuración de tu programa)
  • Guarda el webhook

​
Agregar Secreto de Webhook en Affonso

  • Después de guardar el webhook en Dodo Payments, copia la clave de firma proporcionada
  • Pégala de nuevo en Affonso bajo la configuración de webhook de Dodo Payments
Esto permite que Affonso verifique de forma segura los eventos entrantes desde Dodo Payments.
3

Add the Tracking Script

Coloca el píxel de Affonso en tu sitio para comenzar a rastrear visitas y conversiones de afiliados.
<!-- Place in <head> tag -->
<script async defer
src="https://affonso.io/js/pixel.min.js"
data-affonso="YOUR_PUBLIC_PROGRAM_ID"
data-cookie_duration="YOUR_COOKIE_DURATION">
</script>
Este script:
  • Rastrea las visitas de afiliados
  • Establece una cookie con el ID de referencia (affonso_referral)
  • Permite el seguimiento de inscripciones y pagos
Coloca esto en todos los dominios donde los usuarios visiten o conviertan (p. ej., sitio de marketing, app).
4

Track User Signups

Para obtener visibilidad del embudo y optimizar el rendimiento de los afiliados, rastrea las inscripciones de usuarios como leads.
// After successful registration
window.Affonso.signup(userEmail);
Esto:
  • Registrará una nueva referencia como un LEAD si el usuario llegó a través de un enlace de afiliado
  • Se mostrará en tu panel y en las estadísticas del afiliado
Mejor práctica: activa esto después de un registro exitoso o un doble opt-in (DOI).
5

Pass Referral Data to Dodo Payments

Para atribuir correctamente las comisiones, pasa el ID de referencia de Affonso a Dodo Payments durante el pago.

​
Integración de Pagos

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const payment = await client.payments.create({
    payment_link: true,
    billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
    customer: { email: 'email@email.com', name: 'name' },
    product_cart: [{ product_id: 'product_id', quantity: 0 }],
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(payment.payment_id);
}

main();

​
Integración de Suscripciones

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const subscription = await client.subscriptions.create({
    billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
    customer: { customer_id: 'customer_id' },
    product_id: 'product_id',
    payment_link: true,
    return_url: 'https://example.com/success',
    quantity: 1,
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(subscription.subscription_id);
}

main();

​
Enlaces de Pago

// Original Dodo Payments Link
const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

// Append referral ID as reference_id
const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
Para más detalles, consulta la documentación de la API de Dodo Payments
6

Testing Your Integration

Antes de lanzar públicamente, prueba tu configuración con enlaces de afiliados en directo y transacciones de prueba.Lista de comprobación de pruebas:
  • ✅ Crea un afiliado y genera un enlace de seguimiento
  • ✅ Visita tu sitio web a través del enlace del afiliado
  • ✅ Asegúrate de que se carga el script de Affonso y se establece la cookie affonso_referral
  • ✅ Completa una inscripción (opcional)
  • ✅ Completa un pago mediante Dodo Payments
  • ✅ Confirma el seguimiento y la atribución en tu panel de Affonso

​
Integración con Dub Partners

También puedes usar Dub Partners para rastrear referencias y conversiones de afiliados. La función de seguimiento de conversiones de Dub te permite atribuir ventas a tus enlaces de afiliados, proporcionando análisis detallados sobre qué socios generan más ingresos.
Para obtener instrucciones detalladas de configuración, consulta nuestra guía de integración de Dub que cubre cómo rastrear eventos de conversión de ventas y atribuir ingresos a tus enlaces de afiliados.

​
Configuración Rápida con Dub Partners

  1. Activa el seguimiento de conversiones en el panel de Dub para enlaces de afiliados
  2. Captura el ID de clic de Dub (cookie dub_id) al crear sesiones de pago
  3. Almacena el ID de clic en los metadatos de pago junto con la información del cliente
  4. Configura la integración webhook para enviar los datos de venta a Dub cuando los pagos tengan éxito
La integración rastrea automáticamente:
  • Pagos únicos
  • Activaciones de suscripciones
  • Pagos recurrentes de suscripciones

Learn More

Consulta la guía de integración completa de Dub con ejemplos de código y plantillas de transformación.

​
¿Necesitas Ayuda?

Si enfrentas algún problema o necesitas soporte durante la integración:

Affonso Support

Dub Support

Dodo Payments Support

Para consultas específicas de la API de Dodo Payments, consulta docs.dodopayments.com o contacta con nuestro equipo de soporte.

Integration Guides