Skip to main content

​
Introduction

Le plugin Dodo Payments for WooCommerce ajoute Dodo Payments comme mode de paiement au checkout de votre boutique. Les clients paient sur la page de checkout de Dodo Payments, qui affiche les modes de paiement disponibles selon leur emplacement, leur devise et leur appareil, comme les cartes, les portefeuilles numériques et UPI. Les webhooks de Dodo Payments mettent ensuite à jour le statut de la commande dans WooCommerce.
Le plugin nécessite WordPress 6.1 ou une version ultérieure, PHP 7.4 ou une version ultérieure, et WooCommerce 7.9 ou une version ultérieure. Pour vendre des abonnements, vous avez également besoin de l’extension WooCommerce Subscriptions.
Le plugin fonctionne avec le checkout WooCommerce classique. Il ne prend pas en charge le checkout basé sur les blocs ni l’expédition de produits physiques, et n’accepte qu’un seul code de réduction en pourcentage par commande.

​
Guide d’installation étape par étape

  1. Téléchargez dodo-payments-for-woocommerce.zip depuis la dernière version publiée sur GitHub.

    Download Plugin

    Obtenez la dernière version du plugin Dodo Payments pour WooCommerce
    Vous pouvez également installer le plugin depuis le répertoire des plugins WordPress. Sur la page Add Plugins, recherchez Dodo Payments for WooCommerce, cliquez sur Install Now, puis sur Activate, et poursuivez avec le guide de configuration.

    WordPress Plugin Directory

    Installer Dodo Payments for WooCommerce depuis WordPress.org
  2. Connectez-vous à votre site WordPress en tant qu’administrateur. WooCommerce doit être installé et activé.
  3. Accédez à Plugins → Add New Plugin.
    Barre latérale d'administration WordPress avec le menu Plugins ouvert
  4. Cliquez sur Upload Plugin. Un formulaire de téléchargement apparaît.
    Page Add Plugins avec le bouton Upload Plugin
    Formulaire de téléchargement du plugin avec un bouton Browse et un bouton Install Now
  5. Cliquez sur Browse… et sélectionnez le fichier zip que vous avez téléchargé.
  6. Cliquez sur Install Now.
    Formulaire de téléchargement du plugin avec le fichier zip sélectionné et le bouton Install Now
  7. Une fois l’installation terminée, cliquez sur Activate Plugin. Vous pouvez également activer le plugin ultérieurement depuis Plugins → Installed Plugins.
    Message indiquant que le plugin a été installé avec succès, avec le bouton Activate Plugin
  8. Le plugin est installé, mais pas encore configuré. Poursuivez avec le guide de configuration ci-dessous.

​
Guide de configuration

​
Configuration des clés API et des webhooks

