Comprendre le 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.
La piste à vérifier
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 ?
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
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
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.
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 qu’il 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
Pourquoi Stripe affiche une erreur sur mon WooCommerce ?
Le plus souvent à cause de clés API incorrectes, d'un webhook injoignable ou d'un certificat TLS obsolète. Le mode journalisation de Stripe donne le message d'erreur précis.
À quoi servent les webhooks d'une passerelle de paiement ?
Les webhooks permettent à la passerelle de notifier WooCommerce du résultat réel d'un paiement (réussi, remboursé, échoué). Sans eux, les statuts de commande ne se mettent pas à jour.
Faut-il les mêmes clés API en test et en production ?
Non. Stripe et PayPal fournissent des jeux de clés distincts pour le mode test et le mode production. Mélanger les deux provoque des erreurs de passerelle.
Une mise à jour a cassé ma passerelle de paiement, que faire ?
Vérifiez la compatibilité des versions du plugin, de WooCommerce et de PHP, mettez tout à jour ensemble, et reconfigurez clés API et webhooks si nécessaire.