L’interface en ligne de commande officielle pour Dodo Payments — gérez les ressources, exécutez des requêtes alimentées par l’IA, créez des sessions de paiement et testez des webhooks depuis votre terminal.
Gérez vos ressources Dodo Payments, exécutez des requêtes alimentées par l’IA sur votre compte, créez des sessions de paiement et testez des webhooks — le tout depuis le terminal. Le CLI est livré avec un TUI interactif, un assistant IA intégré alimenté par MCP, et le test de webhooks hors ligne.
TUI interactif — lancez dodo sans arguments pour ouvrir l’interface interactive complète avec palette de commandes, historique et notifications en direct.
Assistant IA intégré — posez des questions ou effectuez des actions en anglais courant avec /ai. Aucune configuration supplémentaire, fonctionne dodopayments-mcp localement.
Sécurisé par défaut — les clés API sont stockées dans le magasin de secrets de votre système d’exploitation (macOS Keychain, Windows Credential Vault, Linux libsecret). Aucune configuration en texte clair sur le disque.
Mise à jour automatique — le CLI vérifie les nouvelles versions au démarrage et vous en informe dans l’application. Exécutez /update pour mettre à jour sur place.
Outils de webhook — écoutez les webhooks en direct ou déclenchez des charges utiles hors ligne pour le développement local.
Avant d’utiliser des commandes authentifiées, connectez-vous avec votre clé API :
dodo login
Ou, depuis l’intérieur du TUI interactif :
/login
Le flux de connexion :
Ouvrira votre navigateur sur la page des clés API Dodo Payments.
Vous demandera de coller votre clé API.
Vous demandera de sélectionner un environnement — Mode Test ou Mode Live.
Stockera les identifiants dans le magasin de secrets de votre système d’exploitation (Keychain sur macOS, Credential Vault sur Windows, libsecret sur Linux).
Comme les identifiants sont stockés dans le magasin de secrets de l’OS, il se peut que l’on vous demande votre mot de passe de l’appareil la première fois que le CLI lit ou écrit des identifiants. Si vous effectuez une mise à niveau à partir d’une ancienne version, toute clé API existante en texte clair sera migrée vers le magasin de secrets et le fichier héritage supprimé automatiquement.
Exécutez dodo sans arguments pour lancer l’interface interactive complète :
dodo
Tapez / pour ouvrir la palette de commandes, ou commencez simplement à taper — tout ce qui n’est pas une commande en barre oblique est envoyé à l’assistant IA.
Commande
Description
/help
Afficher la référence des commandes
/update
Vérifier et installer une mise à jour du CLI
/login
Authentifier avec une clé API
/logout
Se déconnecter d’un ou tous les environnements
/clear
Effacer l’écran du TUI
/exit
Quitter le TUI (aussi : tapez exit, ou appuyez deux fois sur Esc)
Posez des questions ou effectuez des actions en langage naturel. L’assistant utilise dodopayments-mcp s’exécutant localement — aucune configuration supplémentaire ou flux OAuth requis, et votre trafic IA ne quitte pas votre machine, sauf pour communiquer avec le fournisseur de modèle.
Commande
Description
/ai <query>
Poser une question à l’assistant IA ou lui donner une instruction
(texte non-commande)
Envoyé à l’assistant IA par défaut lors du TUI
Exemples :
how much revenue did I make this week?/ai create a new customer named Acme Inc./ai find my last failed payment
L’assistant respecte votre environnement actif (Test / Live), donc il ne fonctionne que sur les données de l’environnement dans lequel vous êtes actuellement connecté.
Le CLI inclut deux outils puissants pour tester les webhooks pendant le développement : un écouteur qui transfère les webhooks de test en direct à votre serveur local, et un déclencheur qui envoie des charges utiles de webhook fictives à n’importe quel point de terminaison.
Commande
Description
dodo wh listen
Écouter les webhooks en temps réel et les transférer à votre serveur de développement local
dodo wh trigger
Déclencher un événement de webhook de test de manière interactive — même lorsque vous êtes déconnecté
Transférez les webhooks de Dodo Payments directement à votre serveur de développement local en temps réel.
dodo wh listen
1
Enter your local endpoint URL
Fournissez l’URL locale où vous souhaitez recevoir les webhooks (par exemple, http://localhost:3000/webhook).
2
Automatic setup
Le CLI crée automatiquement un point de terminaison webhook sur votre compte Dodo Payments s’il n’en existe pas déjà, puis ouvre une connexion WebSocket pour recevoir des événements en temps réel.
3
Receive and forward
Lorsqu’un événement de webhook est déclenché (suite à un paiement de test, à un changement d’abonnement, etc.), le CLI le reçoit, journalise le type d’événement et transfère la requête complète avec les en-têtes et le corps à votre point de terminaison local. La réponse de votre point de terminaison est journalisée et renvoyée.
dodo wh listen nécessite une clé API Mode Test. Les clés Mode Live ne sont pas prises en charge par le flux d’écoute.
L’écouteur préserve les en-têtes originaux des webhooks (webhook-id, webhook-signature, webhook-timestamp) lors du transfert à votre point de terminaison local, ainsi vous pouvez tester votre logique de vérification de signature.
Envoyez des charges utiles de webhook fictives à n’importe quel point de terminaison pour un test rapide sans besoin de créer de vraies transactions.
dodo wh trigger
Le flux /wh trigger vous guide à travers :
Définir une URL de point de terminaison de destination
Sélectionner un événement spécifique à déclencher à partir d’un menu interactif
dodo wh trigger ne nécessite pas de connexion. Il fonctionne comme un générateur local/hors ligne de charges utiles de webhooks.
Les événements déclenchés ne sont pas signés. Pendant le test, désactivez la vérification de la signature du webhook sur votre point de terminaison — par exemple, utilisez unsafe_unwrap() au lieu de unwrap() dans votre gestionnaire de webhook uniquement pendant le test.
Le CLI vérifie s’il existe une version plus récente au démarrage et affiche une notification dans la barre d’état lorsqu’une est disponible. Pour mettre à jour :
/update
Ou, réexécutez l’installateur pour mettre à jour sur place :
curl -fsSL https://dodopayments.com/install.sh | sh
