Pular para o conteúdo principal

​
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

Automated Commission Attribution

Sem planilhas ou rastreamento manual. As indicações são automaticamente atribuídas e registradas quando uma compra é realizada.

Real-Time Reporting

Você e seus afiliados podem monitorar desempenho e leads em painéis dedicados.

Flexible Tracking Options

Use scripts de rastreamento, campos de metadados e eventos webhook para capturar dados de indicações ao longo de cadastros e transações.

Fully Encrypted & Secure

Todas as credenciais sensíveis e dados de webhook são trocados e armazenados com segurança usando criptografia de ponta.

Quick Setup

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.

Seamless Integration

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.

​
Opções de Integração

O Dodo Payments se integra a duas plataformas líderes de gerenciamento de afiliados:
  • Affonso: 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: 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.
1

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
  • 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
Sua chave de API será criptografada com segurança pela Affonso.
2

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
Isso permite que a Affonso verifique com segurança os eventos recebidos do Dodo Payments.
3

Add the Tracking Script

Coloque o pixel da Affonso em seu site para começar a rastrear visitas e conversões 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:
  • Rastreia visitas de afiliados
  • Define um cookie com a ID da indicação (affonso_referral)
  • Habilita o rastreamento de cadastros e pagamentos
Coloque isso em todos os domínios onde os usuários visitam ou convertem (por exemplo, site de marketing, aplicativo).
4

Track User Signups

Para obter visibilidade do funil e otimizar o desempenho dos afiliados, rastreie os cadastros de usuários como leads.
// 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
Boa prática: acione isso após um registro bem-sucedido ou opt-in duplo (DOI).
5

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

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

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

// 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 mais detalhes, consulte a documentação da API do Dodo Payments
6

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

​
Integração com Dub Partners

Você também pode usar Dub Partners 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.
Para instruções detalhadas de configuração, consulte nosso guia de integração com a Dub, que aborda como rastrear eventos de conversão de vendas e atribuir receita aos seus links de afiliados.

​
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

Learn More

Veja o guia completo de integração com a Dub com exemplos de código e modelos de transformação.

​
Precisa de Ajuda?

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

Affonso Support

Dub Support

Dodo Payments Support

Para dúvidas específicas sobre a API do Dodo Payments, consulte docs.dodopayments.com ou entre em contato com nossa equipe de suporte.

Integration Guides