L’interfaccia a riga di comando ufficiale per Dodo Payments — gestisci risorse, esegui query alimentate da AI, crea sessioni di pagamento e testa webhook dal tuo terminale.
Gestisci le tue risorse di Dodo Payments, esegui query alimentate da AI sul tuo account, crea sessioni di pagamento e testa i webhook — tutto dal terminale. Il CLI viene fornito con un’interfaccia utente interattiva, un assistente AI integrato alimentato da MCP e test di webhook offline.
TUI interattiva — avvia dodo senza argomenti per aprire l’interfaccia interattiva completa con palette di comandi, cronologia e notifiche in tempo reale.
Assistente AI integrato — fai domande o esegui azioni in inglese semplice con /ai. Nessuna configurazione extra, esegue dodopayments-mcp localmente.
Sicurezza predefinita — le chiavi API sono memorizzate nel sistema di sicurezza del tuo OS (macOS Keychain, Windows Credential Vault, Linux libsecret). Nessuna configurazione in chiaro sul disco.
Aggiornamento automatico — il CLI verifica la presenza di nuove versioni all’avvio e ti notifica all’interno dell’app. Esegui /update per aggiornare sul posto.
Strumenti per webhook — ascolta i webhook in tempo reale o attiva payload offline per lo sviluppo locale.
Prima di usare comandi autenticati, esegui l’accesso con la tua chiave API:
dodo login
Oppure, dall’interno della TUI interattiva:
/login
Il flusso di accesso farà:
Apri il tuo browser alla pagina delle Chiavi API di Dodo Payments.
Ti chiederà di incollare la tua Chiave API.
Ti chiederà di selezionare un ambiente — Modalità Test o Modalità Live.
Memorizza le credenziali nel sistema di sicurezza del tuo OS (Keychain su macOS, Credential Vault su Windows, libsecret su Linux).
Poiché le credenziali sono memorizzate nel sistema di sicurezza del OS, potresti essere invitato a inserire la tua password del dispositivo la prima volta che il CLI legge o scrive le credenziali. Se stai eseguendo l’aggiornamento da una versione precedente, qualsiasi chiave API in chiaro esistente verrà migrata nel sistema di sicurezza e il file legacy eliminato automaticamente.
Fai domande o esegui azioni in linguaggio naturale. L’assistente utilizza dodopayments-mcp eseguito localmente — non è richiesta alcuna configurazione aggiuntiva o flusso OAuth, e il tuo traffico AI non lascia la tua macchina tranne che per comunicare con il fornitore del modello.
Comando
Descrizione
/ai <query>
Chiedi una domanda all’assistente AI o dagli un’istruzione
(qualsiasi testo non slash)
Inviato all’assistente AI come predefinito quando si è nella TUI
Esempi:
how much revenue did I make this week?/ai create a new customer named Acme Inc./ai find my last failed payment
L’assistente rispetta il tuo ambiente attivo (Test / Live), quindi opera solo sui dati dell’ambiente in cui sei attualmente connesso.
Il CLI include due potenti strumenti per testare i webhook durante lo sviluppo: un listener che inoltra i webhook di test dal vivo al tuo server locale, e un trigger che invia payload di webhook simulati a qualsiasi endpoint.
Comando
Descrizione
dodo wh listen
Ascolta i webhook in tempo reale e inoltrali al tuo server di sviluppo locale
dodo wh trigger
Attiva un evento webhook di test in modo interattivo — anche mentre sei disconnesso
Inoltra i webhook da Dodo Payments direttamente al tuo server di sviluppo locale in tempo reale.
dodo wh listen
1
Enter your local endpoint URL
Fornisci l’URL locale dove desideri ricevere i webhook (ad esempio, http://localhost:3000/webhook).
2
Automatic setup
Il CLI crea automaticamente un endpoint webhook sul tuo account Dodo Payments se non ne esiste già uno, quindi apre una connessione WebSocket per ricevere eventi in tempo reale.
3
Receive and forward
Quando si verifica un evento webhook (da un pagamento di test, cambiamento di abbonamento, ecc.), il CLI lo riceve, registra il tipo di evento e inoltra la richiesta completa con intestazioni e corpo al tuo endpoint locale. La risposta dal tuo endpoint viene registrata e inviata indietro.
dodo wh listen richiede una chiave API in Modalità Test. Le chiavi Modalità Live non sono supportate dal flusso di ascolto.
Il listener preserva le intestazioni webhook originali (webhook-id, webhook-signature, webhook-timestamp) quando le inoltra al tuo endpoint locale, così puoi testare la tua logica di verifica della firma.
Invia payload di webhook simulati a qualsiasi endpoint per effettuare test rapidi senza necessità di creare transazioni reali.
dodo wh trigger
Il flusso /wh trigger ti guida attraverso:
Impostare un URL endpoint di destinazione
Selezionare un evento specifico da attivare da un menu interattivo
dodo wh trigger non richiede accesso. Funziona come generatore di payload webhook locale/offline.
Gli eventi attivati non sono firmati. Durante i test, disabilita la verifica della firma del webhook sul tuo endpoint — ad esempio, usa unsafe_unwrap() invece di unwrap() nel tuo handler webhook solo durante i test.