Le plugin nécessite deux valeurs pour chaque mode Dodo Payments : une clé API pour créer les checkouts et une clé de signature de webhook pour vérifier les webhooks qui mettent à jour vos commandes. Ces étapes configurent le mode live.
  1. Accédez à WooCommerce → Settings → Payments, ou cliquez sur Payments sous WooCommerce dans la barre latérale.
    Paramètres de paiement WooCommerce avec Dodo Payments actif et un bouton Manage
    Menu latéral WooCommerce avec Payments sélectionné
  2. Activez Dodo Payments s’il ne l’est pas, puis cliquez sur Manage.
  3. Les paramètres du plugin s’ouvrent, avec une description sous chaque option. Vérifiez que Enable Dodo Payments est sélectionné, puis commencez par Live API Key.
    Paramètres du plugin Dodo Payments avec les champs Enable/Disable, Title, Description, Instructions, Test Mode et Live API Key
  4. Dans le dashboard Dodo Payments, activez le commutateur Live Mode dans la barre latérale. Accédez à Developer → API Keys, ou utilisez ce lien direct, puis cliquez sur Add API key.
    Page API Keys de Dodo Payments sans clé et avec un bouton Add API key
  5. Saisissez un nom pour la clé, par exemple WooCommerce Plugin, puis cliquez sur Create.
    Boîte de dialogue Create New API avec le nom de clé WooCommerce Plugin et un bouton Create
  6. Cliquez sur Copy API Key. Le dashboard n’affiche la clé qu’une seule fois. Collez-la dans Live API Key dans les paramètres du plugin.
    Boîte de dialogue New API key avec les boutons Copy API Key et Close
    Champ Live API Key dans les paramètres du plugin
  7. Configurez ensuite la clé de signature du webhook. Dodo Payments envoie les mises à jour des paiements à votre boutique par webhook, et le plugin utilise la clé pour vérifier que chaque webhook provient bien de Dodo Payments.
  8. En bas des paramètres du plugin, sous Webhook Endpoint, copiez l’URL. Elle se présente sous la forme https://your-store.com/?wc-api=dodo_payments.
    URL Webhook Endpoint en bas des paramètres du plugin, au-dessus du bouton Save changes
  9. Dans le dashboard Dodo Payments, toujours en mode live, accédez à Developer → Webhooks et cliquez sur Add endpoint.
    Page Webhooks en mode live sans endpoint et avec un bouton Add endpoint
  10. Collez l’URL de l’étape 8 dans Endpoint URL. Laissez Subscribed events vide pour recevoir tous les événements, ou sélectionnez uniquement les événements de paiement, de remboursement et d’abonnement, qui sont ceux gérés par le plugin. Cliquez ensuite sur Create endpoint.
    Boîte de dialogue Add endpoint avec l'URL du webhook WooCommerce dans Endpoint URL
  11. L’onglet Overview de l’endpoint s’ouvre. Sous Signing secret, cliquez sur l’icône en forme d’œil pour révéler le secret, puis cliquez sur l’icône de copie.
    Onglet Overview de l'endpoint avec le secret de signature masqué, les icônes d'affichage et de copie, et Rotate secret
  12. Collez le secret dans Live Webhook Signing Key dans les paramètres du plugin, puis cliquez sur Save changes.
    Champ Live Webhook Signing Key dans les paramètres du plugin
  13. Vérifiez Global Tax Category et All Prices are Tax Inclusive. Le plugin les applique lorsqu’il crée un produit dans Dodo Payments, ce qui se produit la première fois qu’un client passe commande avec ce produit. Ensuite, le produit conserve les paramètres fiscaux définis dans le dashboard Dodo Payments, où vous pouvez les modifier pour chaque produit. Test API Key et Test Webhook Signing Key sont nécessaires uniquement pour le Test Mode.
    Paramètres Test API Key, Test Webhook Signing Key, Global Tax Category et All Prices are Tax Inclusive
Sous Checkout Feature Flags, vous pouvez également contrôler les options de la page de checkout Dodo Payments, telles que Allow Currency Selection et Allow Discount Codes. Un indicateur laissé sur Default n’est pas envoyé ; Dodo Payments applique donc sa propre valeur par défaut.
Pour effectuer des paiements de test, activez Test Mode dans les paramètres du plugin. Le plugin utilise alors Test API Key et Test Webhook Signing Key, et se connecte à l’environnement de test Dodo Payments. Le mode test possède ses propres clés API et endpoints de webhook. Pour les obtenir, désactivez le commutateur Live Mode dans le dashboard, suivez les étapes 4 à 12 en mode test, puis collez les valeurs dans les champs de test. Désactivez Test Mode avant de passer en production.

​
Vous êtes prêt !

Les clients peuvent maintenant choisir Dodo Payments lors du checkout.
Page de checkout WooCommerce avec le formulaire de facturation et le bouton Place order
Lorsqu’un client passe une commande, le plugin le redirige vers la page de checkout Dodo Payments pour effectuer le paiement. Une fois le paiement effectué, Dodo Payments envoie un webhook et le plugin met à jour le statut de la commande.
Page de checkout Dodo Payments avec les options de paiement par carte, QR code UPI et ID UPI

