Befehlszeilenschnittstelle zur Interaktion mit der Dodo Payments API von Ihrem Terminal aus
Verwalten Sie Ihre Dodo Payments-Ressourcen, erstellen Sie Checkout-Sitzungen und testen Sie Webhooks direkt vom Terminal aus. Entwickelt für Entwickler, die die Befehlszeile bevorzugen.
Authentifizieren Sie sich vor der Verwendung der CLI mit Ihrem API-Schlüssel:
dodo login
Dies wird:
Ihren Browser zur API-Schlüssel-Seite von Dodo Payments öffnen
Sie dazu auffordern, Ihren API-Schlüssel einzugeben
Sie bitten, die Umgebung (Testmodus oder Live-Modus) auszuwählen
Ihre Zugangsdaten lokal speichern, um ~/.dodopayments/api-key
Die CLI unterstützt das Speichern eines API-Schlüssels pro Umgebung. Wenn sowohl Test- als auch Live-Modus-Schlüssel konfiguriert sind, werden Sie aufgefordert, die Umgebung für die aktuelle Sitzung auszuwählen.
Das Ausführen von dodo ohne Argumente zeigt alle verfügbaren Kategorien an. Das Ausführen von dodo <category> ohne Unterbefehl zeigt die verfügbaren Unterbefehle für diese Kategorie an.
Die 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 Mock-Webhooks an beliebige Endpunkte sendet.
Leiten Sie Webhooks von Dodo Payments in Echtzeit direkt an Ihren lokalen Entwicklungsserver weiter.
dodo wh listen
1
Enter your local endpoint URL
Geben Sie die lokale URL an, unter der Sie Webhooks empfangen möchten (z. B. http://localhost:3000/webhook).
2
Automatic setup
Die CLI erstellt automatisch einen Webhook-Endpunkt in Ihrem Dodo Payments-Konto, falls noch keiner vorhanden ist, und öffnet dann eine WebSocket-Verbindung, um Ereignisse in Echtzeit zu empfangen.
3
Receive and forward
Wenn ein Webhook-Ereignis ausgelöst wird (durch eine Testzahlung, Änderung eines Abonnements usw.), empfängt die CLI es, protokolliert den Ereignistyp und leitet die vollständige Anfrage mit Headern und Body an Ihren lokalen Endpunkt weiter. Die Antwort Ihres Endpunkts wird protokolliert und zurückgesendet.
Der Webhook-Listener funktioniert nur mit einem Testmodus-API-Schlüssel. Stellen Sie sicher, dass Sie mit einem Testmodus-Schlüssel angemeldet sind, bevor Sie dodo wh listen verwenden.
Der Listener bewahrt die ursprünglichen Webhook-Header (webhook-id, webhook-signature, webhook-timestamp) beim Weiterleiten an Ihren lokalen Endpunkt, sodass Sie Ihre Signaturprüfungs-Logik testen können.
Senden Sie gefälschte Webhook-Payloads an beliebige Endpunkte, um schnell zu testen, ohne echte Transaktionen erstellen zu müssen.
dodo wh trigger
Dies führt Sie durch:
Festlegung einer Ziel-Endpoint-URL
Optionale Konfiguration von Business ID, Produkt-ID und Metadaten
Auswahl eines bestimmten Ereignisses zum Auslösen über ein interaktives Menü
Senden der Mock-Payload und Anzeigen der Antwort
Nach jedem Ereignis können Sie ein weiteres Ereignis auswählen oder beenden – so lassen sich mehrere Ereignis-Handler in einer Sitzung testen.
Das Trigger-Tool sendet gefälschte Payloads ohne Webhook-Signaturen. Deaktivieren Sie die Webhook-Signaturprüfung während der Tests, indem Sie unsafe_unwrap() anstelle von unwrap() in Ihrem Webhook-Handler verwenden.
