Comment configurer les paiements WooCommerce (Stripe, PayPal) ?
Configurer les paiements WooCommerce consiste à installer l’extension officielle Stripe ou PayPal, à relier son compte marchand via des clés API, puis à basculer la passerelle en mode production après avoir validé une commande complète en mode test. Chaque passerelle se règle indépendamment, depuis WooCommerce → Réglages → Paiements.
Configurer les paiements WooCommerce, c’est installer l’extension Stripe ou PayPal, connecter son compte via des clés API, tester une commande complète en mode sandbox, puis activer le mode production avant l’ouverture publique.
Quelles passerelles de paiement choisir sur WooCommerce ?
WooCommerce propose nativement le virement bancaire et le paiement à la livraison, mais l’essentiel des ventes en ligne passe par une passerelle de carte bancaire. Notre guide de configuration complète de WooCommerce couvre l’installation générale du plugin ; cet article se concentre uniquement sur le réglage fin des moyens de paiement.
Paiement par carte directement sur le site, sans redirection, via une extension officielle gratuite.
Redirection vers PayPal ou paiement intégré selon l’offre, utile pour les acheteurs déjà équipés d’un compte.
Inclus nativement, adaptés au B2B ou aux zones de livraison de proximité.
Comment configurer Stripe sur WooCommerce ?
L’extension officielle « WooPayments » ou « Stripe pour WooCommerce » connecte directement un compte Stripe à la boutique, sans redirection du client vers un site tiers au moment du paiement.
- 1. Créer un compte StripeSur stripe.com, avec les informations légales de l’entreprise (SIRET, IBAN de reversement).
- 2. Installer l’extension StripeMenu Extensions → Ajouter, rechercher « Stripe » ou « WooPayments », installer puis activer.
- 3. Renseigner les clés APIDans WooCommerce → Réglages → Paiements → Stripe, copier la clé publique et la clé secrète depuis le tableau de bord Stripe.
- 4. Activer le mode testCocher l’option de test pour valider le parcours d’achat avant tout encaissement réel.
Comment configurer PayPal sur WooCommerce ?
PayPal fonctionne selon un principe proche de Stripe, mais s’appuie sur un compte marchand PayPal Business plutôt qu’un compte Stripe.
- 5. Créer un compte PayPal BusinessSur paypal.com, en choisissant l’offre professionnelle adaptée à la vente en ligne.
- 6. Installer l’extension PayPal PaymentsExtension officielle disponible depuis le répertoire WordPress ou directement depuis l’assistant WooCommerce.
- 7. Connecter le compte via OAuthUn bouton de connexion directe évite de manipuler manuellement des clés API pour PayPal, contrairement à Stripe.
- 8. Choisir le mode d’affichageBouton PayPal classique avec redirection, ou paiement par carte intégré selon l’offre souscrite.
Comment tester un paiement en mode sandbox avant l’ouverture ?
Chaque passerelle propose un environnement de test, appelé sandbox, qui simule un paiement sans mouvement d’argent réel. Stripe fournit des numéros de carte fictifs documentés officiellement (par exemple une carte qui simule toujours un paiement réussi, et une autre qui simule toujours un refus), pour vérifier aussi bien le scénario de succès que celui d’échec.
Une boutique restée en mode test affiche un parcours d’achat qui semble fonctionner, mais aucun paiement n’est réellement encaissé — l’erreur la plus fréquente lors d’une première ouverture.
Quelles commissions prévoir selon la passerelle de paiement ?
Chaque passerelle prélève une commission par transaction, généralement composée d’un pourcentage et d’un montant fixe, prélevée directement sur chaque vente. Ces taux évoluent régulièrement et doivent être vérifiés sur le site officiel de chaque prestataire avant de fixer ses marges.
| Passerelle | Structure de commission (au 1er juillet 2026) |
|---|---|
| Stripe | Pourcentage par transaction + montant fixe, variable selon le type de carte et le pays d’émission |
| PayPal | Pourcentage par transaction + montant fixe, souvent légèrement supérieur à Stripe sur les petits montants |
| Virement bancaire | Aucune commission par transaction, mais délai d’encaissement plus long |
Pour un catalogue à faible marge unitaire, ce détail change réellement la rentabilité d’une boutique : mieux vaut comparer les grilles tarifaires officielles de Stripe et PayPal avant de choisir la passerelle par défaut plutôt que de proposer les deux dès le lancement. Les cartes émises hors de l’Union européenne ou dans une devise étrangère déclenchent généralement une commission additionnelle, à anticiper si une partie de la clientèle vient de l’export.
Le virement bancaire reste la seule option sans commission par transaction, mais son délai d’encaissement (parfois plusieurs jours ouvrés) le rend peu adapté à une boutique qui doit expédier rapidement après paiement. Il garde en revanche tout son intérêt pour les commandes B2B à montant élevé, où les frais en pourcentage de Stripe ou PayPal deviennent significatifs en valeur absolue.
Que faire en cas d’échec de paiement ou de webhook manquant ?
Un paiement qui échoue silencieusement, ou une commande qui reste bloquée « en attente » alors que le client a bien été débité, vient presque toujours d’un webhook mal configuré : c’est ce mécanisme qui informe WooCommerce qu’un paiement Stripe ou PayPal a réellement abouti. Sans lui, la boutique n’a aucun moyen de savoir que l’argent est arrivé, même si le relevé bancaire du client l’indique.
Avant de contacter le support de la passerelle, une vérification en trois temps suffit à isoler la majorité des cas : contrôler que l’URL de webhook affichée dans WooCommerce correspond exactement à celle enregistrée côté Stripe ou PayPal, vérifier que le certificat SSL du site est valide et à jour, puis consulter le journal d’événements du tableau de bord Stripe ou PayPal pour voir si la notification a été envoyée et, le cas échéant, quelle erreur le serveur a renvoyée.
Bonnes pratiques
- Vérifier l’URL de webhook indiquée par l’extension dans le tableau de bord Stripe ou PayPal.
- Conserver une seule passerelle active en mode test à la fois, pour éviter la confusion des journaux.
- Consulter les journaux de l’extension avant de contacter le support du prestataire.
Erreurs fréquentes
- Oublier de resynchroniser le webhook après un changement de nom de domaine.
- Confondre clé de test et clé de production dans les réglages Stripe.
- Ignorer un certificat SSL expiré, qui bloque silencieusement les webhooks entrants.
Ce que nous observons chez les projets que nous accompagnons
Voici un exemple représentatif de notre pratique, sans donnée client ni chiffre inventé.
Une migration de domaine qui coupe les webhooks Stripe
Chez Amari Agency, il nous est arrivé de reprendre une boutique WooCommerce dont les commandes restaient bloquées « en attente de paiement » après une migration vers un nouveau nom de domaine : l’URL de webhook enregistrée côté Stripe pointait encore vers l’ancienne adresse. Une simple resynchronisation de l’extension a suffi à rétablir la confirmation automatique des commandes.
Quels contenus lire ensuite ?
Ces ressources complètent ce tutoriel sans cibler la même requête :
Questions fréquentes sur les paiements WooCommerce
Peut-on activer Stripe et PayPal en même temps sur WooCommerce ?
Oui, les deux passerelles peuvent coexister : le client choisit son moyen de paiement préféré au moment de valider sa commande.
Faut-il un certificat SSL pour accepter les paiements par carte ?
Oui, indispensable : sans connexion sécurisée, Stripe et PayPal refusent généralement de traiter la transaction et affichent un avertissement au client.
Combien de temps prend la validation d’un compte Stripe ou PayPal Business ?
Généralement quelques heures à quelques jours ouvrés, selon les vérifications d’identité et de statut légal de l’entreprise demandées par le prestataire.
Que faire si une commande reste bloquée en attente de paiement ?
Vérifier en priorité l’URL de webhook enregistrée côté Stripe ou PayPal : c’est la cause la plus fréquente d’une confirmation de commande qui n’arrive jamais.
Peut-on tester un paiement réel sans facturer réellement le client ?
Oui, en passant une commande test avec un vrai moyen de paiement puis en la remboursant immédiatement depuis le tableau de bord Stripe ou PayPal.