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

> Lance e gerencie seu programa de afiliados enquanto processa transações através do Dodo Payments.

## Introdução

Este guia o orienta sobre como rastrear referências de afiliados, lidar com eventos de comissão e aumentar sua receita com parcerias de afiliados confiáveis por meio do Dodo Payments. Oferecemos integrações com plataformas de afiliados líderes, incluindo **Affonso** e **Dub Partners**, para ajudá-lo a gerenciar e rastrear seus programas de afiliados de forma contínua.

## Principais Recursos

<CardGroup cols={2}>
  <Card title="Automated Commission Attribution" icon="robot">
    Sem planilhas ou rastreamento manual. As indicações são automaticamente atribuídas e registradas quando uma compra é realizada.
  </Card>

  <Card title="Real-Time Reporting" icon="chart-line">
    Você e seus afiliados podem monitorar desempenho e leads em painéis dedicados.
  </Card>

  <Card title="Flexible Tracking Options" icon="code">
    Use scripts de rastreamento, campos de metadados e eventos webhook para capturar dados de indicações ao longo de cadastros e transações.
  </Card>

  <Card title="Fully Encrypted & Secure" icon="shield">
    Todas as credenciais sensíveis e dados de webhook são trocados e armazenados com segurança usando criptografia de ponta.
  </Card>

  <Card title="Quick Setup" icon="bolt">
    Lance seu programa de afiliados em minutos—nenhuma alteração de código é necessária além de copiar e colar trechos de script e tokens de API.
  </Card>

  <Card title="Seamless Integration" icon="plug">
    Conecte o rastreamento de afiliados diretamente aos seus fluxos de checkout usando nossas integrações com Affonso e Dub Partners, plataformas líderes em marketing de afiliados.
  </Card>
</CardGroup>

## Opções de Integração

O Dodo Payments se integra a duas plataformas líderes de gerenciamento de afiliados:

