Die offizielle Befehlszeilenschnittstelle für Dodo Payments – verwalten Sie Ressourcen, führen Sie KI-gestützte Abfragen aus, erstellen Sie Checkout-Sitzungen und testen Sie Webhooks über Ihr Terminal.
Verwalten Sie Ihre Dodo Payments-Ressourcen, führen Sie KI-gestützte Abfragen gegen Ihr Konto aus, erstellen Sie Checkout-Sitzungen und testen Sie Webhooks – alles vom Terminal aus. Das CLI wird mit einem interaktiven TUI, einem integrierten KI-Assistenten, der von MCP betrieben wird, und Offline-Webhook-Tests geliefert.
Interaktives TUI — starten Sie dodo ohne Argumente, um die vollständige interaktive Oberfläche mit Befehlsübersicht, Verlauf und Live-Benachrichtigungen zu öffnen.
Integrierter KI-Assistent — stellen Sie Fragen oder führen Sie Aktionen in einfachem Englisch mit /ai durch. Keine zusätzliche Einrichtung erforderlich, läuft dodopayments-mcp lokal.
Standardmäßig sicher — API-Schlüssel werden in Ihrem OS-Geheimnisspeicher (macOS-Schlüsselbund, Windows Credential Vault, Linux libsecret) gespeichert. Keine Klartextkonfiguration auf der Festplatte.
Automatische Aktualisierung — das CLI überprüft bei jedem Start auf neue Versionen und benachrichtigt Sie in der App. Führen Sie /update aus, um vor Ort zu aktualisieren.
Webhook-Tools — hören Sie auf Live-Webhooks oder lösen Sie Payloads offline für die lokale Entwicklung aus.
Bevor Sie authentifizierte Befehle verwenden, melden Sie sich mit Ihrem API-Schlüssel an:
dodo login
Oder innerhalb des interaktiven TUI:
/login
Der Anmeldeablauf wird:
Ihren Browser zur Dodo Payments API-Keys-Seite öffnen.
Sie auffordern, Ihren API-Schlüssel einzugeben.
Sie bitten, eine Umgebung auszuwählen – Testmodus oder Live-Modus.
Die Anmeldeinformationen in Ihrem OS-Geheimnisspeicher speichern (Keychain auf macOS, Credential Vault auf Windows, libsecret auf Linux).
Da Anmeldeinformationen im OS-Geheimnisspeicher gespeichert werden, werden Sie möglicherweise aufgefordert, Ihr Gerätepasswort einzugeben, wenn das CLI zum ersten Mal Anmeldeinformationen liest oder schreibt. Wenn Sie von einer älteren Version aktualisieren, wird ein vorhandener Klartext-API-Schlüssel automatisch in den Geheimnisspeicher migriert und die alte Datei gelöscht.
Führen Sie dodo ohne Argumente aus, um die vollständige interaktive Oberfläche zu starten:
dodo
Geben Sie / ein, um die Befehlsübersicht zu öffnen, oder beginnen Sie einfach mit der Eingabe – alles, was kein Slash-Befehl ist, wird an den KI-Assistenten gesendet.
Befehl
Beschreibung
/help
Befehlsreferenz anzeigen
/update
Überprüfen und eine CLI-Aktualisierung installieren
/login
Mit einem API-Schlüssel authentifizieren
/logout
Von einem oder allen Umgebungen abmelden
/clear
TUI-Bildschirm löschen
/exit
TUI beenden (auch: exit eingeben oder Esc zweimal drücken)
Stellen Sie Fragen oder führen Sie Aktionen in natürlicher Sprache aus. Der Assistent verwendet dodopayments-mcp, der lokal läuft – keine zusätzliche Einrichtung oder OAuth-Fluss erforderlich, und Ihr KI-Verkehr verlässt Ihre Maschine nicht, außer zur Kommunikation mit dem Modellanbieter.
Befehl
Beschreibung
/ai <query>
Stellen Sie dem KI-Assistenten eine Frage oder geben Sie ihm eine Anweisung
(jeder Text, der kein Slash ist)
Standardmäßig an den KI-Assistenten gesendet, während im TUI
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 respektiert Ihre aktive Umgebung (Test / Live), sodass er nur auf Daten aus der Umgebung zugreift, in der Sie derzeit angemeldet sind.
Das CLI enthält zwei leistungsstarke Tools zum Testen von Webhooks während der Entwicklung: einen Listener, der Live-Test-Webhooks an Ihren lokalen Server weiterleitet, und einen Trigger, der simulierte Webhook-Payloads an beliebige Endpunkte sendet.
Befehl
Beschreibung
dodo wh listen
In Echtzeit Webhooks abhören und an Ihren lokalen Entwickler-Server weiterleiten
dodo wh trigger
Test-Webhook-Ereignis interaktiv auslösen – auch im abgemeldeten Zustand
Leiten Sie Webhooks von Dodo Payments direkt an Ihren lokalen Entwicklungsserver in Echtzeit weiter.
dodo wh listen
1
Enter your local endpoint URL
Geben Sie die lokale URL ein, an die Sie Webhooks empfangen möchten (z.B. http://localhost:3000/webhook).
2
Automatic setup
Das CLI erstellt automatisch einen Webhook-Endpunkt in Ihrem Dodo Payments-Konto, falls noch keiner existiert, und öffnet eine WebSocket-Verbindung, um Ereignisse in Echtzeit zu empfangen.
3
Receive and forward
Wenn ein Webhook-Ereignis ausgelöst wird (von einer Testzahlung, einer Abonnementänderung usw.), empfängt es das CLI, protokolliert den Ereignistyp und leitet die vollständige Anfrage mit Headers und Body an Ihren lokalen Endpunkt weiter. Die Antwort Ihres Endpunkts wird protokolliert und zurückgesendet.
dodo wh listen erfordert einen Testmodus-API-Schlüssel. Live-Modus-Schlüssel werden vom Abhörvorgang nicht unterstützt.
Der Listener bewahrt die originalen Webhook-Header (webhook-id, webhook-signature, webhook-timestamp) beim Weiterleiten an Ihren lokalen Endpunkt, sodass Sie Ihre Signaturprüfungslogik testen können.
Senden Sie simulierte Webhook-Payloads an jeden Endpunkt für schnelles Testen, ohne echte Transaktionen erstellen zu müssen.
dodo wh trigger
Der /wh trigger Flow führt Sie durch:
Festlegen einer Ziel-Endpunkt-URL
Auswählen eines spezifischen Ereignisses, das aus einem interaktiven 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. Während des Testens schalten Sie die Webhook-Signaturprüfung an Ihrem Endpunkt ab – verwenden Sie zum Beispiel unsafe_unwrap() anstelle von unwrap() in Ihrem Webhook-Handler nur während des Testens.
Das CLI überprüft bei jedem Start auf eine neuere Version und zeigt eine Benachrichtigung in der Statusleiste an, wenn eine verfügbar ist. Um zu aktualisieren:
/update
Oder führen Sie den Installer erneut aus, um vor Ort zu aktualisieren:
curl -fsSL https://dodopayments.com/install.sh | sh
