# Problème de paiement sur votre boutique WooCommerce

> Une commande WooCommerce qui reste bloquée en statut « en attente de paiement » alors que le client a bien été débité, ou un moyen de paiement absent au moment de valider : ces blocages coûtent des ventes sans forcément générer de réclamation visible.

- Source canonique : [https://allaux.fr/wordpress-woocommerce/probleme-paiement](https://allaux.fr/wordpress-woocommerce/probleme-paiement)
- Langue : FR
- Dernière mise à jour : 2026-08-03

## Réponse directe

> Ouvrez WooCommerce, État, Journaux et sélectionnez le fichier au nom de votre passerelle : la réponse exacte du prestataire y est écrite, horodatée. Une commande restée en attente de paiement alors que le client a été débité signale presque toujours une notification serveur à serveur qui n’arrive pas : vérifiez l’URL de rappel déclarée chez le prestataire, et qu’aucun cache ni pare-feu ne l’intercepte avant WordPress.

## Comment WooCommerce valide un paiement

WooCommerce délègue la confirmation de paiement à un webhook envoyé par la passerelle (Stripe, PayPal, etc.) vers une URL du type /wc-api/nom_de_la_passerelle/. Quand la banque valide le paiement mais que la commande reste en statut « en attente », la cause est presque toujours que ce webhook n’atteint jamais le site : pare-feu applicatif de l’hébergeur, plugin de sécurité qui bloque les requêtes externes, ou certificat SSL invalide qui fait échouer l’appel côté serveur.

Le hook woocommerce_payment_complete déclenche ensuite la mise à jour du stock et l’envoi des e-mails de confirmation. Si un autre plugin s’accroche à ce même hook et provoque une erreur PHP, la chaîne s’arrête net : le paiement est passé, mais la commande reste bloquée comme si rien ne s’était produit.

Un autre cas fréquent : une mise à jour du plugin de passerelle change la version d’API utilisée sans que les clés ou le mode (test/production) aient été revérifiés, ce qui bascule silencieusement la boutique en mode test alors que les clients pensent payer réellement.

## Ce qui m’amène sur ce type de dossier

- Commande restée « en attente de paiement » alors que le client a été débité
- Un moyen de paiement (CB, PayPal, virement) absent au moment de payer
- Erreur affichée après le retour de la banque suite à l’authentification 3D Secure
- Le paiement fonctionne en mode test mais pas en conditions réelles
- Panier vidé ou erreur de session juste avant la validation finale

## Comment je diagnostique

1. **Reproduction du parcours** — Je passe une commande test dans les mêmes conditions que le client bloqué, pour observer le comportement réel plutôt que de deviner.
2. **Vérification du mode et des clés** — Je contrôle que la passerelle est bien en mode production avec les bonnes clés API, pas en mode test oublié après une mise à jour.
3. **Contrôle des webhooks** — Je vérifie que les notifications de la passerelle atteignent le site, en consultant les logs WooCommerce et le tableau de bord du prestataire de paiement.
4. **Recherche de conflit de plugin** — Je désactive temporairement les plugins récemment installés qui pourraient interférer avec le hook de confirmation de paiement.

## Ne validez pas les commandes bloquées à la main sans vérifier

> Forcer manuellement le statut d’une commande sans confirmer que le paiement a bien été reçu peut créer un écart entre votre comptabilité et les encaissements réels. Je vérifie toujours côté prestataire de paiement avant.

## Pages liées

- **Configurer un webhook de paiement** — La pièce qui manque presque toujours sur une commande bloquée. ([/guides/configurer-webhook-paiement](/guides/configurer-webhook-paiement))
- **Lire les journaux d’erreurs WooCommerce** — Les passerelles y écrivent le refus exact renvoyé par la banque. ([/guides/lire-logs-erreurs-woocommerce](/guides/lire-logs-erreurs-woocommerce))
- **TVA mal calculée** — Un total faux peut bloquer la validation du paiement. ([/wordpress-woocommerce/problemes/tva-mal-calculee](/wordpress-woocommerce/problemes/tva-mal-calculee))
- **Panier qui se vide** — Sessions et cache : l’autre cause d’un paiement qui n’aboutit pas. ([/wordpress-woocommerce/problemes/panier-qui-se-vide](/wordpress-woocommerce/problemes/panier-qui-se-vide))

## FAQ

### Le client va-t-il être débité deux fois si je retraite sa commande ?

Non, si le paiement a déjà été accepté par la banque il ne sera pas repris. Le travail consiste à rapprocher la transaction existante avec la commande bloquée, pas à relancer un paiement.

### Est-ce que je perds la commande si elle reste bloquée longtemps ?

Non, la commande reste enregistrée dans WooCommerce même en attente. Le risque est plutôt que le stock associé reste réservé ou que le client, ne voyant pas de confirmation, recommande ailleurs.

### Quels accès dois-je vous fournir ?

Un accès administrateur WordPress, un accès FTP ou SSH, et si possible un accès au tableau de bord de votre prestataire de paiement pour vérifier les notifications envoyées.

### Combien de temps pour corriger un blocage de paiement ?

Un problème de mode test oublié ou de clé API se corrige en quelques minutes. Un problème de webhook bloqué par le serveur peut demander une coordination avec l’hébergeur, donc parfois plus long.

### Faut-il changer de plugin de paiement ?

Rarement en premier réflexe. La cause est le plus souvent une configuration ou un blocage réseau, pas le plugin lui-même. Un changement n’est recommandé que si la passerelle est réellement abandonnée par son éditeur.