Interfaccia a riga di comando per interagire con l’API di Dodo Payments dal tuo terminale
Gestisci le risorse Dodo Payments, crea sessioni di checkout e testa i webhook direttamente dal terminale. Progettato per sviluppatori che preferiscono la riga di comando.
Prima di usare la CLI, autenticati con la tua API key:
dodo login
Questo farà:
Aprire il browser sulla pagina Dodo Payments API Keys
Chiederti di inserire la tua API Key
Chiederti di selezionare l’ambiente (Test Mode o Live Mode)
Memorizzare le tue credenziali localmente in ~/.dodopayments/api-key
La CLI supporta la memorizzazione di una sola API key per ambiente. Se sono configurate sia le chiavi per la modalità test che per quella live, ti verrà chiesto quale ambiente usare per la sessione corrente.
Eseguire dodo senza argomenti mostra tutte le categorie disponibili. Eseguire dodo <category> senza sottocomando mostra i sottocomandi disponibili per quella categoria.
La CLI include due strumenti potenti per testare i webhook durante lo sviluppo: un listener che inoltra i webhook di test live al tuo server locale e un trigger che invia payload webhook simulati a qualsiasi endpoint.
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 (es. http://localhost:3000/webhook).
2
Automatic setup
La CLI crea automaticamente un endpoint webhook sul tuo account Dodo Payments se non esiste già, 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, una modifica di sottoscrizione, ecc.), la CLI lo riceve, registra il tipo di evento e inoltra la richiesta completa con intestazioni e corpo al tuo endpoint locale. La risposta del tuo endpoint viene registrata e reindirizzata.
Il listener webhook funziona solo con una API key in modalità test. Assicurati di aver effettuato l’accesso con una chiave di test prima di usare dodo wh listen.
Il listener preserva le intestazioni originali del webhook (webhook-id, webhook-signature, webhook-timestamp) durante l’inoltro al tuo endpoint locale, così puoi testare la logica di verifica della firma.
Invia payload webhook simulati a qualsiasi endpoint per test rapidi senza dover creare transazioni reali.
dodo wh trigger
Questo ti guida attraverso:
Impostare un URL endpoint di destinazione
Configurare opzionalmente Business ID, Product ID e Metadata
Selezionare un evento specifico da attivare tramite un menu interattivo
Inviare il payload simulato e visualizzare la risposta
Dopo ogni evento, puoi selezionare un altro evento da attivare o uscire — rendendo facile testare più gestori di eventi in una sola sessione.
Lo strumento trigger invia payload simulati senza firme webhook. Disabilita la verifica della firma webhook durante il test usando unsafe_unwrap() invece di unwrap() nel tuo gestore webhook.
