Votre site WordPress a besoin d’aide ? Parlons-en.

Paiement WooCommerce échoué : solutions

Vos clients remplissent leur panier mais le paiement échoue au dernier moment : chaque tentative ratée est une vente perdue et un client mécontent.

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

Avant de modifier votre site

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.

  1. Vérifier le mode de la passerelle

    Dans WooCommerce > Réglages > Paiements, confirmez que la passerelle est en mode production, pas en test.

  2. Contrôler les clés API

    Vérifiez que les clés Stripe ou PayPal sont à jour et correspondent bien au compte de production.

  3. Exclure le checkout du cache

    Excluez les pages panier et commande de tout plugin de cache et du cache serveur.

  4. Consulter les journaux

    Examinez WooCommerce > État > Journaux et la console (F12) pour identifier l'erreur précise.

  5. 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é.