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

Atribución de Comisiones Automatizada

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

Informes en Tiempo Real

Tanto tú como tus afiliados pueden monitorear el rendimiento y los leads desde paneles dedicados.

Opciones de Seguimiento Flexibles

Utiliza scripts de seguimiento, campos de metadatos y eventos de webhook para capturar datos de referencia a través de registros y transacciones.

Totalmente Encriptado y Seguro

Todas las credenciales sensibles y los datos de webhook se intercambian y almacenan de forma segura utilizando encriptación de primer nivel.

Configuración Rápida

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

Integración Sin Problemas

Conecta el seguimiento de afiliados directamente en tus flujos de pago utilizando nuestras integraciones con Affonso y Dub Partners, plataformas líderes 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

Conectar con Dodo Payments

Para comenzar, conecta tu cuenta de Dodo Payments añadiendo tu clave 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 API será encriptada de forma segura por Affonso.
2

Agregar Webhook a Dodo Payments

Una vez conectado, recibirás una URL de webhook única de Affonso. Esto permite el seguimiento de pagos y la activación 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 de Dodo Payments.
3

Agregar el Script de Seguimiento

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:
  • Rastreará visitas de afiliados
  • Establecerá una cookie con el ID de referencia (affonso_referral)
  • Habilitará el seguimiento de registros y pagos
Coloca esto en todos los dominios donde los usuarios visiten o conviertan (por ejemplo, sitio de marketing, aplicación).
4

Rastrear Registros de Usuarios

Para obtener visibilidad del embudo y optimizar el rendimiento de los afiliados, rastrea los registros 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 doble opt-in (DOI).
5

Pasar Datos de Referencia a Dodo Payments

Para atribuir comisiones correctamente, 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

Probar Tu Integración

Antes de lanzar públicamente, prueba tu configuración con enlaces de afiliados en vivo y transacciones de prueba.Lista de Verificación de Pruebas:
  • ✅ Crea un afiliado y genera un enlace de seguimiento
  • ✅ Visita tu sitio web a través del enlace de afiliado
  • ✅ Asegúrate de que el script de Affonso se cargue y que la cookie affonso_referral esté establecida
  • ✅ Completa un registro (opcional)
  • ✅ Completa un pago a través de 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 instrucciones de configuración detalladas, 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. Habilita el seguimiento de conversiones en tu panel de Dub para enlaces de afiliados
  2. Captura el ID de clic de Dub (dub_id cookie) 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 de webhook para enviar datos de ventas a Dub cuando los pagos sean exitosos
La integración rastrea automáticamente:
  • Pagos únicos
  • Activaciones de suscripciones
  • Pagos recurrentes de suscripciones

Aprende Más

Consulta la guía completa de integración 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:

Soporte de Affonso

Soporte de Dub

Soporte de Dodo Payments

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

Guías de Integración