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

Atribuição de Comissão Automatizada

Sem planilhas ou rastreamento manual. As referências são automaticamente atribuídas e registradas quando uma compra é feita.

Relatórios em Tempo Real

Tanto você quanto seus afiliados podem monitorar desempenho e leads a partir de painéis dedicados.

Opções de Rastreamento Flexíveis

Use scripts de rastreamento, campos de metadados e eventos de webhook para capturar dados de referência em inscrições e transações.

Totalmente Criptografado e Seguro

Todas as credenciais sensíveis e dados de webhook são trocados e armazenados de forma segura usando criptografia de ponta.

Configuração Rápida

Lance seu programa de afiliados em minutos—sem alterações de código necessárias além de copiar e colar trechos de script e tokens de API.

Integração Sem Costura

Conecte o rastreamento de afiliados diretamente aos seus fluxos de checkout usando nossas integrações com Affonso e Dub Partners, plataformas líderes de 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

Conectar com Dodo Payments

Para começar, conecte sua conta do 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 de forma segura pela Affonso.
2

Adicionar Webhook ao Dodo Payments

Uma vez conectado, você receberá uma URL de webhook única da Affonso. Isso permite o rastreamento de pagamentos e a ativação 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 de forma segura os eventos recebidos do Dodo Payments.
3

Adicionar o Script de Rastreamento

Coloque o pixel do 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 o ID de referência (affonso_referral)
  • Habilita o rastreamento de inscrições e pagamentos
Coloque isso em todos os domínios onde os usuários visitam ou convertem (por exemplo, site de marketing, aplicativo).
4

Rastrear Inscrições de Usuários

Para obter visibilidade do funil e otimizar o desempenho dos afiliados, rastreie as inscrições 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
Melhor prática: Acione isso após o registro bem-sucedido ou dupla confirmação (DOI).
5

Passar Dados de Referência para o Dodo Payments

Para atribuir comissões corretamente, passe o ID de referência do 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

Testando Sua Integração

Antes de lançar publicamente, teste sua configuração com links de afiliados ao vivo e transações de teste.Lista de Verificação de Testes:
  • ✅ Crie um afiliado e gere um link de rastreamento
  • ✅ Visite seu site através do link de afiliado
  • ✅ Certifique-se de que o script do Affonso carrega e o cookie affonso_referral está definido
  • ✅ Complete uma inscrição (opcional)
  • ✅ Complete um pagamento via Dodo Payments
  • ✅ Confirme o rastreamento e a atribuição no seu painel do 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 do Dub que cobre como rastrear eventos de conversão de vendas e atribuir receita aos seus links de afiliados.

​
Configuração Rápida com Dub Partners

  1. Ative o rastreamento de conversões no seu painel do Dub para links de afiliados
  2. Capture o ID de clique do Dub (dub_id cookie) 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 de webhook para enviar dados de venda ao Dub quando os pagamentos forem bem-sucedidos
A integração rastreia automaticamente:
  • Pagamentos únicos
  • Ativações de assinatura
  • Pagamentos de assinatura recorrentes

Saiba Mais

Veja o guia completo de integração do 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:

Suporte do Affonso

Suporte do Dub

  • Visite a documentação do Dub para guias de rastreamento de conversões
  • Entre em contato com o suporte do Dub através do seu painel

Suporte do Dodo Payments

Para consultas específicas da API do Dodo Payments, consulte docs.dodopayments.com ou entre em contato com nossa equipe de suporte.

Guias de Integração