Rekomi

​

Introdução

​

Como funciona

1. Um visitante clica em um link de afiliado e acessa seu site, onde o script da Rekomi armazena a indicação no navegador dele.
2. Ele acessa o checkout, e você anexa essa indicação ao pagamento como metadados rekomi_ref.
3. O Dodo Payments processa o pagamento e envia um webhook assinado payment.succeeded para o endpoint criado pela Rekomi.
4. A Rekomi associa a indicação ao afiliado, calcula a comissão sobre o valor da venda antes dos impostos e a registra.

​

Pré-requisitos

1. Uma conta do Dodo Payments no modo live
2. Uma conta da Rekomi
3. Uma chave de API do Dodo Payments com acesso de gravação habilitado (chaves somente leitura não podem criar webhooks)

​

Primeiros passos

1

Create an API Key with Write Access

No seu dashboard do Dodo Payments, acesse Developer → API Keys e crie uma chave (dê a ela o nome “Rekomi”) com Enable write access marcado. Consulte o guia de chaves de API para obter instruções detalhadas.

Habilite o acesso de gravação na chave: chaves somente leitura passam pela validação, mas não podem criar o endpoint de webhook, portanto a conexão falharia no meio do processo.

2

Paste the Key into Rekomi

Na Rekomi, abra Setup → Connect payment processor, escolha Dodo Payments e cole a chave. A Rekomi a valida em tempo real, cria o endpoint de webhook na sua conta e busca o signing secret por conta própria.

Depois da conexão, a chave é usada apenas para gerenciar o endpoint de webhook e executar verificações periódicas de integridade. Suas vendas chegam pelo webhook assinado, nunca pela API.

3

Install the Rekomi Script

Adicione o script de rastreamento da Rekomi ao seu site de marketing para que os cliques de afiliados sejam capturados. O snippet com o ID do programa preenchido está em Setup → Install, na Rekomi.

<script
  async
  src="https://api.rekomi.com/api/v1/r/loader.js"
  data-program-id="YOUR_PROGRAM_ID"
></script>

4

Pass the Referral into Checkout

Anexe a indicação capturada a cada pagamento como metadados rekomi_ref. Consulte os exemplos de implementação abaixo.

5

Done!

Vendas, renovações, reembolsos e disputas agora atribuem e estornam comissões de afiliados automaticamente, e a Rekomi cuida do pagamento aos seus afiliados.

​

Guia de implementação

​

Checkout Sessions via API

import DodoPayments from 'dodopayments';

const client = new DodoPayments();

export async function createCheckout(productId: string, rekomiRef?: string) {
  const session = await client.checkoutSessions.create({
    product_cart: [{ product_id: productId, quantity: 1 }],
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    return_url: 'https://yoursite.com/success',
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return session.checkout_url;
}

​

Payments API

import DodoPayments from 'dodopayments';

const client = new DodoPayments();

export async function createPayment(productId: string, rekomiRef?: string) {
  const payment = await client.payments.create({
    billing: {
      city: 'New York',
      country: 'US',
      state: 'NY',
      street: '123 Main St',
      zipcode: '10001',
    },
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    product_cart: [{ product_id: productId, quantity: 1 }],
    payment_link: true,
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return payment;
}

​

Links de pagamento estáticos

const ref = window.Rekomi?.getReferral?.();
let url = 'https://checkout.dodopayments.com/buy/YOUR_PRODUCT_ID';
if (ref) url += `?metadata_rekomi_ref=${encodeURIComponent(ref)}`;
// use url as the href on your Buy button

​

O que é rastreado

​

Observações importantes

• A Rekomi registra o endpoint de webhook exatamente com os eventos necessários. Evite editar a lista de eventos desse endpoint no dashboard do Dodo Payments; as verificações de integridade da Rekomi sinalizarão a conexão se algum evento for removido.
• Os testes gratuitos não geram nenhum pagamento até seu término, portanto não há comissão até a primeira cobrança real.
• Desconectar na Rekomi exclui novamente o endpoint de webhook da sua conta do Dodo Payments.

​

Recursos adicionais