PayPal est la deuxième passerelle de paiement la plus utilisée pour les abonnements WooCommerce, et elle compte particulièrement pour les clients des régions où c’est le moyen de paiement préféré (Allemagne, une partie de l’Europe et de nombreux marchés internationaux). En revanche, les abonnements PayPal exigent que les « Reference Transactions » soient activées sur votre compte avant que la facturation récurrente ne fonctionne : PayPal ne l’active pas par défaut, et il faut en faire la demande manuellement.
Ce guide couvre toute la configuration, y compris la démarche pour activer les Reference Transactions.
Pourquoi c’est important
Proposer PayPal comme moyen de paiement peut augmenter la conversion de 5 à 15 % sur les marchés où les clients le préfèrent. Les utilisateurs de PayPal font souvent plus confiance à la marque, pour la sécurité et la résolution des litiges, qu’à la saisie directe de leurs données de carte.
Pour les clients internationaux surtout, PayPal supprime les frictions liées à la conversion de devises étrangères et aux noms de marchands inconnus. Stripe doit rester votre passerelle principale, mais ajouter PayPal en option secondaire capte les clients qui abandonneraient sinon la commande.
La configuration demande un vrai travail, mais c’est un effort ponctuel.
Avant de commencer
- Un compte PayPal Business (les comptes personnels ne prennent pas en charge les paiements récurrents)
- Les Reference Transactions activées sur votre compte PayPal (demande manuelle nécessaire)
- WPSubscription installé et activé
- Les identifiants API PayPal (Client ID et Secret, depuis le tableau de bord PayPal Developer)
- Un accès administrateur à votre compte PayPal pour la configuration des webhooks et de l’IPN
Instructions pas à pas
- 01
Activer les Reference Transactions sur votre compte PayPal
La fonction Reference Transactions de PayPal est indispensable à la facturation récurrente automatique, mais elle n’est pas activée par défaut. Contactez l’assistance technique PayPal pour les marchands (Merchant Technical Support) et demandez explicitement l’activation des « Reference Transactions » sur votre compte Business.
Le traitement de la demande prend en général 1 à 5 jours ouvrés. Sans cela, WooCommerce ne peut traiter que le premier paiement de l’abonnement : tous les renouvellements suivants échoueront.
C’est la raison la plus fréquente pour laquelle les abonnements PayPal ne fonctionnent pas correctement.
- 02
Connecter PayPal à WooCommerce
Allez dans WooCommerce → Réglages → Paiements → PayPal. Deux modes de connexion s’offrent à vous : 1) cliquer sur « Se connecter avec PayPal » et vous identifier sur votre compte PayPal Business pour autoriser la connexion (plus simple, recommandé), ou 2) utiliser des identifiants API manuels : récupérez votre Client ID et votre Secret dans PayPal Developer → My Apps & Credentials → votre application, puis saisissez-les dans les réglages PayPal de WooCommerce.
Les deux méthodes fonctionnent ; la connexion OAuth est plus simple pour ceux qui ne sont pas développeurs.
- 03
Activer le mode Sandbox pour les tests
Dans les réglages de la passerelle PayPal, activez le mode Sandbox et saisissez les identifiants Sandbox (de test). Allez sur developer.paypal.com → Sandbox → Accounts pour créer des comptes acheteur et marchand Sandbox destinés aux tests.
Le Sandbox permet de tester le parcours d’abonnement complet sans argent réel. Effectuez un achat d’abonnement de test avec un compte acheteur Sandbox pour vérifier que l’intégration fonctionne avant de passer en production.
- 04
Configurer les notifications IPN
PayPal utilise les Instant Payment Notifications (IPN) pour informer WooCommerce des événements d’abonnement. Dans votre compte PayPal, allez dans Paramètres du compte → Notifications → Notifications instantanées de paiement.
Définissez l’URL de notification sur : https://votresite.com/?wc-api=WC_Gateway_Paypal. Activez l’IPN.
Enregistrez les modifications. Sans IPN correctement configurée, WooCommerce ne sera pas informé des paiements de renouvellement et l’état de vos abonnements sera désynchronisé de celui de PayPal.
- 05
Tester le parcours d’abonnement complet
Abonnez-vous en tant qu’acheteur Sandbox à un produit d’abonnement de test. Vérifiez que le paiement initial est bien traité et que l’abonnement apparaît dans WooCommerce → Subscriptions.
Vérifiez ensuite un renouvellement : PayPal n’a pas de fonction de « test clock » comme Stripe, vous devrez donc peut-être attendre un vrai cycle de renouvellement ou utiliser les fonctions de simulation de l’écoulement du temps du Sandbox. Vérifiez que l’e-mail de renouvellement est envoyé, que la commande est créée dans WooCommerce et que le paiement est enregistré sur votre compte PayPal Sandbox.
- 06
Passer en mode production et activer
Quand les tests de bout en bout confirment que tout fonctionne dans le Sandbox, passez en mode production : désactivez le mode Sandbox dans WooCommerce → Réglages → Paiements → PayPal, remplacez les identifiants API Sandbox par les identifiants de production, mettez à jour l’URL de l’IPN pour qu’elle pointe vers votre compte PayPal de production et confirmez que les Reference Transactions sont activées sur ce compte. Effectuez un petit abonnement de test avec de l’argent réel pour vérifier que l’intégration de production fonctionne avant le lancement public.
Conseils d’expert
- Demandez l’activation des Reference Transactions le plus tôt possible : cela prend 1 à 5 jours ouvrés, intégrez ce délai à votre calendrier de lancement
- Proposez PayPal en plus de Stripe plutôt qu’à sa place : chaque client a sa passerelle préférée
- Testez soigneusement les parcours de renouvellement : PayPal présente plus de cas particuliers que Stripe pour les abonnements
- Surveillez les litiges PayPal chaque semaine : leur volume est en général plus élevé que celui des rétrofacturations Stripe
- Documentez votre configuration PayPal en détail : l’exigence des Reference Transactions prend de court de nombreux marchands
Résultat
PayPal est entièrement configuré pour la facturation d’abonnements récurrents dans WooCommerce. Vos clients qui préfèrent PayPal peuvent désormais s’abonner avec des prélèvements de renouvellement automatiques à chaque cycle de facturation.
Associé à Stripe comme passerelle principale, PayPal vous permet de répondre aux préférences de paiement de l’ensemble de vos clients.
Dépannage
Problème :PayPal ne prélève que le premier paiement et ne renouvelle pas automatiquement
Solution :Cela signifie presque toujours que les Reference Transactions ne sont pas activées sur votre compte PayPal Business. Contactez l’assistance technique PayPal pour les marchands afin de vérifier et d’activer cette fonction. C’est une procédure d’approbation manuelle que PayPal n’active pas par défaut. Il n’existe aucune solution de contournement : sans Reference Transactions, les paiements récurrents automatiques ne peuvent tout simplement pas fonctionner via PayPal.
Problème :La commande de renouvellement est créée dans WooCommerce mais PayPal ne prélève pas
Solution :Consultez WooCommerce → Statut → Journaux pour repérer les erreurs d’IPN PayPal. Causes courantes : URL de notification IPN incorrecte, confusion entre les modes Sandbox et production, ou blocage d’adresses IP qui empêche PayPal d’atteindre votre serveur (certains pare-feu bloquent les IP de PayPal). Vérifiez que l’URL de l’IPN est accessible publiquement et que les serveurs de PayPal peuvent l’atteindre.
Problème :Les litiges PayPal s’accumulent plus vite que sur Stripe
Solution :Le processus de litige de PayPal est plus favorable au client que celui des rétrofacturations : le volume de litiges est plus élevé, mais leur résolution est plus simple. Répondez rapidement à chaque litige avec des preuves (conditions d’inscription, échanges, données d’utilisation). Simplifiez la résiliation depuis Mon compte : les litiges PayPal sont souvent ouverts par des clients qui n’ont pas trouvé comment résilier.
Problème :Des clients ne peuvent pas finaliser leur commande parce qu’ils n’ont pas de compte PayPal
Solution :PayPal peut être configuré pour accepter les paiements par carte de clients sans compte PayPal : c’est ce qu’on appelle le « paiement invité » ou les « PayPal Smart Buttons ». Activez cette option dans les paramètres de votre compte PayPal. Sans elle, les clients sans compte PayPal ne peuvent pas utiliser cette passerelle, ce qui réduit nettement la conversion par rapport à Stripe.
Questions fréquentes
Pourquoi faut-il activer les Reference Transactions pour les abonnements PayPal ?
Dois-je utiliser PayPal comme passerelle principale ou secondaire ?
Quelle est la différence entre l’IPN et les webhooks ?
Les frais d’abonnement de PayPal sont-ils plus élevés que ceux de Stripe ?
Puis-je migrer des abonnements PayPal existants vers Stripe ?
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 intégrer Stripe aux abonnements WooCommerce
6 étapes · Connectez Stripe à WPSubscription pour une facturation récurrente fiable, des webhooks et la récupération des paiements.
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.
