Comprendre le 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.
La piste à vérifier
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 ?
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
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
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
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 qu’il 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
Pourquoi le paiement échoue sur ma boutique WooCommerce ?
Les causes fréquentes sont une passerelle restée en mode test, des clés API incorrectes, une page de commande en cache ou un conflit JavaScript. Les journaux WooCommerce aident à cibler la panne.
Le client est débité mais la commande n'apparaît pas, que faire ?
C'est souvent un webhook défaillant : la passerelle a validé le paiement mais le site n'a pas reçu la confirmation. Vérifiez la configuration des webhooks et le statut de la commande.
Comment tester un paiement WooCommerce sans risque ?
Utilisez le mode test de la passerelle avec ses cartes de test, puis repassez impérativement en mode production avant la mise en ligne.
Un paiement échoué fait-il perdre la commande ?
La commande est généralement créée au statut « En attente ». Le client peut souvent réessayer de payer depuis son compte ou via un lien de paiement renvoyé.