Interface de linha de comando para interagir com a API de Pagamentos Dodo a partir do seu terminal
Gerencie seus recursos do Dodo Payments, crie sessões de checkout e teste webhooks diretamente no terminal. Criado para desenvolvedores que preferem a linha de comando.
Antes de usar a CLI, autentique-se com sua chave de API:
dodo login
Isso irá:
Abrir o navegador na página de Chaves de API do Dodo Payments
Solicitar que você insira sua chave de API
Pedir que você selecione o ambiente (Modo de Teste ou Modo ao Vivo)
Armazenar suas credenciais localmente em ~/.dodopayments/api-key
A CLI suporta armazenar uma chave de API por ambiente. Se as chaves dos modos de teste e ao vivo estiverem configuradas, você será solicitado a escolher qual ambiente usar na sessão atual.
Executar dodo sem argumentos exibe todas as categorias disponíveis. Executar dodo <category> sem subcomando mostra os subcomandos disponíveis para essa categoria.
Criar uma nova sessão de checkout e obter a URL do checkout
O comando checkout suporta opções avançadas, incluindo coleta mínima de endereço, URL de retorno, aplicação de 3D Secure, códigos de desconto e metadados.
A CLI inclui duas ferramentas poderosas para testar webhooks durante o desenvolvimento: um listener que encaminha webhooks de teste ao vivo para seu servidor local e um trigger que envia cargas úteis simuladas para qualquer endpoint.
Encaminhe webhooks da Dodo Payments diretamente para seu servidor de desenvolvimento local em tempo real.
dodo wh listen
1
Enter your local endpoint URL
Forneça a URL local onde deseja receber webhooks (por exemplo, http://localhost:3000/webhook).
2
Automatic setup
A CLI cria automaticamente um endpoint de webhook na sua conta do Dodo Payments se ainda não existir, e então abre uma conexão WebSocket para receber eventos em tempo real.
3
Receive and forward
Quando um evento de webhook é disparado (a partir de um pagamento de teste, alteração de assinatura, etc.), a CLI o recebe, registra o tipo de evento e encaminha a solicitação completa com cabeçalhos e corpo para seu endpoint local. A resposta do seu endpoint é registrada e enviada de volta.
O listener de webhook funciona apenas com uma chave de API de modo de teste. Certifique-se de estar logado com uma chave de modo de teste antes de usar dodo wh listen.
O listener preserva os cabeçalhos originais do webhook (webhook-id, webhook-signature, webhook-timestamp) ao encaminhar para seu endpoint local, para que você possa testar sua lógica de verificação de assinatura.
Envie cargas úteis simuladas para qualquer endpoint para testes rápidos sem precisar criar transações reais.
dodo wh trigger
Isso orienta você por:
Definir a URL de endpoint de destino
Opcionalmente configurar ID do Negócio, ID do Produto e Metadados
Selecionar um evento específico para acionar em um menu interativo
Enviar a carga útil simulada e visualizar a resposta
Após cada evento, você pode selecionar outro evento para acionar ou sair — tornando fácil testar múltiplos manipuladores de evento em uma única sessão.
O trigger envia cargas simuladas sem assinaturas de webhook. Desative a verificação de assinatura durante os testes usando unsafe_unwrap() em vez de unwrap() no seu manipulador de webhook.