​
Fonctionnalités principales

  • Hosted Checkout : les clients paient sur une page de checkout Dodo Payments, puis retournent sur la page de confirmation de commande de votre boutique.
  • Multiple Payment Methods : le checkout affiche les moyens de paiement disponibles pour la zone géographique, la devise et l’appareil de chaque client.
  • Order Status Sync : les webhooks définissent la commande sur Completed, Processing, Failed ou Cancelled selon l’évolution du statut du paiement. Les paiements échoués et annulés remettent les articles en stock.
  • Refunds : effectuez des remboursements depuis le dashboard Dodo Payments. Lorsqu’un remboursement réussit, le plugin définit la commande sur Refunded.
  • Subscriptions : avec WooCommerce Subscriptions, les changements de statut sont synchronisés dans les deux sens, notamment lorsqu’un abonnement est annulé, suspendu ou réactivé. Les changements de dates d’abonnement dans WooCommerce ne sont pas synchronisés.
  • Order Notes : le plugin ajoute des notes de commande pour chaque session de checkout, changement de statut et erreur, afin que vous puissiez suivre chaque paiement depuis la page de commande.
  • Multi-currency Support : les produits sont synchronisés avec Dodo Payments dans la devise de votre boutique WooCommerce. L’indicateur Allow Currency Selection détermine si les clients peuvent modifier la devise lors du checkout.

​
Résolution des problèmes

​
Problèmes courants

  1. Payment Processing Failures
    • Vérifiez que la clé API correspond au mode du plugin. Lorsque Test Mode est désactivé, le plugin utilise Live API Key, qui doit provenir du dashboard en mode live. Lorsque Test Mode est activé, il utilise Test API Key.
    • Consultez les notes de commande. Lorsque le plugin ne peut pas créer un checkout, il ajoute une note contenant l’erreur, par exemple une erreur commençant par Dodo Payments Error:.
    • Si Dodo Payments n’apparaît pas lors du checkout, vérifiez que votre page de checkout utilise le checkout classique et non le bloc Checkout.
    • Si la commande comporte un code de réduction, vérifiez qu’il s’agit d’un code de pourcentage unique.
    • Les paiements en direct commencent une fois que votre compte a réussi la vérification du compte.
  2. Webhook Synchronization Problems
    • Vérifiez que Endpoint URL correspond exactement à l’URL indiquée sous Webhook Endpoint dans les paramètres du plugin.
    • Vérifiez que la clé de signature du plugin correspond au Signing secret de l’endpoint et que les deux proviennent du même mode.
    • Consultez le journal des erreurs PHP pour rechercher les lignes commençant par Dodo Payments:, telles que Dodo Payments: Could not verify webhook event. En mode live, le plugin renvoie 200 même lorsque la vérification échoue ; les journaux Dodo Payments indiquent donc que la livraison a réussi. En Test Mode, il renvoie 401.
    • Vérifiez que votre site possède un certificat SSL valide. Endpoint URL accepte uniquement les URL HTTPS.
    • Vérifiez que votre serveur, votre pare-feu et vos plugins de sécurité acceptent les requêtes POST vers l’URL du webhook depuis les adresses IP Dodo Payments.
    • Ouvrez l’onglet Logs dans Developer → Webhooks pour consulter chaque livraison et la réponse de votre site.

​
Ressources d’assistance

Pour obtenir de l’aide supplémentaire :

​
Bonnes pratiques de maintenance

  1. Mettez à jour le plugin lorsqu’une nouvelle version est publiée afin de bénéficier des correctifs de sécurité et des nouvelles fonctionnalités.
  2. Testez tous les parcours de paiement en Test Mode avant d’accepter des paiements en direct.
  3. Maintenez WordPress et WooCommerce à jour.
  4. Sauvegardez régulièrement votre site.
  5. Surveillez vos commandes et le dashboard Dodo Payments afin de détecter toute activité inhabituelle.
  6. Stockez les clés API de manière sécurisée et ne les partagez jamais publiquement.
Dernière modification le 26 septembre 2026