> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Afiliados

> Lanza y gestiona tu programa de afiliados mientras procesas transacciones a través de Dodo Payments.

## 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

<CardGroup cols={2}>
  <Card title="Automated Commission Attribution" icon="robot">
    Sin hojas de cálculo ni seguimiento manual. Las referencias se atribuyen automáticamente y se registran cuando se realiza una compra.
  </Card>

  <Card title="Real-Time Reporting" icon="chart-line">
    Tanto tú como tus afiliados podéis supervisar el rendimiento y los leads desde paneles de control dedicados.
  </Card>

  <Card title="Flexible Tracking Options" icon="code">
    Utiliza scripts de seguimiento, campos de metadatos y eventos webhook para capturar datos de referencias en inscripciones y transacciones.
  </Card>

  <Card title="Fully Encrypted & Secure" icon="shield">
    Todas las credenciales sensibles y los datos de webhook se intercambian y almacenan de forma segura utilizando cifrado de primera categoría.
  </Card>

  <Card title="Quick Setup" icon="bolt">
    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.
  </Card>

  <Card title="Seamless Integration" icon="plug">
    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.
  </Card>
</CardGroup>

## Opciones de Integración

Dodo Payments se integra con dos plataformas líderes de gestión de afiliados:

* **[Affonso](https://affonso.io)**: 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](https://dub.co)**: 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.

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/8tw8o9yOjsA" title="Affiliate Integration | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

<Steps>
  <Step title="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](https://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**

    <Callout type="info">
      Tu clave de API se cifrará de forma segura por Affonso.
    </Callout>
  </Step>

  <Step title="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**

    <Callout type="info">
      Esto permite que Affonso verifique de forma segura los eventos entrantes desde Dodo Payments.
    </Callout>
  </Step>

  <Step title="Add the Tracking Script">
    Coloca el píxel de Affonso en tu sitio para comenzar a rastrear visitas y conversiones de afiliados.

    ```html theme={null}
    <!-- 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

    <Callout type="info">
      Coloca esto en todos los dominios donde los usuarios visiten o conviertan (p. ej., sitio de marketing, app).
    </Callout>
  </Step>

  <Step title="Track User Signups">
    Para obtener visibilidad del embudo y optimizar el rendimiento de los afiliados, rastrea las inscripciones de usuarios como leads.

    ```js theme={null}
    // 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

    <Callout type="info">
      Mejor práctica: activa esto después de un registro exitoso o un doble opt-in (DOI).
    </Callout>
  </Step>

  <Step title="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

    ```js theme={null}
    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

    ```js theme={null}
    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

    ```js theme={null}
    // 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}`;
    ```

    <Callout type="info">
      Para más detalles, consulta la [documentación de la API de Dodo Payments](https://docs.dodopayments.com/api-reference/introduction)
    </Callout>
  </Step>

  <Step title="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
  </Step>
</Steps>

## Integración con Dub Partners

También puedes usar [Dub Partners](https://dub.co) 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.

<Info>
  Para obtener instrucciones detalladas de configuración, consulta nuestra [guía de integración de Dub](/integrations/dub) que cubre cómo rastrear eventos de conversión de ventas y atribuir ingresos a tus enlaces de afiliados.
</Info>

### 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

<Card title="Learn More" icon="book" href="/integrations/dub">
  Consulta la guía de integración completa de Dub con ejemplos de código y plantillas de transformación.
</Card>

## ¿Necesitas Ayuda?

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

<CardGroup cols={2}>
  <Card title="Affonso Support" icon="headset">
    * Chatea con nosotros mediante el **chat en vivo** en [affonso.io](https://affonso.io/)
    * Escríbenos a **[support@affonso.io](mailto:support@affonso.io)**
  </Card>

  <Card title="Dub Support" icon="headset">
    * Visita la [documentación de Dub](https://dub.co/docs) para guías de seguimiento de conversiones
    * Contacta con el soporte de Dub a través de su [panel](https://app.dub.co)
  </Card>

  <Card title="Dodo Payments Support" icon="headset">
    Para consultas específicas de la API de Dodo Payments, consulta docs.dodopayments.com o contacta con nuestro equipo de soporte.
  </Card>

  <Card title="Integration Guides" icon="book">
    * [Integración con Affonso](#affonso-integration) (más arriba)
    * [Integración con Dub Partners](/integrations/dub)
  </Card>
</CardGroup>