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.
dodo init cria rotas de cobrança do Dodo Payments diretamente em um projeto existente. Ele gera os arquivos de boilerplate da rota, instala o pacote adaptador correspondente @dodopayments/*, e grava com segurança as variáveis de ambiente DODO_PAYMENTS_* no seu .env (apenas adiciona variáveis que ainda não estão presentes). O comando é executado sem fazer login.
dodo init <framework>
Scaffold
Descrição
dodo init nextjs
Cria rotas de cobrança do App Router do Next.js (checkout, portal do cliente e manipuladores de webhook) usando @dodopayments/nextjs
dodo init express
Cria rotas de cobrança do servidor Express usando @dodopayments/express
dodo init better-auth
Cria uma configuração de plugin Better-Auth usando @dodopayments/better-auth
Para o scaffold Better-Auth, você pode passar uma lista separada por vírgulas de plugins para gerar (o padrão é todos): checkout, portal, usage, webhooks.
# Scaffold every Better-Auth plugin (default)dodo init better-auth# Scaffold only specific pluginsdodo init better-auth checkout,portal
O scaffolder detecta automaticamente um diretório src/ e ajusta os caminhos de saída de acordo, além de detectar automaticamente seu gerenciador de pacotes (bun, pnpm, yarn ou npm) para executar o comando de instalação correto.
A 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 de webhook simuladas para qualquer endpoint.
Comando
Descrição
dodo wh listen
Ouvir webhooks em tempo real e encaminhá-los para seu servidor de desenvolvimento local
dodo wh trigger
Disparar um evento de webhook de teste interativamente — mesmo sem estar logado
Encaminhar 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 (ex., http://localhost:3000/webhook).
2
Automatic setup
A CLI cria automaticamente um endpoint de webhook em sua conta Dodo Payments se um 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 (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.
dodo wh listen requer uma chave de API em Modo de Teste. As chaves de 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 assinatura.
Envie cargas de webhook simuladas para qualquer endpoint para testes rápidos sem a necessidade de criar transações reais.
dodo wh trigger
O fluxo /wh trigger conduz você por:
Configurar uma URL de destino do endpoint
Selecionar um evento específico para disparar a partir de um menu interativo
dodo wh triggernão requer login. Funciona como um gerador de carga de webhook local/offline.
Os eventos disparados não são assinados. Durante os testes, desative a verificação de assinatura do webhook no seu endpoint — por exemplo, use unsafe_unwrap() em vez de unwrap() no manipulador de webhook apenas durante os testes.
