Résumé rapide du problème
Un paiement WooCommerce qui échoue vient le plus souvent d'une passerelle mal configurée (clés API en mode test, identifiants expirés), d'une page de commande mise en cache, ou d'un conflit JavaScript qui empêche la transaction d'aboutir. Le client voit alors un message d'erreur ou une page bloquée au moment de payer.
Solution rapide
Vérifiez les clés API de la passerelle et son mode (production), excluez la page de commande du cache, et inspectez la console du navigateur ainsi que les journaux WooCommerce.
Comment reconnaître ce bug
- Un message d'erreur s'affiche au moment de payer
- La transaction est refusée alors que la carte est valide
- La commande reste bloquée au statut « En attente de paiement »
- Le paiement échoue avec certaines cartes mais pas d'autres
- Le client est débité sans que la commande soit confirmée
Qu'est-ce que ce bug WordPress ?
Le paiement WooCommerce repose sur une passerelle externe (Stripe, PayPal, Mollie) qui valide la transaction puis renvoie une réponse au site. Un échec survient quand cette communication est rompue : clés API incorrectes, certificat ou webhook défaillant, page figée par le cache, ou script cassé par un plugin. Le résultat est une commande non payée, parfois bloquée au statut « En attente ».
Pourquoi ce problème apparaît-il ?
Passerelle en mode test
La passerelle est restée en mode bac à sable et refuse les vraies transactions.
Clés API incorrectes ou expirées
Les identifiants Stripe ou PayPal sont erronés, révoqués ou non renouvelés.
Page de commande mise en cache
Un cache trop agressif fige le tunnel et empêche la validation du paiement.
Conflit JavaScript
Un plugin tiers casse le script de la passerelle sur la page de commande.
Comment réparer ce bug WordPress
Vérifier le mode de la passerelle
Dans WooCommerce > Réglages > Paiements, confirmez que la passerelle est en mode production, pas en test.
Contrôler les clés API
Vérifiez que les clés Stripe ou PayPal sont à jour et correspondent bien au compte de production.
Exclure le checkout du cache
Excluez les pages panier et commande de tout plugin de cache et du cache serveur.
Consulter les journaux
Examinez WooCommerce > État > Journaux et la console (F12) pour identifier l'erreur précise.
Vérifier les webhooks
Assurez-vous que les webhooks de la passerelle pointent vers la bonne URL du site.
Comment éviter que ce bug revienne
- Excluez systématiquement panier et commande du cache
- Testez une transaction réelle après chaque mise à jour de la passerelle
- Surveillez l'expiration des clés API et le bon fonctionnement des webhooks
Questions fréquentes (FAQ)
Pourquoi le paiement échoue sur ma boutique WooCommerce ?
Le client est débité mais la commande n'apparaît pas, que faire ?
Comment tester un paiement WooCommerce sans risque ?
Un paiement échoué fait-il perdre la commande ?
L'équipe Mr.WordPress
Experts en dépannage WordPress
Notre équipe technique intervient chaque jour sur des sites WordPress en panne — erreurs serveur, piratages, lenteurs, conflits de plugins. Chaque guide est rédigé et vérifié à partir de cas réels d'intervention.
En savoir plus sur Mr.WordPress →