Interface en ligne de commande pour interagir avec l’API Dodo Payments depuis votre terminal
Gérez vos ressources Dodo Payments, créez des sessions de paiement et testez les webhooks directement depuis le terminal. Conçu pour les développeurs qui préfèrent la ligne de commande.
Avant d’utiliser le CLI, authentifiez-vous avec votre clé d’API :
dodo login
Cela va :
Ouvrir votre navigateur sur la page des clés API Dodo Payments
Vous inviter à saisir votre clé d’API
Vous demander de sélectionner l’environnement (Mode Test ou Mode Live)
Stocker vos identifiants localement dans ~/.dodopayments/api-key
Le CLI prend en charge le stockage d’une clé API par environnement. Si des clés pour le mode test et le mode live sont configurées, il vous sera demandé de choisir l’environnement à utiliser pour la session en cours.
L’exécution de dodo sans argument affiche toutes les catégories disponibles. L’exécution de dodo <category> sans sous-commande affiche les sous-commandes disponibles pour cette catégorie.
Crée une nouvelle session de paiement et récupère l’URL de paiement
La commande de paiement prend en charge des options avancées incluant la collecte minimale d’adresses, l’URL de retour, l’activation 3D Secure, les codes de réduction et les métadonnées.
Le CLI inclut deux outils puissants pour tester les webhooks pendant le développement : un écouteur qui redirige les webhooks de test en direct vers votre serveur local, et un déclencheur qui envoie des charges utiles simulées vers n’importe quel endpoint.
Transférez les webhooks de Dodo Payments directement vers votre serveur de développement local en temps réel.
dodo wh listen
1
Enter your local endpoint URL
Indiquez l’URL locale à laquelle vous souhaitez recevoir les webhooks (par exemple http://localhost:3000/webhook).
2
Automatic setup
Le CLI crée automatiquement un endpoint de webhook sur votre compte Dodo Payments si aucun n’existe déjà, puis ouvre une connexion WebSocket pour recevoir les événements en temps réel.
3
Receive and forward
Lorsqu’un événement de webhook se déclenche (à partir d’un paiement de test, d’un changement d’abonnement, etc.), le CLI le reçoit, enregistre le type d’événement et transmet la requête complète avec les en-têtes et le corps à votre endpoint local. La réponse de votre endpoint est enregistrée et renvoyée.
L’écouteur de webhooks fonctionne uniquement avec une clé API en mode test. Assurez-vous d’être connecté avec une clé en mode test avant d’utiliser dodo wh listen.
L’écouteur conserve les en-têtes Webhook d’origine (webhook-id, webhook-signature, webhook-timestamp) lors du transfert vers votre endpoint local, afin que vous puissiez tester votre logique de vérification de signature.
Envoyez des charges utiles simulées vers n’importe quel endpoint pour des tests rapides sans avoir à créer de vraies transactions.
dodo wh trigger
Cela vous guide à travers :
Définir une URL de destination
Configurer éventuellement un ID d’entreprise, un ID de produit et des métadonnées
Sélectionner un événement spécifique à déclencher depuis un menu interactif
Envoyer la charge utile simulée et visualiser la réponse
Après chaque événement, vous pouvez en sélectionner un autre à déclencher ou quitter — ce qui facilite le test de plusieurs gestionnaires d’événements dans une même session.
L’outil de déclenchement envoie des charges utiles simulées sans signatures de webhook. Désactivez la vérification des signatures de webhook pendant les tests en utilisant unsafe_unwrap() à la place de unwrap() dans votre gestionnaire de webhook.
