Une erreur WooCommerce se règle en partant de ce que voit le client : un panier qui se vide, un paiement refusé ou bloqué, un e‑mail de commande qui n’arrive pas, une page de commande blanche, un stock faux ou des réglages qui refusent de s’enregistrer. Chaque symptôme a deux ou trois causes connues, et elles sont presque toujours autour de WooCommerce plutôt que dedans : un cache, une extension en conflit, la passerelle de paiement ou l’envoi d’e‑mails du serveur. Le premier réflexe est le même pour tous : lire les journaux de WooCommerce, qui disent souvent noir sur blanc ce qui a coincé.
Ces pannes coûtent des ventes sans bruit : le client abandonne et aucune erreur ne remonte dans tes statistiques. Le guide est classé par symptôme, en commençant par ce que tu peux vérifier seul depuis l’administration ; les réglages serveur viennent en dernier, à confier à ton hébergeur ou à ton prestataire si besoin.
Où trouver le message d’erreur exact de WooCommerce ?
Le message d’erreur exact se trouve dans WooCommerce > Status > Logs, l’écran « Journaux » de l’interface en français. Un journal désigne le fichier où WooCommerce et ses extensions notent, ligne par ligne, ce qu’ils ont fait et ce qui a échoué.
Trois fichiers servent dans presque tous les cas :
- fatal‑errors : les erreurs PHP fatales, celles qui donnent une page blanche ou un message d’erreur critique (source : WooCommerce, Finding PHP error logs). Par défaut, WooCommerce garde ces journaux 30 jours.
- transactional‑emails : la trace de chaque e‑mail de commande, envoyé ou non (détail plus bas).
- le journal de ta passerelle de paiement : il faut d’abord activer la journalisation dans WooCommerce > Settings > Payments, sur l’extension concernée. La documentation conseille de la désactiver une fois le problème trouvé, car ces fichiers grossissent vite (source : WooCommerce, Troubleshoot payment errors).
Le rapport d’état du système (WooCommerce > Status) complète ces journaux : versions de WordPress, de WooCommerce et de PHP, valeur de max_input_vars, pages WooCommerce bien configurées. C’est aussi ce rapport que te demandera le support d’une extension.
Pourquoi le panier WooCommerce se vide‑t‑il ?
Le panier WooCommerce se vide presque toujours pour l’une de ces deux raisons : une page servie par un cache ne correspond plus à la session du visiteur, ou le cookie qui relie le visiteur à son panier est bloqué. WooCommerce range le contenu du panier dans la base de données et le retrouve grâce au cookie wp_woocommerce_session_, qui dure 2 jours ; deux autres cookies, woocommerce_cart_hash et woocommerce_items_in_cart, suivent les changements du panier (source : WooCommerce, cookies).
Si un cache sert une page figée sur /panier/ ou /commande/, le panier apparaît vide ou change d’un rechargement à l’autre, le cache HTTP étant conçu pour réutiliser une réponse déjà obtenue (source : MDN Web Docs, 2026). La documentation officielle demande d’exclure du cache les pages Panier, Commande et Mon compte, propres à chaque client, ainsi que les cookies WooCommerce (source : WooCommerce Developer, configuring caching plugins).
- Exclus ces trois pages dans les réglages de ton extension de cache (voir les meilleurs plugins de cache WordPress) et, si ton cache stocke aussi la base de données, exclus
_wc_session_. - Si un CDN (Cloudflare, etc.) met en cache le HTML de ces pages, ajoute une règle de contournement (« bypass cache ») sur leurs adresses, puis vide le cache serveur après chaque modification.
Le message « Désolé, votre session a expiré » affiché au moment de commander dit la même chose : WooCommerce ne retrouve plus la session du client. Un site lent aggrave le symptôme, car les requêtes du panier répondent en retard (voir accélérer un site WordPress lent).
Pourquoi le paiement WooCommerce est‑il refusé ou bloqué ?
Un paiement WooCommerce bloqué a trois origines possibles : la passerelle n’a jamais reçu la demande (script bloqué, mauvaise clé), la banque l’a refusée, ou la passerelle a encaissé sans prévenir WooCommerce. Le statut de la commande te dit dans quel cas tu es (source : WooCommerce, Troubleshoot payment errors) :
- Attente paiement (Pending payment) : la commande est reçue mais pas payée. La documentation pointe souvent un problème d’adresse de notification de la passerelle ou un conflit d’extension.
- En attente (On hold) : le paiement attend une confirmation, par exemple un virement ou un chèque, ou une passerelle réglée pour autoriser sans encaisser. Attention, en français les deux libellés se ressemblent mais ne disent pas la même chose.
- Failed (échec) : le paiement a été refusé. La raison se lit dans les notes de la commande.
Le client a payé mais la commande reste en attente de paiement
C’est le cas le plus coûteux, parce que le client a été débité. La liste de contrôle officielle tient en cinq gestes (source : WooCommerce, Troubleshooting orders) : noter le numéro, le statut et l’heure de la commande ; lire les notes de commande ; chercher la transaction dans le tableau de bord de la passerelle ; ne pas faire repayer le client tant que tu n’as pas vérifié qu’aucun débit n’existe, pour éviter un double paiement ; si la passerelle montre un paiement réussi, vérifier ou renvoyer son webhook avant d’expédier.
Un webhook désigne l’appel automatique qu’un service tiers envoie à ton serveur pour l’informer d’un événement. C’est lui qui prévient WooCommerce que le paiement a réussi. Depuis la version 8.6.1 de l’extension Stripe, les webhooks se créent seuls à la connexion du compte. Pour vérifier, va dans WooCommerce > Settings > Payments > Stripe > Settings, clique sur Configure connection et contrôle que l’état indique « Configured » dans les onglets Live et Test ; sinon, clique sur Reconfigure webhooks (source : WooCommerce, Stripe webhooks). Avec l’ancienne extension PayPal Standard, dépréciée par WooCommerce, une commande bloquée en attente de paiement indique plutôt un problème d’IPN (la notification de paiement de PayPal).
Point à connaître : le réglage Maintenir le stock (minutes) annule les commandes « Attente paiement » une fois le délai écoulé (60 minutes conseillées par la documentation). Une commande payée dont le webhook n’arrive jamais peut donc finir annulée toute seule, alors que l’argent est encaissé.
La passerelle refuse la carte ou le bouton de paiement ne s’affiche pas
Une carte valide refusée cache parfois un problème technique plutôt qu’un vrai refus bancaire.
- Un certificat SSL expiré déclenche
NET::ERR_CERT_DATE_INVALIDet bloque les scripts de paiement embarqués (Stripe, PayPal) : voir certificat SSL expiré. - Le contenu mixte, une ressource chargée en HTTP sur une page HTTPS, est bloqué par les navigateurs, qui neutralisent du même coup les scripts de paiement (source : MDN Web Docs, 2026). Le guide : corriger le contenu mixte WordPress.
- Une page de paiement qui redirige en boucle relève des règles HTTP/HTTPS, comme ERR_TOO_MANY_REDIRECTS.
- Des clés API de test sur la boutique en production, erreur fréquente après une migration, bloquent tout. Les tests se font en mode test (« sandbox ») sur une copie du site.
- Une devise réglée dans WooCommerce différente de celle du compte marchand peut bloquer certaines transactions.
- Avec PayPal Payments, la documentation demande d’exclure du cache de page et du CDN les pages panier, commande, commande reçue et Mon compte, et d’exclure les scripts de PayPal de la minification, du regroupement et du chargement différé (source : WooCommerce, PayPal Payments troubleshooting). Son journal (source
woocommerce-paypal-payments) s’active dans ses réglages, onglet Troubleshooting, et se conserve 30 jours.
« Error retrieving payment details » : que veut dire cette erreur de récupération des détails de paiement ?
Le message « Error retrieving payment details » apparaît dans l’administration de l’extension WooCommerce PayPal Payments. D’après le support officiel de l’extension, il s’affiche quand l’extension n’arrive pas à récupérer des données sur les serveurs de PayPal, à cause d’un problème d’authentification, de réseau ou d’une perturbation du service PayPal (source : forum de support WooCommerce PayPal Payments). Vérifie que le compte PayPal est toujours connecté, lis le journal woocommerce-paypal-payments, puis transmets le rapport d’état du système au support si le message revient.
Pourquoi la page de commande WooCommerce est‑elle blanche ou en erreur ?
Une page de commande blanche vient presque toujours d’une erreur PHP : la documentation de WooCommerce conseille d’activer le débogage de WordPress pour en trouver la cause (source : WordPress Advanced Administration, 2026). Le fichier debug.log se crée alors dans le dossier wp-content, et le journal fatal‑errors de WooCommerce peut déjà contenir l’erreur en cause. À désactiver sur un site en ligne une fois le diagnostic fait.
Bouton « Commander » qui ne réagit plus, champs de facturation qui disparaissent : c’est la signature d’un conflit JavaScript ou PHP. Méthode par élimination :
- Active un thème par défaut de WordPress temporairement, sur une copie de test du site si possible.
- Désactive toutes les extensions sauf WooCommerce et la passerelle de paiement.
- Réactive‑les une par une, en testant la commande à chaque étape.
- Note l’extension fautive : c’est souvent une extension de pop‑up, de suivi, ou de champs de commande personnalisés qui charge un script en double.
Le détail est dans notre guide pour identifier un conflit de plugins WordPress. Si le problème suit une mise à jour automatique, voir le plugin cassé après mise à jour et le rollback propre. Un écran totalement blanc répond au même mécanisme qu’un écran blanc de la mort WordPress.
Le message « Il y a quelques problèmes avec les articles dans votre panier. Veuillez retourner sur la page du panier et résolvez ces problèmes avant de commander. » n’est pas un bug : un article du panier ne peut pas être commandé tel quel. Retourne sur le panier, qui affiche en général le produit concerné.
Régler les directives PHP qui bloquent les gros paniers
Un panier avec beaucoup de variations, de remises ou d’extensions actives consomme plus de ressources serveur. Si les directives PHP sont trop basses, la commande s’interrompt sans prévenir.
memory_limitdésigne la mémoire allouée à PHP pour exécuter le script (source : PHP Manual, 2026). Trop basse, elle donne « Allowed memory size exhausted » au calcul du panier (voir mémoire PHP épuisée). Départ raisonnable :256M,512Msur un gros catalogue.- max_execution_time : durée maximale d’un script PHP. Trop basse, l’appel à la passerelle est coupé et la page charge sans fin. Départ :
60secondes minimum. - max_input_vars : nombre de champs de formulaire acceptés (voir la section sur les réglages). Valeur conseillée :
3000. - post_max_size et upload_max_filesize : utiles si la commande inclut un envoi de fichier ; trop basses, elles déclenchent une erreur 413.
Ces réglages se font dans wp-config.php (via ini_set), dans le php.ini ou dans le panneau PHP de l’hébergeur : syntaxes exactes dans notre guide sur les directives PHP WordPress.
Pourquoi les e‑mails de commande WooCommerce ne partent‑ils pas ?
Un e‑mail de commande WooCommerce manque pour l’une de ces deux raisons : WooCommerce ne l’a jamais créé, ou il est parti du serveur et s’est perdu en route. La documentation officielle donne l’ordre des vérifications (source : WooCommerce, Email troubleshooting) :
- La commande doit déclencher un e‑mail. Une commande restée en « Attente paiement » n’en envoie aucun : le problème est alors du côté de la passerelle (voir plus haut).
- La notification doit être activée. Dans WooCommerce > Settings > Emails, ouvre le modèle concerné et vérifie que la case d’activation de la notification est cochée.
- Le journal transactional‑emails dit ce qui s’est passé. Chaque e‑mail y laisse une ligne : INFO s’il est envoyé, WARNING s’il a échoué, NOTICE s’il est désactivé ou ignoré. Si le journal est vide, vérifie dans les réglages des journaux que le niveau minimal n’efface pas les lignes INFO et NOTICE.
- Si l’e‑mail est envoyé mais jamais reçu, c’est un problème de délivrabilité : utilise une adresse d’expéditeur (« From » address) sur ton propre domaine, pas une adresse
@gmail.comou@yahoo.com, qui fait souvent atterrir les messages en spam.
Par défaut, WordPress envoie avec la fonction mail() de PHP, mal notée par les filtres anti‑spam. La solution durable est un envoi par SMTP authentifié (Resend, ou ton fournisseur d’e‑mail pro). SMTP (Simple Mail Transfer Protocol) désigne le protocole normalisé qui achemine le courrier d’un serveur à l’autre (source : RFC 5321, IETF). Les guides utiles : configurer Resend pour l’envoi d’e‑mail, réparer les e‑mails WordPress qui n’arrivent pas (le même souci touche souvent Contact Form 7) et la délivrabilité e‑mail avec SPF, DKIM et DMARC, sans lesquels même un SMTP bien réglé finit en spam.
L’e‑mail de test WooCommerce ne part pas : que vérifier ?
WooCommerce propose un aperçu des e‑mails dans WooCommerce > Settings > Emails, avec une option Send a test email qui envoie l’aperçu à l’adresse de ton choix (source : WooCommerce, Email settings). Si cet envoi de test échoue, le contenu du modèle est rarement en cause : vérifie d’abord l’envoi du site lui‑même (SMTP, adresse d’expéditeur sur ton domaine), avec les mêmes étapes que pour les e‑mails de commande. Une extension SMTP qui propose son propre test d’envoi permet de séparer les deux problèmes.
Pourquoi le stock WooCommerce est‑il faux ?
Le stock WooCommerce est faux le plus souvent parce que la gestion du stock n’est activée qu’à un seul des deux endroits où elle doit l’être. Elle doit être active dans les réglages généraux, WooCommerce > Settings > Products > Inventory, case « Activer la gestion du stock », et sur chaque produit, avec le suivi de la quantité coché et la quantité saisie. Sinon, le stock ne baisse pas quand une commande est passée (source : WooCommerce, Troubleshooting orders). Un produit variable se gère au niveau du produit, de chaque variation, ou des deux.
Deux autres comportements surprennent souvent :
- Le stock disparaît puis revient. Le réglage Maintenir le stock (minutes) réserve les articles des commandes « Attente paiement » pendant le délai choisi, puis annule la commande et remet le stock en vente. Il ne concerne pas les commandes « En attente » (On hold). Laisser le champ vide désactive la réservation (source : WooCommerce, Products settings).
- Une commande échouée ne rend pas le stock. Depuis WooCommerce 11.0, une commande passée en « Failed » ne restaure le stock que s’il avait bien été déduit pour cette commande.
Pourquoi les réglages WooCommerce ne s’enregistrent‑ils pas ?
Les réglages WooCommerce ne s’enregistrent pas, le plus souvent, parce que le formulaire envoie plus de champs que le serveur n’en accepte. Au‑delà de 1000 champs, valeur habituelle par défaut de max_input_vars, les données sont tronquées et ne peuvent pas être enregistrées : c’est typique des produits avec beaucoup de variations, des tables de taxes ou des tarifs de livraison (source : WooCommerce, data not saving).
La valeur actuelle s’affiche dans WooCommerce > Status, section Server environment. La documentation conseille de la monter à 3000, dans le php.ini ou, sur un hébergement mutualisé, dans le fichier .htaccess :
# php.ini
max_input_vars = 3000
# .htaccess (hébergement mutualisé)
php_value max_input_vars 3000
Deux autres verrous serveur peuvent bloquer l’enregistrement : le module Suhosin sur certains hébergements anciens, et mod_security, qui peut renvoyer une erreur 503. Dans les deux cas, demande à ton hébergeur d’ajuster ses règles pour ton site.
« Erreur lors de la connexion à la base de données » : que faire sur une boutique WooCommerce ?
Le message « Erreur lors de la connexion à la base de données » vient de WordPress, pas de WooCommerce : le site n’arrive plus à joindre sa base MySQL, donc toute la boutique est hors ligne, commandes comprises. La documentation de WordPress cite trois causes (source : WordPress, common errors) : des informations fausses dans wp-config.php (nom de la base, utilisateur, mot de passe, hôte), un problème chez l’hébergeur (quota de base dépassé ou serveur en panne), ou un site piraté. Les 5 étapes de réparation sont dans notre guide sur l’erreur de connexion à la base de données WordPress. Si la panne revient souvent, le sujet devient l’hébergement : voir quel hébergeur pour une boutique WooCommerce.
Que veulent dire les messages d’erreur WooCommerce les plus courants ?
Les libellés ci‑dessous sont ceux de l’interface française de WooCommerce et de WordPress (source : traductions officielles de WooCommerce). Les messages des extensions de paiement restent parfois en anglais.
| Message affiché | Ce qu’il veut dire | Où regarder |
|---|---|---|
| « Désolé, votre session a expiré » | WooCommerce ne retrouve plus la session du client | Cache et cookies du panier |
| « Il y a quelques problèmes avec les articles dans votre panier » | Un article ne peut pas être commandé tel quel | Page panier, stock du produit |
| « Moyen de paiement non valide. » | Le moyen de paiement reçu n’est pas reconnu par la boutique | Réglages et script de la passerelle |
| « Error retrieving payment details » | PayPal Payments n’arrive pas à joindre PayPal | Connexion PayPal, journal de l’extension |
| « Allowed memory size exhausted » | PHP manque de mémoire | memory_limit |
| « Erreur lors de la connexion à la base de données » | WordPress ne joint plus MySQL | wp-config.php, hébergeur |
Tableau récapitulatif
| Symptôme | Cause probable | Solution |
|---|---|---|
| Panier qui se vide | Cache sur page panier/checkout | Exclure ces pages et les cookies WooCommerce du cache |
| Écran blanc au checkout | Conflit thème/plugin ou erreur PHP | Journal fatal‑errors, puis désactivation par élimination |
| Checkout qui charge indéfiniment | memory_limit / max_execution_time trop bas | Ajuster dans wp-config.php ou panel hébergeur |
| Champs de commande perdus | max_input_vars insuffisant | Monter à 3000 |
| Passerelle refuse systématiquement | SSL expiré / contenu mixte / clés de test | Renouveler certificat, nettoyer les ressources HTTP, vérifier les clés |
| Commande en attente malgré paiement réussi | Webhook de la passerelle absent ou cassé | Vérifier ou reconfigurer le webhook (Stripe : Reconfigure webhooks) |
| Aucun e‑mail de confirmation reçu | Notification désactivée, ou pas de SMTP | Journal transactional‑emails, puis SMTP + SPF/DKIM/DMARC |
| Stock qui ne baisse pas | Gestion du stock inactive sur le produit | Activer la gestion du stock en global et sur le produit |
| Réglages qui ne s’enregistrent pas | max_input_vars à 1000, mod_security | Monter à 3000, demander à l’hébergeur |
FAQ
Pourquoi mon panier WooCommerce se vide‑t‑il uniquement sur mobile ?
C’est généralement un problème de cookies bloqués par les navigateurs mobiles en navigation privée, ou par un plugin de consentement RGPD trop restrictif qui bloque les cookies de session avant validation. Vérifie que ton plugin de gestion des cookies autorise les cookies « essentiels » (session panier) par défaut, sans attendre le consentement marketing.
Le checkout WooCommerce fonctionne en localhost mais pas en production, pourquoi ?
Les causes les plus fréquentes sont un certificat SSL absent ou mal configuré en production, des clés API de passerelle encore en mode test, ou une différence de version PHP entre les deux environnements qui expose un conflit de plugin invisible en local.
Faut‑il désactiver le cache complètement sur une boutique WooCommerce ?
Non, ce serait contre‑productif pour la vitesse du site. Il faut simplement exclure les pages dynamiques (panier, checkout, mon compte) du cache, tout en gardant le cache actif sur les fiches produits et pages statiques.
Un conflit de plugin WooCommerce peut‑il faire perdre des ventes sans erreur visible ?
Oui, c’est même le cas le plus fréquent. Un script JS en conflit peut simplement empêcher le bouton « Passer la commande » de réagir, sans message d’erreur explicite. Le client referme l’onglet, frustré, et tu ne vois jamais l’incident dans tes logs serveur.
Comment savoir si le problème vient de WooCommerce ou de mon thème premium ?
Active temporairement un thème par défaut de WordPress et reproduis le parcours d’achat. Si le problème disparaît, le thème est en cause, souvent un conflit avec un builder comme Elementor ou WPBakery, dont les problématiques sont proches de celles décrites dans nos guides sur Elementor bloqué au chargement et sur WPBakery en panne.
Quand passer la main à un pro
Ces réglages résolvent la majorité des blocages courants. Mais si le problème touche plusieurs de ces symptômes à la fois (panier instable, e‑mails absents, paiement refusé par intermittence), c’est souvent le signe d’un socle technique fragile : hébergement sous‑dimensionné, extensions accumulées sans cohérence, ou migration bâclée d’une agence à l’autre. À ce stade, un audit complet de la stabilité technique vaut mieux qu’un rafistolage extension par extension : c’est le rôle d’une maintenance structurée, plutôt que des correctifs isolés qui reviennent chaque trimestre.
Ce problème, Peechy s'en occupe
Plutôt que de tout gérer seul, confiez votre site à une agence qui s'occupe de tout, hébergement, sécurité, maintenance et corrections. Encore plus simple en abonnement : on règle les soucis avant même que vous les remarquiez.
Confier mon site à Peechy