* **[Affonso](https://affonso.io)**: Uma plataforma abrangente de gerenciamento de afiliados com rastreamento automático de comissões, relatórios em tempo real e painéis dedicados para afiliados.
* **[Dub Partners](https://dub.co)**: Use o gerenciamento de links e o rastreamento de conversões do Dub para potencializar seu programa de afiliados com análises detalhadas de atribuição.

Escolha a plataforma que melhor se adapta às suas necessidades ou use ambas para diferentes casos de uso.

## Integração com Affonso

Fizemos parceria com a Affonso, uma plataforma líder de gerenciamento de afiliados, para potencializar suas vendas. Siga os passos abaixo para conectar sua conta do Dodo Payments com a Affonso e começar a rastrear vendas impulsionadas 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 começar, conecte sua conta Dodo Payments adicionando sua chave de API.

    ### Como Obter Sua Chave de API do Dodo Payments

    * Faça login no seu **Painel do Dodo Payments**
    * Vá para a seção **Desenvolvedor** no menu à esquerda
    * Clique em **Chaves de API**
    * Selecione **Adicionar Chave de API**
    * Dê um nome (por exemplo, "Integração com Affonso")
    * Clique em **Criar** e **copie** sua chave de API

    ### Adicione Sua Chave de API ao Affonso

    * Abra seu **Painel do Affonso via** [affonso.io](https://affonso.io/)
    * Vá para **Detalhes do Programa > Conectar**
    * Clique no cartão de **integração do Dodo Payments**
    * Cole sua chave de API do Dodo Payments
    * Clique em **Conectar**

    <Callout type="info">
      Sua chave de API será criptografada com segurança pela Affonso.
    </Callout>
  </Step>

  <Step title="Add Webhook to Dodo Payments">
    Depois de conectada, você receberá uma URL de webhook exclusiva da Affonso. Isso permite o rastreamento de pagamentos e o acionamento de comissões de afiliados.

    ### Adicionar URL de Webhook no Dodo Payments

    * No seu Painel do Dodo Payments, vá para **Desenvolvedor → Webhooks**
    * Clique em **Adicionar Webhook**
    * Cole sua **URL de webhook do Affonso** (das configurações do seu programa)
    * Salve o webhook

    ### Adicionar Segredo do Webhook no Affonso

    * Após salvar o webhook no Dodo Payments, **copie a chave de assinatura** fornecida
    * Cole-a de volta no Affonso sob as **configurações de webhook do Dodo Payments**

    <Callout type="info">
      Isso permite que a Affonso verifique com segurança os eventos recebidos do Dodo Payments.
    </Callout>
  </Step>

  <Step title="Add the Tracking Script">
    Coloque o pixel da Affonso em seu site para começar a rastrear visitas e conversões 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:

    * Rastreia visitas de afiliados
    * Define um cookie com a ID da indicação (`affonso_referral`)
    * Habilita o rastreamento de cadastros e pagamentos

    <Callout type="info">
      Coloque isso em todos os domínios onde os usuários visitam ou convertem (por exemplo, site de marketing, aplicativo).
    </Callout>
  </Step>

  <Step title="Track User Signups">
    Para obter visibilidade do funil e otimizar o desempenho dos afiliados, rastreie os cadastros de usuários como leads.

    ```js theme={null}
    // After successful registration
    window.Affonso.signup(userEmail);
    ```

    Isso irá:

    * Registrar uma nova referência como um **LEAD** se o usuário veio por meio de um link de afiliado
    * Exibi-la no seu painel e nas estatísticas do afiliado

    <Callout type="info">
      Boa prática: acione isso após um registro bem-sucedido ou opt-in duplo (DOI).
    </Callout>
  </Step>

  <Step title="Pass Referral Data to Dodo Payments">
    Para atribuir comissões corretamente, passe a ID da indicação da Affonso para o Dodo Payments durante o checkout.

    ### Integração de Pagamentos

    ```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();
    ```

    ### Integração de Assinaturas

    ```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();
    ```

    ### Links de Pagamento

    ```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 mais detalhes, consulte a [documentação da API do Dodo Payments](https://docs.dodopayments.com/api-reference/introduction)
    </Callout>
  </Step>

  <Step title="Testing Your Integration">
    Antes de lançar publicamente, teste sua configuração com links de afiliados ativos e transações de teste.

    **Checklist de testes:**

    * ✅ Crie um afiliado e gere um link de rastreamento
    * ✅ Visite seu site via o link do afiliado
    * ✅ Verifique se o script da Affonso é carregado e se o cookie `affonso_referral` é definido
    * ✅ Complete um cadastro (opcional)
    * ✅ Conclua um pagamento pelo Dodo Payments
    * ✅ Confirme o rastreamento e a atribuição no painel da Affonso
  </Step>
</Steps>

## Integração com Dub Partners

Você também pode usar [Dub Partners](https://dub.co) para rastrear referências e conversões de afiliados. O recurso de rastreamento de conversões do Dub permite que você atribua vendas aos seus links de afiliados, fornecendo análises detalhadas sobre quais parceiros geram mais receita.

<Info>
  Para instruções detalhadas de configuração, consulte nosso [guia de integração com a Dub](/integrations/dub), que aborda como rastrear eventos de conversão de vendas e atribuir receita aos seus links de afiliados.
</Info>

### Configuração Rápida com Dub Partners

1. **Habilite o rastreamento de conversões** no seu painel da Dub para links de afiliados
2. **Capture o ID de clique da Dub** (cookie `dub_id`) ao criar sessões de checkout
3. **Armazene o ID de clique** nos metadados de pagamento junto com as informações do cliente
4. **Configure a integração via webhook** para enviar os dados de venda para a Dub quando os pagamentos forem aprovados

A integração rastreia automaticamente:

* Pagamentos únicos
* Ativações de assinatura
* Pagamentos de assinatura recorrentes

<Card title="Learn More" icon="book" href="/integrations/dub">
  Veja o guia completo de integração com a Dub com exemplos de código e modelos de transformação.
</Card>

## Precisa de Ajuda?

Se você enfrentar algum problema ou precisar de suporte durante a integração:

<CardGroup cols={2}>
  <Card title="Affonso Support" icon="headset">
    * Converse conosco via **chat ao vivo** em [affonso.io](https://affonso.io/)
    * Envie um e-mail para **[support@affonso.io](mailto:support@affonso.io)**
  </Card>

  <Card title="Dub Support" icon="headset">
    * Visite a [documentação da Dub](https://dub.co/docs) para guias de rastreamento de conversões
    * Entre em contato com o suporte da Dub pelo [painel](https://app.dub.co)
  </Card>

  <Card title="Dodo Payments Support" icon="headset">
    Para dúvidas específicas sobre a API do Dodo Payments, consulte docs.dodopayments.com ou entre em contato com nossa equipe de suporte.
  </Card>

  <Card title="Integration Guides" icon="book">
    * [Integração Affonso](#affonso-integration) (acima)
    * [Integração Dub Partners](/integrations/dub)
  </Card>
</CardGroup>