O que você precisa
| Campo | O que faz |
|---|---|
| API key | Permite chamarmos o Dodo para criar o checkout hospedado. Secreta. |
| Segredo de assinatura do webhook (whsec_…) | Confirma que um webhook realmente veio do Dodo. Secreto. |
| Return URL | Onde o comprador chega depois do checkout. |
Por que pedimos cada campo
API key
Autoriza a criação do checkout hospedado, para que a cobrança corra pela sua conta.
Segredo de assinatura do webhook
Comprova que um webhook recebido é genuinamente do Dodo, para que ninguém possa forjar um evento de "pago". É um valor separado da API key.
Return URL
Configuração simples: onde o comprador chega depois do checkout. Não é secreta.
Configurar
- Use o modo de teste (gratuito)
O Dodo tem um ambiente de teste separado. As chaves de modo de teste rodam contra o host de teste do Dodo, e nenhum dinheiro real se move.
- Entre em app.dodopayments.com.
- O Dodo separa chaves de produção e de teste. Configure o teste primeiro, depois repita na produção.
- Copie a sua API key
Vá até Developer → API Keys e copie a chave de teste para verificar, ou a chave de produção para receber pagamentos reais.
Dodo → Developer → API Keys - Adicione o webhook
- Adicione um webhook no Dodo.
- Defina a URL do webhook como o endereço de webhook do seu projeto (abaixo).
- Copie o segredo de assinatura do webhook (whsec_…). Adicione um webhook separado no teste e na produção.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Conecte no painel
Adicionar provedor → Dodo Payments. Insira a Return URL e o grupo de produção (API key de produção, segredo de assinatura do webhook de produção). Adicione o grupo de teste opcional para verificar primeiro. O grupo de teste é pareado: adicione tanto uma API key de teste quanto um segredo de webhook de teste, ou deixe ambos em branco. Produção e teste são checados separadamente.
Depois de conectar
Faça um pagamento de teste antes de ir ao ar:
- Crie um produto e defina o Ambiente dele como Teste. Isso roda o produto nas suas credenciais de teste, para que você possa fazer um pedido completo sem mover dinheiro. (Se você pulou o conjunto de teste, um produto de Teste recai para a produção, então adicione-o primeiro.)
- Coloque o botão de compra em uma página (um arquivo HTML local serve) apontado para o seu projeto.
- Conclua o checkout no modo de teste do Dodo.
- Abra a aba Transações. Uma nova linha aparece, marcada como Teste. Quando o status dela chegar a succeeded, as suas credenciais e o webhook estão ambos funcionando de ponta a ponta.
Mude o Ambiente do produto para Produção quando você estiver pronto para pagamentos reais.
Solução de problemas
Comece com Verificar. No painel, clique em Verificar (ou Verificar credenciais de teste) para checar a sua API key.
Verificar credenciais de teste diz que nenhuma credencial de teste foi salva.
Adicione uma API key de teste na aba Teste, salve o provedor, depois reabra o diálogo e verifique.
O pagamento se conclui mas o pedido fica pendente.
Confirme que a URL do webhook coincide e que o segredo de assinatura coincide com o webhook no mesmo ambiente (segredo de teste para teste, de produção para produção).
Salvar o grupo de Teste é rejeitado.
O grupo de teste é pareado: adicione tanto uma API key de teste quanto um segredo de webhook de teste, ou deixe ambos em branco.
Confirme de ponta a ponta.
Dodo Dashboard → Developer → Webhooks → Send Example (ou o Dodo CLI) apontado para a sua URL de webhook, depois observe o pedido atualizar.
Bom saber
Apenas pagamentos únicos. Coin Moebius usa o Dodo para pagamentos únicos, não assinaturas.
Rotacionando segredos. Rotacione a API key ou o segredo do webhook quando quiser, depois cole o novo valor. Os campos secretos ficam em branco na edição.
Dúvidas? Join our Discord