Dodo CLI

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.

​

Caratteristiche

• 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.

​

Installazione

Installa il CLI con una riga su macOS o Linux:

curl -fsSL https://dodopayments.com/install.sh | sh

​

Installa con npm o Bun

Se hai già Node o Bun, le installazioni del gestore pacchetti scaricheranno sempre l’ultima versione:

npm

npm install -g dodopayments-cli

​

Installazione manuale (non è necessario Node / Bun)

Se preferisci non eseguire direttamente uno script remoto su sh, scarica il binario tu stesso.

1. Download the binary

   Scarica il binario per la tua piattaforma dall’ultima GitHub Release.

   Piattaforma	Binario
   macOS (Apple Silicon)	dodo-cli-darwin-arm64
   macOS (Intel)	dodo-cli-darwin-x64
   Linux (x86_64)	dodo-cli-linux-x64
   Linux (arm64)	dodo-cli-linux-arm64
   Windows (x86_64)	dodo-cli-windows-x64.exe

2. Rename the binary to `dodo`

   Linux / macOS

   mv ./dodo-cli-* ./dodo && chmod +x ./dodo
   
3. Move it to a directory on your PATH

   Linux / macOS

   sudo mv ./dodo /usr/local/bin/
   

   Su Windows, spostarsi su C:\Windows\System32 richiede privilegi di amministratore.

4. (Optional) Verify the download

   Ogni rilascio pubblica un SHA256SUMS.txt. Verifica il tuo download con:

   shasum -a 256 -c SHA256SUMS.txt
   

​

Autenticazione

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à:

1. Apri il tuo browser alla pagina delle Chiavi API di Dodo Payments.
2. Ti chiederà di incollare la tua Chiave API.
3. Ti chiederà di selezionare un ambiente — Modalità Test o Modalità Live.
4. 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.

​

Cambiare modalità e disconnettersi

Puoi mantenere una chiave Modalità Test e una Modalità Live autenticata contemporaneamente. Per cancellare le credenziali:

Direct

dodo logout

Il flusso di logout ti permette di scegliere tra Tutti gli account, Modalità Test o Modalità Live in modo indipendente.

​

Uso

Puoi usare il CLI in due modalità.

​

1. TUI interattiva (consigliata)

Esegui dodo senza argomenti per avviare l’interfaccia interattiva completa:

dodo

Digita / per aprire la palette di comandi, o semplicemente inizia a digitare — tutto ciò che non è un comando slash viene inviato all’assistente AI.

Comando	Descrizione
/help	Mostra il riferimento dei comandi
/update	Verifica e installa un aggiornamento del CLI
/login	Autenticati con una chiave API
/logout	Disconnettiti da uno o tutti gli ambienti
/clear	Cancella lo schermo della TUI
/exit	Esci dalla TUI (anche: digita exit, o premi Esc due volte)

​

2. Sottocomandi diretti

Esegui comandi direttamente senza entrare nella TUI:

dodo <category> <sub-command> [args...]

Per esempio:

dodo payments list 1
dodo customers create
dodo wh trigger

Le tabelle di riferimento seguenti mostrano ogni comando. Nella TUI, prefiggili con /; in modalità diretta, rimuovi /.

​

Assistente AI

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.

​

Riferimento Comandi

​

Prodotti

Gestisci il tuo catalogo prodotti.

Comando	Descrizione
dodo products list <page>	Elenca prodotti
dodo products create	Apri il dashboard per creare un prodotto
dodo products info <id>	Visualizza dettagli per un prodotto specifico

​

Pagamenti

Visualizza le transazioni di pagamento.

Comando	Descrizione
dodo payments list <page>	Elenca pagamenti
dodo payments info <id>	Ottieni informazioni su un pagamento specifico

​

Clienti

Gestisci la tua base clienti.

Comando	Descrizione
dodo customers list <page>	Elenca clienti
dodo customers create	Crea un nuovo cliente
dodo customers update <id>	Aggiorna un cliente esistente

​

Sconti

Gestisci coupon e sconti.

Comando	Descrizione
dodo discounts list <page>	Elenca sconti
dodo discounts create	Crea un nuovo sconto basato sulla percentuale
dodo discounts delete <id>	Rimuovi uno sconto per ID

​

Licenze

Gestisci licenze software.

Comando	Descrizione
dodo licences list <page>	Elenca licenze

​

Componenti aggiuntivi

Gestisci componenti aggiuntivi del prodotto.

Comando	Descrizione
dodo addons list <page>	Elenca componenti aggiuntivi
dodo addons create	Apri il dashboard per creare un componente aggiuntivo
dodo addons info <id>	Visualizza dettagli per un componente aggiuntivo specifico

​

Rimborsi

Visualizza informazioni sui rimborsi.

Comando	Descrizione
dodo refunds list <page>	Elenca rimborsi
dodo refunds info <id>	Visualizza dettagli per un rimborso specifico

​

Pagamenti

Crea sessioni di pagamento ospitate.

Comando	Descrizione
dodo checkout new	Crea interattivamente una sessione di pagamento ospitata e ottieni un link di pagamento

​

Webhooks

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

​

Ascolta i webhook

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.

​

Attiva webhooks di test

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:

1. Impostare un URL endpoint di destinazione
2. 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.

​

Eventi webhook supportati

Categoria	Eventi
Abbonamento	active, updated, on_hold, renewed, plan_changed, cancelled, failed, expired
Pagamento	succeeded, failed, processing, cancelled
Rimborso	succeeded, failed
Contestazione	opened, expired, accepted, cancelled, challenged, won, lost
Licenza	created

​

Variabili di ambiente

Variabile	Descrizione
DODO_WH_TEST_SERVER_URL	Sovrascrivi l’URL del server di relay webhook predefinito usato da dodo wh listen

​

Aggiornamenti

Il CLI verifica la presenza di una versione più recente all’avvio e mostra una notifica nella barra di stato quando è disponibile. Per aggiornare:

/update

Oppure, riesegui l’installatore per aggiornare sul posto:

install.sh

curl -fsSL https://dodopayments.com/install.sh | sh

​

Risorse

GitHub Repository

Visualizza codice sorgente e rilasci

npm Package

Visualizza sul registro npm

​

Supporto

• Discord: Unisciti al nostro server community
• GitHub: Apri un problema sul repository
• Email: Contattaci a [e-mail]