Vos clients ajoutent des produits au panier, arrivent sur la page de paiement, et là : rien. La page reste blanche. Le bouton “Commander” ne répond pas. Ou pire : le paiement semble passer, mais la commande n’apparaît jamais dans le back-office.
Un checkout cassé, c’est du chiffre d’affaires qui s’évapore en temps réel. Chaque minute de panne, c’est des clients qui abandonnent et vont chez le concurrent.
Voici comment diagnostiquer et réparer un checkout WooCommerce, du plus simple au plus complexe.
Symptôme 1 : la page de checkout est blanche ou charge indéfiniment
Cause la plus fréquente : conflit de plugin
Un plugin de sécurité, de cache, ou de paiement mis à jour récemment peut entrer en conflit avec WooCommerce.
Diagnostic rapide :
- Connectez-vous au back-office WordPress
- Désactivez tous les plugins sauf WooCommerce
- Testez le checkout
Si le checkout refonctionne, réactivez les plugins un par un jusqu’à trouver le coupable.
Les plugins les plus suspects :
- Plugins de sécurité (Wordfence, Sucuri, iThemes Security)
- Plugins de cache (W3 Total Cache, WP Rocket, LiteSpeed Cache)
- Plugins de paiement (Stripe, PayPal, autres passerelles)
- Plugins de livraison (calcul de frais de port complexes)
Cause secondaire : thème incompatible
Certains thèmes remplacent le template de checkout de WooCommerce par leur propre version. Si le thème n’est pas à jour, ou si WooCommerce a changé sa structure de template, le checkout peut ne plus s’afficher.
Test : basculez temporairement sur un thème par défaut WordPress (Twenty Twenty-Four). Si le checkout refonctionne, c’est le thème.
Symptôme 2 : erreur JavaScript sur la page de checkout
Ouvrez les outils de développement de votre navigateur (F12 > Console) et rechargez la page de checkout. Si vous voyez des erreurs en rouge, elles indiquent généralement le problème.
Erreurs fréquentes et solutions
jQuery is not defined : un plugin ou le thème charge des scripts dans le mauvais ordre. Désactivez les plugins récemment ajoutés.
Cannot read property 'stripe' of undefined : le plugin Stripe n’est pas correctement configuré ou sa clé API est invalide. Vérifiez les réglages du plugin de paiement.
Uncaught TypeError: ... is not a function : conflit entre versions de JavaScript. Mettez à jour WooCommerce, le thème et les plugins.
Symptôme 3 : le paiement échoue sans message clair
Passerelle de paiement mal configurée
Stripe, PayPal, Mollie : chaque passerelle a ses propres réglages. Une clé API incorrecte, un mode “sandbox” activé par erreur, ou un webhook mal configuré peut bloquer les paiements.
Vérifications :
- Le mode test est-il désactivé en production ?
- La clé API est-elle valide et non révoquée ?
- Le webhook est-il correctement configuré dans le dashboard du prestataire ?
- La devise configurée dans WooCommerce correspond-elle à celle du compte Stripe/PayPal ?
Webhook Stripe non fonctionnel
Stripe envoie des notifications à votre site pour confirmer les paiements. Si le webhook ne fonctionne pas, Stripe considère que le paiement a échoué.
Comment vérifier :
- Allez dans le dashboard Stripe > Developers > Webhooks
- Vérifiez l’URL du webhook (doit pointer vers
votresite.fr/?wc-api=wc_stripe) - Vérifiez les logs des événements récents
- Si des événements sont en échec, régénérez le webhook
Symptôme 4 : les commandes passent mais n’apparaissent pas
Cache agressif
Un plugin de cache mal configuré peut servir une version ancienne de la page de checkout, ou empêcher WooCommerce d’enregistrer la commande.
Solution : excluez les pages panier, checkout et compte du cache :
/panier//checkout//mon-compte/
Base de données corrompue
Les tables WooCommerce (wp_posts, wp_postmeta, wp_woocommerce_order_items) peuvent être corrompues, empêchant l’enregistrement des commandes.
Réparation :
- Allez dans phpMyAdmin
- Sélectionnez les tables WooCommerce
- Cliquez sur “Réparer” ou exécutez :
REPAIR TABLE wp_posts, wp_postmeta, wp_woocommerce_order_items;Symptôme 5 : les emails de confirmation ne partent pas
Ce n’est pas strictement un problème de checkout, mais vos clients pensent que la commande a échoué s’ils ne reçoivent pas de confirmation.
Vérifications
- WooCommerce > Réglages > Emails : vérifiez que les notifications sont activées
- Installez un plugin SMTP (FluentSMTP, WP Mail SMTP) pour envoyer via un vrai serveur de mail
- Testez l’envoi avec l’outil de test du plugin SMTP
- Vérifiez que les emails ne partent pas dans les spams
Prévention : éviter que le checkout casse
La meilleure protection, c’est la maintenance proactive.
- Testez chaque mise à jour sur un environnement de staging
- Ne mettez jamais à jour WooCommerce et les plugins de paiement le même jour
- Surveillez le tunnel d’achat avec des outils de monitoring
- Faites un test de commande réelle une fois par semaine
Nos forfaits de maintenance WooCommerce incluent la surveillance du tunnel d’achat en continu. Si le checkout cesse de fonctionner, nous sommes alertés et intervenons avant que vous ne le remarquiez.
Quand appeler un expert
Si vous avez suivi ce guide et que le checkout est toujours cassé, le problème est probablement :
- Un conflit profond entre le thème et WooCommerce
- Une base de données corrompue nécessitant une restauration
- Un code personnalisé (fonctions.php, plugin maison) incompatible
- Un problème serveur (PHP crash, timeout, mémoire insuffisante)
Notre service de dépannage urgence intervient sous 2h. Nous diagnostiquons le problème, réparons le checkout, et vérifions que tout le tunnel d’achat fonctionne de bout en bout.
