A interface oficial de linha de comando para Dodo Payments — gerencie recursos, execute consultas com inteligência artificial, crie sessões de checkout e teste webhooks a partir do seu terminal.
Gerencie seus recursos de Dodo Payments, execute consultas com inteligência artificial na sua conta, crie sessões de checkout e teste webhooks — tudo a partir do terminal. O CLI é fornecido com uma TUI interativa, um assistente AI integrado com tecnologia MCP e testes de webhooks offline.
TUI interativa — execute dodo sem argumentos para abrir a interface interativa completa com paleta de comandos, histórico e notificações ao vivo.
Assistente AI embutido — faça perguntas ou execute ações em inglês simples com /ai. Nenhuma configuração extra, executa dodopayments-mcp localmente.
Seguro por padrão — Chaves de API são armazenadas no armazenamento de segredos do seu SO (macOS Keychain, Windows Credential Vault, Linux libsecret). Nenhuma configuração em plaintext no disco.
Atualização automática — o CLI verifica novas versões na inicialização e notifica você no aplicativo. Execute /update para atualizar no local.
Ferramentas de webhook — ouça webhooks ao vivo ou dispare cargas úteis offline para desenvolvimento local.
Antes de usar comandos autenticados, faça login com sua chave API:
dodo login
Ou, de dentro da TUI interativa:
/login
O fluxo de login irá:
Abrir seu navegador na página de Chaves API do Dodo Payments.
Solicitar que você cole sua Chave API.
Pedir que você selecione um ambiente — Modo de Teste ou Modo ao Vivo.
Armazenar as credenciais no armazenamento de segredos do seu SO (Keychain no macOS, Credential Vault no Windows, libsecret no Linux).
Como as credenciais são armazenadas no armazenamento de segredos do SO, pode ser solicitado que você insira sua senha do dispositivo na primeira vez que o CLI lê ou escreve credenciais. Se você estiver atualizando de uma versão mais antiga, qualquer chave de API em plaintext existente será migrada para o armazenamento de segredos e o arquivo legado excluído automaticamente.
Execute dodo sem argumentos para iniciar a interface interativa completa:
dodo
Digite / para abrir a paleta de comandos, ou simplesmente comece a digitar — qualquer coisa que não seja um comando de barra é enviada para o assistente AI.
Comando
Descrição
/help
Mostrar a referência de comandos
/update
Verificar e instalar uma atualização do CLI
/login
Autenticar com uma chave de API
/logout
Desconectar de um ou de todos os ambientes
/clear
Limpar a tela da TUI
/exit
Sair da TUI (também: digite exit, ou pressione Esc duas vezes)
Faça perguntas ou aja em linguagem natural. O assistente usa dodopayments-mcp rodando localmente — sem necessidade de configuração adicional ou fluxo OAuth, e seu tráfego AI não sai da sua máquina, exceto para se comunicar com o provedor do modelo.
Comando
Descrição
/ai <query>
Fazer uma pergunta ao assistente AI ou dar uma instrução
(qualquer texto não-slash)
Enviado para o assistente AI por padrão enquanto estiver na TUI
Exemplos:
how much revenue did I make this week?/ai create a new customer named Acme Inc./ai find my last failed payment
O assistente respeita seu ambiente ativo (Teste / Ao Vivo), então ele opera apenas em dados do ambiente em que você está logado.
O CLI inclui duas ferramentas poderosas para testar webhooks durante o desenvolvimento: um ouvinte que encaminha webhooks de teste ao vivo para seu servidor local, e um gatilho que envia cargas úteis de webhook simuladas para qualquer endpoint.
Comando
Descrição
dodo wh listen
Ouça webhooks em tempo real e encaminhe-os para seu servidor local de desenvolvimento
dodo wh trigger
Disparar um evento de webhook de teste de forma interativa — até mesmo se você estiver desconectado
Encaminhe webhooks do 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
O CLI cria automaticamente um endpoint de webhook na sua conta Dodo Payments se um não existir, e depois abre uma conexão WebSocket para receber eventos em tempo real.
3
Receive and forward
Quando um evento de webhook é acionado (a partir de um pagamento de teste, mudança de assinatura, etc.), o CLI o recebe, registra o tipo de evento e encaminha a solicitação completa com cabeçalhos e corpo para o endpoint local. A resposta do seu endpoint é registrada e enviada de volta.
dodo wh listen requer uma chave de API de Modo de Teste. Chaves do modo ao vivo não são suportadas pelo fluxo de escuta.
O ouvinte 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 assinaturas.
Envie cargas úteis de webhook simuladas para qualquer endpoint para testes rápidos sem precisar criar transações reais.
dodo wh trigger
O fluxo /wh trigger guia você por:
Definindo uma URL endpoint de destino
Selecionando um evento específico para desencadear de um menu interativo
dodo wh triggernão requer login. Ele funciona como um gerador de cargas úteis de webhook local/offline.
Os eventos gatilhados não são assinados. Durante os testes, desative a verificação de assinatura de webhook em seu endpoint — por exemplo, use unsafe_unwrap() em vez de unwrap() em seu manipulador de webhook somente durante os testes.
