Saltar al contenido principal

​
Introducción

Esta guía te muestra 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.

​
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 nuestra integración con Affonso, una plataforma líder en marketing de afiliados.

​
Pasos de Integración

Nos hemos asociado con Affonso, una plataforma líder en 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 agregando 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 protected]', 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 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

​
¿Necesitas Ayuda?

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

Soporte de Affonso

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.