Conectar Dodo Payments
Aponte o Dodo Payments para o Clakta com um webhook para receber pagamentos, reembolsos e chargebacks automaticamente, e ligar cada venda ao visitante que a fez.
O Dodo Payments envia seus pagamentos, reembolsos e chargebacks ao Clakta por um webhook: o Clakta te dá um endereço, e você cola esse endereço no Dodo.
Conectar
No Clakta:
- Abra seu projeto e vá em Configurações do projeto → Plataformas de vendas.
- Encontre o Dodo Payments e clique em Conectar.
- Dê à conexão um nome que você vá reconhecer depois, como
Conta principal, e clique em Criar conexão. - Copie a URL do webhook que aparece. Deixe essa janela aberta.
No Dodo Payments:
- Vá em Desenvolvedor → Webhooks → Adicionar endpoint.
- Cole a URL que você copiou.
- Marque os eventos de pagamento, reembolso e disputa (a lista completa está abaixo) e salve.
| Evento | Para que o Clakta usa |
|---|---|
payment.succeeded | Registra a venda. |
payment.processing | Mostra uma venda pendente. |
payment.failed | Registra uma tentativa falha. |
payment.cancelled | Registra um pagamento desistido. |
refund.succeeded | Marca a venda como reembolsada. |
dispute.accepted | Chargeback que você aceitou. |
dispute.lost | Chargeback que você perdeu. |
dispute.won | Chargeback que você ganhou. |
Marcar eventos a mais não atrapalha: o Clakta ignora o que não usa.
- Abra a aba Visão geral do endpoint e copie o Segredo de assinatura que
o Dodo mostra ali. Ele começa com
whsec_.
De volta ao Clakta:
- Cole o valor no campo Chave de assinatura e clique em Concluir.
O card passa a mostrar Adicionada. Vendas novas aparecem poucos segundos depois de pagas. Vendas feitas antes da conexão não são importadas.
Mostrar nomes e preços dos produtos (opcional)
Por padrão, o Clakta registra o dinheiro e o cliente, mas não o que foi comprado: as mensagens do Dodo trazem IDs de produto, não nomes.
Para preencher isso, adicione uma chave de API. No Dodo, vá em Desenvolvedor → Chaves de API, crie uma e cole no campo Chave de API (opcional) da conexão no Clakta. A partir daí, o Clakta busca os nomes e preços dos produtos de cada venda.
Se você pular esta parte, todo o resto continua funcionando: receita, cliente e origem são registrados de qualquer jeito.
Ligar as vendas aos visitantes que as fizeram
Quando seu código criar o link de pagamento ou o checkout do Dodo, adicione um
campo de metadata chamado clakta_session_id e coloque nele a sessão do
visitante no Clakta:
Leia esse valor no navegador com clakta.getSessionId() e envie ao seu servidor
junto com o resto do pedido de checkout.
Modo de teste e modo de produção
O Dodo mantém teste e produção separados, e o Clakta também. Um webhook criado em modo de teste só recebe vendas de teste.
Não tem problema ter duas conexões, uma de teste e outra de produção. Dê nomes que deixem claro qual é qual, porque as duas aparecem no card.
Dúvidas comuns
Artigos relacionados
Conectar Shopify
Instale o app do Clakta na sua loja Shopify. Ele configura o rastreamento de checkout, importa seus pedidos recentes e liga cada venda ao anúncio que a gerou.
Conectar Lemon Squeezy
Envie pedidos, renovações e reembolsos do Lemon Squeezy para o Clakta por webhook e credite cada venda ao visitante que a gerou.
Conectar Paddle
Envie vendas, renovações e reembolsos do Paddle para o Clakta por webhook e credite cada venda ao visitante que a gerou.