Dodo CLI

Verwalte deine Dodo Payments-Ressourcen, führe KI-gestützte Abfragen für dein Konto aus, erstelle Checkout-Sitzungen und teste Webhooks — alles über das Terminal. Die CLI verfügt über eine interaktive TUI, einen integrierten KI-Assistenten powered by MCP sowie Offline-Webhook-Tests.

Funktionen

Interaktive TUI — starte dodo ohne Argumente, um die vollständige interaktive Oberfläche mit Befehlspalette, Verlauf und Live-Benachrichtigungen zu öffnen.
Integrierter KI-Assistent — stelle Fragen oder führe Aktionen in natürlicher Sprache mit /ai aus. Keine zusätzliche Einrichtung erforderlich, läuft lokal mit dodopayments-mcp.
Standardmäßig sicher — API keys werden im Geheimnisspeicher deines Betriebssystems abgelegt (macOS Keychain, Windows Credential Vault, Linux libsecret). Keine Klartextkonfiguration auf der Festplatte.
Automatische Aktualisierung — die CLI sucht beim Start nach neuen Versionen und benachrichtigt dich in der App. Führe /update aus, um direkt zu aktualisieren.
Webhook-Tools — empfange Live-Webhooks oder löse Payloads für die lokale Entwicklung offline aus.

Installation

Installiere die CLI mit einer einzigen Zeile unter macOS oder Linux:

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

Mit npm oder Bun installieren

Wenn du bereits Node oder Bun verwendest, installieren die Paketmanager immer die neueste Version:

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Manuelle Installation (keine Node-/Bun-Installation erforderlich)

Wenn du lieber kein entferntes Skript an sh weiterleiten möchtest, lade die Binärdatei selbst herunter.

Download the binary

Lade die Binärdatei für deine Plattform aus dem neuesten GitHub Release herunter.

