Ce dont vous avez besoin
| Champ | Ce qu'il fait |
|---|---|
| API key | Nous permet d'appeler Dodo pour créer le paiement hébergé. Secrète. |
| Secret de signature de webhook (whsec_…) | Confirme qu'un webhook vient vraiment de Dodo. Secret. |
| Return URL | Où l'acheteur atterrit après le paiement. |
Pourquoi nous demandons chaque champ
API key
Autorise la création du paiement hébergé, pour que le débit passe par votre compte.
Secret de signature de webhook
Prouve qu'un webhook entrant provient bien de Dodo, pour que personne ne puisse falsifier un événement « payé ». C'est une valeur distincte de l'API key.
Return URL
Réglage simple : où l'acheteur atterrit après le paiement. Pas secret.
Configuration
- Utilisez le mode test (gratuit)
Dodo a un environnement de test distinct. Les clés en mode test tournent contre l'hôte de test de Dodo, et aucun argent réel ne bouge.
- Connectez-vous sur app.dodopayments.com.
- Dodo sépare les clés Live et Test. Configurez d'abord en test, puis répétez en live.
- Copiez votre API key
Allez dans Developer → API Keys et copiez la clé Test pour vérifier, ou la clé Live pour encaisser de vrais paiements.
Dodo → Developer → API Keys - Ajoutez le webhook
- Ajoutez un webhook dans Dodo.
- Réglez l'URL du webhook sur l'adresse de webhook de votre projet (ci-dessous).
- Copiez le secret de signature de webhook (whsec_…). Ajoutez un webhook distinct en test et en live.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Connectez dans le tableau de bord
Add provider → Dodo Payments. Saisissez la Return URL et le groupe Live (clé d'API Live, secret de signature de webhook Live). Ajoutez le groupe Test optionnel pour vérifier d'abord. Le groupe Test est apparié : ajoutez à la fois une clé d'API de test et un secret de webhook de test, ou laissez les deux vides. Live et test sont vérifiés séparément.
Après la connexion
Faites un paiement de test avant de passer en live :
- Créez un produit et réglez son Environnement sur Testing. Cela fait tourner le produit sur vos identifiants de test, pour que vous puissiez passer une commande complète sans déplacer d'argent. (Si vous avez sauté le jeu de test, un produit Testing retombe sur le live, donc ajoutez-le d'abord.)
- Placez le bouton d'achat sur une page (un fichier HTML local convient) pointé vers votre projet.
- Finalisez le paiement dans le mode test de Dodo.
- Ouvrez l'onglet Transactions. Une nouvelle ligne apparaît, étiquetée Testing. Quand son statut atteint succeeded, vos identifiants et votre webhook fonctionnent tous deux de bout en bout.
Basculez l'Environnement du produit sur Live quand vous êtes prêt pour de vrais paiements.
Dépannage
Commencez par Vérifier. Dans le tableau de bord, cliquez sur Vérifier (ou Vérifier les identifiants de test) pour contrôler votre API key.
Vérifier les identifiants de test indique qu'aucun identifiant de test n'est enregistré.
Ajoutez une clé d'API de test dans l'onglet Test, enregistrez le fournisseur, puis rouvrez le dialogue et vérifiez.
Le paiement se finalise mais la commande reste en attente.
Confirmez que l'URL du webhook correspond et que le secret de signature correspond au webhook du même environnement (secret de test pour le test, live pour le live).
L'enregistrement du groupe Test est rejeté.
Le groupe Test est apparié : ajoutez à la fois une clé d'API de test et un secret de webhook de test, ou laissez les deux vides.
Confirmez de bout en bout.
Dodo Dashboard → Developer → Webhooks → Send Example (ou la CLI Dodo) pointé vers votre URL de webhook, puis observez la commande se mettre à jour.
Bon à savoir
Paiements uniques seulement. Coin Moebius utilise Dodo pour des paiements uniques, pas des abonnements.
Rotation des secrets. Faites tourner l'API key ou le secret de webhook à tout moment, puis collez la nouvelle valeur. Les champs secrets restent vides à la modification.
Des questions ? Join our Discord