Stripe est la passerelle de paiement la plus répandue et la plus riche en fonctions pour la facturation d’abonnements WooCommerce. Ce guide détaille l’intégration complète de Stripe avec WPSubscription : de la connexion des clés API à la configuration des webhooks, en passant par l’activation de Smart Retries pour les paiements échoués et la mise en place de l’authentification 3D Secure conforme à la SCA.
L’intégration complète prend 30 à 45 minutes si vous procédez avec soin, et donne un système de facturation d’abonnements qui tourne de façon fiable à grande échelle.
Pourquoi c’est important
Stripe offre la meilleure combinaison de fonctions pour les entreprises d’abonnement : Smart Retries (nouvelles tentatives optimisées par machine learning, qui récupèrent 10 à 20 % de paiements échoués en plus qu’une nouvelle tentative classique), Card Updater (actualisation automatique des cartes expirées sans action du client), une excellente prise en charge du 3DS pour la conformité SCA et les webhooks les plus fiables du secteur. Stripe propose aussi la meilleure documentation pour les développeurs, les taux de refus les plus bas côté banques émettrices et la couverture internationale la plus large (plus de 40 pays).
Pour la plupart des boutiques d’abonnement WooCommerce, Stripe est le choix par défaut évident : des concurrents comme PayPal répondent à des cas d’usage précis, mais Stripe reste le cheval de trait.
Avant de commencer
- Un compte Stripe (création gratuite sur stripe.com)
- WPSubscription installé et activé
- Un accès administrateur à WordPress et à votre tableau de bord Stripe
- La vérification de votre entreprise terminée dans Stripe (obligatoire avant le passage en production)
- Un certificat SSL actif sur votre site WordPress (obligatoire en mode production)
Instructions pas à pas
- 01
Récupérer vos clés API Stripe
Connectez-vous à votre tableau de bord Stripe sur dashboard.stripe.com. Allez dans Développeurs → Clés API.
Vous verrez deux jeux de clés : le mode test (pour le développement) et le mode production (pour la boutique en ligne). Copiez votre clé publiable (commence par pk_) et votre clé secrète (commence par sk_).
Pour la configuration initiale, utilisez les clés du mode test (pk_test_ / sk_test_) : vous passerez aux clés de production une fois l’intégration vérifiée de bout en bout. Gardez votre clé secrète confidentielle, comme un mot de passe.
- 02
Saisir les clés API dans WooCommerce
Dans l’administration WordPress, allez dans WooCommerce → Réglages → Paiements → Stripe. Si Stripe n’apparaît pas, vous devrez peut-être d’abord installer l’extension WooCommerce Stripe Payment Gateway.
Collez votre clé publiable dans le champ « Clé publiable » et votre clé secrète dans le champ « Clé secrète ». Activez pour l’instant l’option « Mode test ».
Configurez les fonctions Stripe supplémentaires selon vos besoins : Stripe Link pour le paiement en un clic, Apple Pay, Google Pay. Enregistrez les modifications.
- 03
Configurer les webhooks Stripe
Dans votre tableau de bord Stripe, allez dans Développeurs → Webhooks → Ajouter un point de terminaison. Définissez l’URL du point de terminaison sur : https://votresite.com/wc-api/wc_stripe (remplacez votresite.com par votre vrai domaine ; https est obligatoire).
Sous « Événements à écouter », sélectionnez au minimum : payment_intent.succeeded, payment_intent.payment_failed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Enregistrez et copiez le secret de signature généré par Stripe (commence par whsec_).
- 04
Ajouter le secret de signature du webhook dans WooCommerce
Collez le secret de signature du webhook Stripe dans le champ WooCommerce → Réglages → Paiements → Stripe → Secret du webhook. Cette étape est essentielle : sans elle, WooCommerce ne peut pas vérifier que les événements de webhook reçus proviennent bien de Stripe, et les renouvellements risquent de ne pas se déclencher.
Le secret de signature est différent pour les webhooks du mode test et du mode production : vous devrez le mettre à jour lors du passage en production. Enregistrez les modifications.
- 05
Activer Smart Retries et Card Updater
Dans votre tableau de bord Stripe, allez dans Paramètres → Abonnements et facturation. Activez « Smart Retries » : la logique de nouvelle tentative de Stripe, pilotée par machine learning, qui optimise le moment des nouvelles tentatives selon le motif précis du refus et les habitudes des banques.
Activez aussi « Card Updater » s’il est disponible : il actualise automatiquement les données des cartes expirées auprès de la banque du client, sans action de sa part. Ces deux fonctions réduisent nettement l’attrition involontaire et constituent des améliorations quasi gratuites.
- 06
Tester puis passer en mode production
Effectuez un abonnement de test avec la carte de test Stripe 4242 4242 4242 4242, n’importe quelle date d’expiration future et n’importe quel code CVC à 3 chiffres. Vérifiez qu’il apparaît dans WooCommerce → Subscriptions et dans Stripe sous Clients.
Consultez le tableau de bord des webhooks Stripe pour vérifier que les événements sont bien livrés (réponses 200). Testez un renouvellement avec les Test Clocks de Stripe pour avancer dans le temps.
Une fois tout confirmé, retournez dans WooCommerce → Réglages → Paiements → Stripe, désactivez le mode test, remplacez les clés de test par les clés de production, mettez à jour le webhook avec le secret de signature du mode production, et effectuez un dernier petit test avec de l’argent réel.
Conseils d’expert
- Activez Smart Retries dès le départ : l’optimisation des nouvelles tentatives par machine learning de Stripe récupère 10 à 20 % de paiements échoués en plus
- Configurez Stripe Tax pour calculer et reverser automatiquement la taxe de vente ou la TVA à chaque renouvellement
- Utilisez Stripe Radar pour détecter la fraude : le score de risque par machine learning repère les abonnements frauduleux avant leur activation
- Mettez en place des requêtes Stripe Sigma pour des analyses d’abonnements sur mesure, au-delà de ce que montre le tableau de bord
- Activez le portail client Stripe (Customer Portal) pour la gestion des abonnements en libre-service, en complément de l’espace Mon compte WooCommerce
Résultat
Stripe est entièrement intégré à WPSubscription : il gère la création des abonnements, la facturation récurrente automatique, la détection et la récupération des échecs de paiement via Smart Retries, l’authentification 3D Secure conforme à la SCA et le traitement des événements par webhook, le tout sans intervention manuelle.
Dépannage
Problème :Les événements de webhook apparaissent comme « échoués » dans le tableau de bord Stripe
Solution :La cause la plus fréquente est une URL de point de terminaison incorrecte ou un problème de certificat SSL. Vérifiez que l’URL est exactement votre-boutique.com/wc-api/wc_stripe (sans problème de barre oblique finale, et en https). Vérifiez que votre site a un certificat SSL valide (ni auto-signé ni expiré). Vérifiez aussi que votre site ne bloque pas les requêtes de webhook via un pare-feu, un plugin de sécurité (Wordfence, Sucuri) ou une limitation de débit.
Problème :Les abonnements apparaissent actifs mais les prélèvements de renouvellement ne se déclenchent pas
Solution :Consultez WooCommerce → Statut → Journaux pour les entrées liées à Stripe. Cela indique souvent un secret de signature de webhook manquant ou expiré. Recopiez le secret de signature depuis Stripe → Développeurs → Webhooks → votre point de terminaison → Secret de signature et mettez à jour le champ dans WooCommerce. Vérifiez aussi que le cron de WordPress fonctionne : allez dans WooCommerce → Statut → Actions planifiées.
Problème :Des clients rencontrent des erreurs d’authentification 3D Secure
Solution :C’est normal pour les clients de l’UE et du Royaume-Uni, en raison des exigences DSP2 / SCA. WPSubscription avec Stripe gère le 3DS automatiquement, mais le client doit finaliser l’authentification auprès de sa banque (code SMS, notification dans l’application bancaire, biométrie). Si le client ne parvient pas à finaliser le 3DS, il doit contacter sa banque pour vérifier que la méthode d’authentification est bien configurée. Certaines banques exigent une inscription préalable au 3DS.
Problème :Stripe prélève des clients mais aucune commande n’apparaît dans WooCommerce
Solution :Cela indique un échec de livraison du webhook : Stripe a prélevé mais n’a pas informé WooCommerce. Consultez les journaux de webhooks Stripe pour repérer les livraisons échouées. Causes courantes : URL du point de terminaison incorrecte, indisponibilité du serveur, plugin de sécurité qui bloque la requête ou secret de signature du webhook qui ne correspond pas. Rejouez les webhooks échoués depuis le tableau de bord Stripe pour resynchroniser manuellement.
Questions fréquentes
Pourquoi choisir Stripe plutôt que PayPal pour les abonnements WooCommerce ?
Combien coûte Stripe pour les abonnements ?
Comment gérer Stripe Tax avec les abonnements ?
Qu’est-ce que Stripe Radar et dois-je l’activer ?
Puis-je utiliser Stripe en mode test tout en acceptant de vrais paiements via PayPal ?
Termes du glossaire associés
D’autres guides
Comment configurer les paiements récurrents dans WooCommerce
6 étapes · Connectez votre passerelle de paiement et configurez des calendriers de facturation automatiques pour vos produits d’abonnement.
Comment gérer les paiements échoués dans WooCommerce
6 étapes · Configurez les nouvelles tentatives automatiques et les notifications client pour récupérer les paiements d’abonnement échoués.
Comment automatiser les renouvellements d’abonnements dans WooCommerce
6 étapes · Mettez en place une facturation de renouvellement entièrement automatique avec WPSubscription pour que votre revenu tourne en pilote automatique.
