Résumé rapide du problème
Une erreur de passerelle de paiement WooCommerce signale un échec de communication entre la boutique et Stripe ou PayPal. Les causes typiques sont des clés API invalides, des webhooks mal configurés, un certificat TLS obsolète ou une version de plugin incompatible. La transaction est interrompue côté passerelle.
Solution rapide
Régénérez et ressaisissez les clés API, reconfigurez les webhooks de la passerelle, vérifiez le certificat TLS du site, et mettez le plugin de paiement à jour.
Comment reconnaître ce bug
- Un message d'erreur explicite de Stripe ou PayPal s'affiche au paiement
- Les journaux WooCommerce contiennent des erreurs d'API ou de webhook
- Les paiements échouent depuis une mise à jour du plugin
- Les remboursements ou les abonnements ne se synchronisent plus
Qu'est-ce que ce bug WordPress ?
La passerelle de paiement est le module qui relie WooCommerce à un prestataire (Stripe, PayPal, Mollie). Cette communication se fait via une API sécurisée et des webhooks qui notifient le site du résultat. Une erreur de passerelle traduit une rupture de ce lien : authentification API rejetée, webhook injoignable, TLS trop ancien ou incompatibilité de version. Sans correction, aucun paiement n'aboutit.
Pourquoi ce problème apparaît-il ?
Clés API invalides
Les clés publiques ou secrètes sont erronées, mélangées entre test et production, ou révoquées.
Webhooks mal configurés
L'URL de webhook est absente, incorrecte ou inaccessible côté passerelle.
Certificat TLS obsolète
Une version de TLS trop ancienne empêche la connexion sécurisée à l'API.
Plugin de paiement incompatible
Une version du plugin n'est plus compatible avec l'API de la passerelle ou de WooCommerce.
Comment réparer ce bug WordPress
Vérifier et régénérer les clés API
Depuis le tableau de bord Stripe ou PayPal, contrôlez les clés et ressaisissez-les dans WooCommerce.
Reconfigurer les webhooks
Recréez le webhook côté passerelle en pointant vers l'URL exacte attendue par WooCommerce.
Contrôler le certificat TLS
Assurez-vous que le serveur supporte une version récente de TLS exigée par la passerelle.
Mettre à jour le plugin
Installez la dernière version du plugin de paiement et de WooCommerce pour rétablir la compatibilité.
Lire les journaux détaillés
Activez le mode journalisation de la passerelle pour obtenir le message d'erreur exact.
Comment éviter que ce bug revienne
- Conservez les clés API en lieu sûr et surveillez leur validité
- Vérifiez les webhooks après chaque migration ou changement d'URL
- Maintenez le plugin de paiement et WooCommerce à jour ensemble
Questions fréquentes (FAQ)
Pourquoi Stripe affiche une erreur sur mon WooCommerce ?
À quoi servent les webhooks d'une passerelle de paiement ?
Faut-il les mêmes clés API en test et en production ?
Une mise à jour a cassé ma passerelle de paiement, que faire ?
L'équipe Mr.WordPress
Experts en dépannage WordPress
Notre équipe technique intervient chaque jour sur des sites WordPress en panne — erreurs serveur, piratages, lenteurs, conflits de plugins. Chaque guide est rédigé et vérifié à partir de cas réels d'intervention.
En savoir plus sur Mr.WordPress →