Plattform	Binärdatei
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`

Rename the binary to `dodo`

mv ./dodo-cli-* ./dodo && chmod +x ./dodo

ren .\dodo-cli-windows-x64.exe .\dodo.exe

Move it to a directory on your PATH

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

move .\dodo.exe C:\Windows\System32\dodo.exe

Unter Windows erfordert das Verschieben nach C:\Windows\System32 Administratorrechte.

(Optional) Verify the download

Jede Version veröffentlicht einen SHA256SUMS.txt. Überprüfe deinen Download mit:

shasum -a 256 -c SHA256SUMS.txt

Authentifizierung

Melde dich vor der Verwendung authentifizierter Befehle mit deinem API key an:

dodo login

Oder innerhalb der interaktiven TUI:

/login

Der Anmeldevorgang:

Öffnet deinen Browser auf der Seite für Dodo Payments API Keys.
Fordert dich auf, deinen API Key einzufügen.
Bittet dich, eine Umgebung auszuwählen — Test Mode oder Live Mode.
Speichert die Zugangsdaten im Geheimnisspeicher deines Betriebssystems (Keychain unter macOS, Credential Vault unter Windows, libsecret unter Linux).

Da die Zugangsdaten im Geheimnisspeicher des Betriebssystems gespeichert werden, wirst du möglicherweise beim ersten Lesen oder Schreiben von Zugangsdaten durch die CLI nach deinem Gerätepasswort gefragt. Wenn du von einer älteren Version aktualisierst, wird ein vorhandener API key automatisch in den Geheimnisspeicher migriert und die alte Datei gelöscht.

Modi wechseln und abmelden

Du kannst gleichzeitig jeweils einen authentifizierten Schlüssel für Test Mode und Live Mode speichern. So löschst du Zugangsdaten:

dodo logout

/logout

Beim Abmeldevorgang kannst du unabhängig zwischen All accounts, Test Mode und Live Mode wählen.

Verwendung

Du kannst die CLI in zwei Modi verwenden.

1. Interaktive TUI (empfohlen)

Führe dodo ohne Argumente aus, um die vollständige interaktive Oberfläche zu starten:

dodo

Gib / ein, um die Befehlspalette zu öffnen, oder beginne einfach zu tippen — alles, was kein Slash-Befehl ist, wird an den KI-Assistenten gesendet.

Befehl	Beschreibung
`/help`	Befehlsreferenz anzeigen
`/update`	Nach einem CLI-Update suchen und es installieren
`/login`	Mit einem API key authentifizieren
`/logout`	Von einer oder allen Umgebungen abmelden
`/clear`	TUI-Bildschirm leeren
`/exit`	TUI beenden (auch: `exit` eingeben oder `Esc` zweimal drücken)

2. Direkte Unterbefehle

Führe Befehle direkt aus, ohne die TUI zu öffnen:

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

Beispiel:

dodo payments list 1
dodo customers create
dodo wh trigger

Die folgenden Referenztabellen zeigen alle Befehle. Setze ihnen in der TUI / voran; lasse / im direkten Modus weg.

KI-Assistent

Stelle Fragen oder führe Aktionen in natürlicher Sprache aus. Der Assistent verwendet dodopayments-mcp, das lokal ausgeführt wird — keine zusätzliche Einrichtung oder OAuth-Ablauf erforderlich. Dein KI-Datenverkehr verlässt dein Gerät nur zur Kommunikation mit dem Modellanbieter.

Befehl	Beschreibung
`/ai <query>`	Dem KI-Assistenten eine Frage stellen oder eine Anweisung geben
(beliebiger Text ohne Slash)	Wird in der TUI standardmäßig an den KI-Assistenten gesendet

Beispiele:

how much revenue did I make this week?
/ai create a new customer named Acme Inc.
/ai find my last failed payment

Der Assistent berücksichtigt deine aktive Umgebung (Test / Live) und arbeitet daher nur mit Daten aus der Umgebung, in der du aktuell angemeldet bist.

Projektgerüst

dodo init erstellt Dodo Payments-Abrechnungsrouten direkt in einem vorhandenen Projekt. Der Befehl generiert die erforderlichen Route-Dateien, installiert das passende @dodopayments/*-Adapterpaket und schreibt die DODO_PAYMENTS_*-Umgebungsvariablen sicher in deine .env (es werden nur Variablen angehängt, die noch nicht vorhanden sind). Der Befehl läuft ohne Anmeldung.

dodo init <framework>

Gerüst	Beschreibung
`dodo init nextjs`	Erstellt Abrechnungsrouten für den Next.js App Router (Checkout, Kundenportal und Webhook-Handler) mit `@dodopayments/nextjs`
`dodo init express`	Erstellt Abrechnungsrouten für einen Express-Server mit `@dodopayments/express`
`dodo init better-auth`	Erstellt eine Better-Auth-Pluginkonfiguration mit `@dodopayments/better-auth`

Für das Better-Auth-Gerüst kannst du eine durch Kommas getrennte Liste von Plugins übergeben, die generiert werden sollen (standardmäßig alle): checkout, portal, usage, webhooks.

# Scaffold every Better-Auth plugin (default)
dodo init better-auth

# Scaffold only specific plugins
dodo init better-auth checkout,portal

Das Gerüst erkennt automatisch ein src/-Verzeichnis und passt die Ausgabepfade entsprechend an. Außerdem wird dein Paketmanager automatisch erkannt (bun, pnpm, yarn oder npm), um den richtigen Installationsbefehl auszuführen.

Befehlsreferenz

Produkte

Verwalte deinen Produktkatalog.

Befehl	Beschreibung
`dodo products list <page>`	Produkte auflisten
`dodo products create`	Dashboard zum Erstellen eines Produkts öffnen
`dodo products info <id>`	Details zu einem bestimmten Produkt anzeigen

Zahlungen

Zahlungstransaktionen anzeigen.

Befehl	Beschreibung
`dodo payments list <page>`	Zahlungen auflisten
`dodo payments info <id>`	Informationen zu einer bestimmten Zahlung abrufen

Kunden

Verwalte deinen Kundenstamm.

Befehl	Beschreibung
`dodo customers list <page>`	Kunden auflisten
`dodo customers create`	Neuen Kunden erstellen
`dodo customers update <id>`	Bestehenden Kunden aktualisieren

Rabatte

Verwalte Gutscheine und Rabatte.

Befehl	Beschreibung
`dodo discounts list <page>`	Rabatte auflisten
`dodo discounts create`	Neuen prozentualen Rabatt erstellen
`dodo discounts delete <id>`	Rabatt anhand der ID entfernen

Lizenzen

Verwalte Softwarelizenzen.

Befehl	Beschreibung
`dodo licences list <page>`	Lizenzen auflisten

Add-ons

Verwalte Produkt-Add-ons.

Befehl	Beschreibung
`dodo addons list <page>`	Add-ons auflisten
`dodo addons create`	Dashboard zum Erstellen eines Add-ons öffnen
`dodo addons info <id>`	Details zu einem bestimmten Add-on anzeigen

Rückerstattungen

Informationen zu Rückerstattungen anzeigen.

Befehl	Beschreibung
`dodo refunds list <page>`	Rückerstattungen auflisten
`dodo refunds info <id>`	Details zu einer bestimmten Rückerstattung anzeigen

Checkout

Gehostete Checkout-Sitzungen erstellen.

Befehl	Beschreibung
`dodo checkout new`	Interaktiv eine gehostete Checkout-Sitzung erstellen und einen Zahlungslink abrufen

Webhooks

Die CLI enthält zwei leistungsstarke Tools zum Testen von Webhooks während der Entwicklung: einen Listener, der Live-Test-Webhooks an deinen lokalen Server weiterleitet, und einen Trigger, der simulierte Webhook-Payloads an jeden Endpunkt sendet.

Befehl	Beschreibung
`dodo wh listen`	Webhooks in Echtzeit empfangen und an deinen lokalen Entwicklungsserver weiterleiten
`dodo wh trigger`	Interaktiv ein Test-Webhook-Ereignis auslösen — auch ohne Anmeldung

Webhooks empfangen

Leite Webhooks von Dodo Payments in Echtzeit direkt an deinen lokalen Entwicklungsserver weiter.

dodo wh listen

Enter your local endpoint URL

Gib die lokale URL an, unter der du Webhooks empfangen möchtest (z. B. http://localhost:3000/webhook).

Automatic setup

Die CLI erstellt automatisch einen Webhook-Endpunkt in deinem Dodo Payments-Konto, falls noch keiner vorhanden ist, und öffnet anschließend eine WebSocket-Verbindung, um Ereignisse in Echtzeit zu empfangen.

Receive and forward

Wenn ein Webhook-Ereignis ausgelöst wird (etwa durch eine Testzahlung oder eine Abonnementänderung), empfängt die CLI es, protokolliert den Ereignistyp und leitet die vollständige Anfrage mit Headern und Body an deinen lokalen Endpunkt weiter. Die Antwort deines Endpunkts wird protokolliert und zurückgesendet.

dodo wh listen erfordert einen Test Mode API key. Live Mode-Schlüssel werden vom Listener nicht unterstützt.

Der Listener bewahrt beim Weiterleiten an deinen lokalen Endpunkt die ursprünglichen Webhook-Header (webhook-id, webhook-signature, webhook-timestamp), damit du deine Logik zur Signaturüberprüfung testen kannst.

Test-Webhooks auslösen

Sende simulierte Webhook-Payloads für schnelle Tests an einen beliebigen Endpunkt, ohne echte Transaktionen erstellen zu müssen.

dodo wh trigger

Der Ablauf von /wh trigger führt dich durch folgende Schritte:

Festlegen einer Endpunkt-URL als Ziel
Auswählen eines bestimmten Ereignisses, das über ein interaktives Menü ausgelöst werden soll

dodo wh trigger erfordert keine Anmeldung. Es funktioniert als lokaler/offline Webhook-Payload-Generator.

Ausgelöste Ereignisse sind nicht signiert. Deaktiviere während des Testens die Webhook-Signaturüberprüfung an deinem Endpunkt — verwende beispielsweise in deinem Webhook-Handler nur während des Testens unsafe_unwrap() anstelle von unwrap().

Unterstützte Webhook-Ereignisse

Kategorie	Ereignisse
Abonnement	`active`, `updated`, `on_hold`, `renewed`, `plan_changed`, `cancelled`, `failed`, `expired`
Zahlung	`succeeded`, `failed`, `processing`, `cancelled`
Rückerstattung	`succeeded`, `failed`
Dispute	`opened`, `expired`, `accepted`, `cancelled`, `challenged`, `won`, `lost`
Lizenz	`created`

Umgebungsvariablen

Variable	Beschreibung
`DODO_WH_TEST_SERVER_URL`	Überschreibt die standardmäßige URL des Webhook-Relay-Servers, die von `dodo wh listen` verwendet wird

Aktualisierungen

Die CLI sucht beim Start nach einer neueren Version und zeigt bei Verfügbarkeit eine Benachrichtigung in der Statusleiste an. So aktualisierst du sie:

/update

Oder führe das Installationsprogramm erneut aus, um die bestehende Installation zu aktualisieren:

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

npm install -g dodopayments-cli

bun install -g dodopayments-cli

Ressourcen

GitHub Repository

Quellcode und Releases anzeigen

npm Package

In der npm-Registry anzeigen

Support

Discord: Tritt unserem Community-Server bei
GitHub: Öffne ein Issue im Repository
E-Mail: Kontaktiere uns unter support@dodopayments.com

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Funktionen

Installation

Mit npm oder Bun installieren

Manuelle Installation (keine Node-/Bun-Installation erforderlich)

Authentifizierung

Modi wechseln und abmelden

Verwendung

1. Interaktive TUI (empfohlen)

2. Direkte Unterbefehle

KI-Assistent

Projektgerüst

Befehlsreferenz

Produkte

Zahlungen

Kunden

Rabatte

Lizenzen

Add-ons

Rückerstattungen

Checkout

Webhooks

Webhooks empfangen

Test-Webhooks auslösen

Unterstützte Webhook-Ereignisse

Umgebungsvariablen

Aktualisierungen

Ressourcen

GitHub Repository

npm Package

Support

​Funktionen

​Installation

​Mit npm oder Bun installieren

​Manuelle Installation (keine Node-/Bun-Installation erforderlich)

​Authentifizierung

​Modi wechseln und abmelden

​Verwendung

​1. Interaktive TUI (empfohlen)

​2. Direkte Unterbefehle

​KI-Assistent

​Projektgerüst

​Befehlsreferenz

​Produkte

​Zahlungen

​Kunden

​Rabatte

​Lizenzen

​Add-ons

​Rückerstattungen

​Checkout

​Webhooks

​Webhooks empfangen

​Test-Webhooks auslösen

​Unterstützte Webhook-Ereignisse

​Umgebungsvariablen

​Aktualisierungen

​Ressourcen

GitHub Repository

npm Package

​Support

Funktionen

Installation

Mit npm oder Bun installieren

Manuelle Installation (keine Node-/Bun-Installation erforderlich)

Authentifizierung

Modi wechseln und abmelden

Verwendung

1. Interaktive TUI (empfohlen)

2. Direkte Unterbefehle

KI-Assistent

Projektgerüst

Befehlsreferenz

Produkte

Zahlungen

Kunden

Rabatte

Lizenzen

Add-ons

Rückerstattungen

Checkout

Webhooks

Webhooks empfangen

Test-Webhooks auslösen

Unterstützte Webhook-Ereignisse

Umgebungsvariablen

Aktualisierungen

Ressourcen

Support