Easy Digital Downloads est livré avec une intégration PayPal intégrée. Cette passerelle utilise la dernière expérience de paiement PayPal, avec des boutons intelligents et une fenêtre modale « Payer avec PayPal » qui maintient les utilisateurs sur votre site tout au long du processus de paiement. Cette documentation couvre tout ce que vous devez savoir sur la gestion de votre configuration PayPal.
Mise à niveau depuis une autre passerelle PayPal ? Consultez nos notes de mise à niveau.
NOTE : Cette intégration PayPal nécessite un certificat SSL. Si vous n’en avez pas encore, consultez notre article sur comment configurer SSL.
Configurer PayPal
1. Connectez-vous à votre compte PayPal
Vous aurez besoin d'un compte PayPal pour accepter les paiements. Si vous n'avez pas encore de compte, vous aurez la possibilité d'en créer un pendant le processus d'intégration.
Connectez-vous à votre administration WordPress et accédez à Téléchargements » Paramètres » Paiements » PayPal. Vous verrez un bouton pour vous connecter à PayPal dans le mode actuel de votre boutique (soit sandbox, soit en direct).

Cliquez sur le bouton Connect with PayPal pour ouvrir une fenêtre modale PayPal. Celle-ci vous demandera d'entrer votre adresse e-mail et votre pays. Suivez les étapes pour vous connecter à votre compte existant ou en créer un nouveau.
Important : Vous devez avoir les fenêtres contextuelles du navigateur activées pour que la page PayPal s'ouvre dans une fenêtre modale. Si vous ne voyez pas de fenêtre modale, veuillez vérifier les paramètres de fenêtres contextuelles de votre navigateur, fermez le navigateur et réessayez. Si la fenêtre contextuelle ne s'affiche toujours pas, vous pouvez essayer avec le navigateur Chrome.
Si vous vous connectez en mode test, vous devrez vous connecter avec les informations d’identification de votre compte sandbox. Si vous n’avez pas encore de compte sandbox PayPal, consultez notre article sur la façon d’en créer un.

Après avoir terminé toutes les étapes, vous devriez voir un message de succès.

Assurez-vous de cliquer sur le bouton pour revenir à votre boutique. Si vous ne cliquez pas sur ce bouton, nous ne pourrons pas terminer le processus d'intégration, et vous devrez recommencer.
2. Vérifiez le statut de votre compte
De retour dans les paramètres d'administration de l'EDD, la zone État de la connexion vérifiera votre connexion à PayPal.
Votre compte a été connecté avec succès et vous êtes prêt à accepter les paiements !

3. Configurer les méthodes de paiement disponibles
Une fois PayPal connecté, vous pouvez choisir les méthodes de paiement PayPal à activer, comme indiqué ci-dessous.

Une fois que vous avez terminé, n'oubliez pas d'enregistrer vos modifications.
4. Activer la passerelle PayPal
Vous devrez activer PayPal en tant que passerelle de paiement active pour qu'il s'affiche sur la page de paiement. Pour ce faire, basculez l'option PayPal dans l'onglet Général de Paramètres » Paiements.

Répéter en mode réel
Si vous vous êtes initialement connecté en mode test/sandbox, vous devrez répéter ce processus de connexion une fois que vous aurez fait passer votre boutique en mode réel.
Sous l'onglet Général, désactivez le Mode test. Revenez ensuite à l'onglet PayPal et sélectionnez Se connecter à PayPal en mode réel.
IPN de secours
Easy Digital Downloads vous permettra d'utiliser un service IPN de secours qui gère tous les scénarios dans lesquels un événement Webhook pourrait ne pas être livré à votre site Web.
Pour configurer l'IPN, vous devez vous connecter à votre compte PayPal et survoler l'icône d'engrenage dans le coin supérieur droit de l'écran, puis sélectionner Paramètres du compte

Cliquez sur Notifications sur le côté gauche de l'écran, puis cliquez sur Mettre à jour à côté de Notifications de paiement instantané.

Si vous n'aviez pas l'IPN activé auparavant, vous verrez un bouton Choisir les paramètres IPN. Sur la page des paramètres IPN, ajoutez l'URL de votre site Web au format : https://votresite.com/?edd-listener=eppe
Remplacez votresite.com dans le lien par l'URL réelle de votre site Web.

Cochez la case Recevoir les messages IPN (Activé), puis cliquez sur Enregistrer.
C'est tout ! Cela servira de solution de repli pour le webhook principal que la configuration PayPal utilise lors de la connexion de votre compte.
Expérience de paiement
Cette passerelle de paiement utilise les boutons de paiement modernes de PayPal. Au lieu d'un bouton « Acheter » normal, vos clients verront ceci à la fin du formulaire de paiement, ainsi que d'autres options de paiement si disponibles, telles que Venmo, Google/Apple Pay, Fastlane, Pay Later et le paiement direct par carte de crédit/débit.

Intégration des paiements récurrents
Cette passerelle PayPal prend entièrement en charge l'extension Paiements récurrents. Consultez la documentation de configuration PayPal pour les paiements récurrents pour les instructions de configuration.
Prise en charge du navigateur
La prise en charge est garantie pour les navigateurs de bureau suivants. Pour tout navigateur ne figurant pas sur cette liste, les boutons pourraient continuer à fonctionner, mais la compatibilité n'est pas garantie.
- Chrome version 41 et ultérieures
- Firefox version 43 et ultérieures
- Safari version 8 et ultérieures
- Opera version 12 et ultérieures
- Edge version 14 et ultérieures
- * Internet Explorer version 11 et ultérieures
* Remarque : Bien que les boutons devraient fonctionner sur IE11, nous devons charger plusieurs polyfills pour le rendre compatible. Pour une meilleure expérience de paiement, nous recommandons d'utiliser un navigateur plus moderne. Si vous préférez ne pas charger les polyfills IE11, vous pouvez les désactiver en ajoutant ce code personnalisé à votre site :
add_filter( 'edd_load_ie11_polyfills', '__return_false' );
Si vous ajoutez cet extrait de code, la passerelle PayPal ne fonctionnera pas sur IE11.
Pour plus d'informations sur les exigences de navigateur pour PayPal Checkout, consultez la page de prise en charge des navigateurs de PayPal.
Création d'un compte PayPal Sandbox
Le bac à sable PayPal vous permet de configurer des comptes de test qui peuvent être utilisés pour tester le processus d'achat complet dans Easy Digital Downloads avec la passerelle PayPal. Aucuns frais réels n'ont lieu, et vous pouvez l'utiliser aussi longtemps que vous le souhaitez, car il s'agit de comptes de test qui imitent le flux réel de PayPal.
Pour créer un compte sandbox, visitez https://developer.paypal.com et cliquez sur Se connecter ou S'inscrire si vous n'avez pas encore de compte PayPal. Vous pouvez vous connecter avec votre compte PayPal existant si vous en avez un.
Une fois connecté, suivez les étapes ci-dessous pour créer un compte Sandbox
- Accédez à Outils de test et gt ; Comptes Sandbox.
- Cliquez sur "Créer un compte".
- Sélectionnez « Business », choisissez le pays du compte et cliquez sur « Create Account ».
- Cliquez à nouveau sur « Create Account » et sélectionnez cette fois « Personal » comme type de compte.
Les étapes ci-dessus créeront un compte marchand que vous utiliserez pour vous connecter dans EDD et un compte personnel que vous utiliserez pendant le flux de paiement pour simuler un paiement.
Sur la page Sandbox Accounts, vous pouvez cliquer sur le compte que vous souhaitez afficher/modifier et vous pouvez voir le mot de passe par défaut qui a été défini lors de la création ou définir votre mot de passe personnalisé.
Comment puis-je être sûr que je suis en mode test ?
Pour vous assurer que votre site fonctionne en mode test, allez dans Téléchargements > Paramètres > Paiements, et cochez la case Mode test en haut de la page.
Rappel
Avant de mettre votre site en ligne, retirez-le du mode test, sinon aucune de vos ventes ne sera valide. Il peut être nécessaire de vous connecter à votre compte PayPal Live une fois que vous désactivez le mode test.
Mise à niveau depuis d’autres passerelles PayPal
La mise à niveau vers la nouvelle passerelle PayPal consiste simplement à se connecter, à suivre les étapes de configuration ci-dessus, puis à désactiver l'ancienne (les anciennes) passerelle(s).
Si vous utilisiez auparavant l'une de nos anciennes intégrations PayPal, telles que PayPal Standard, PayPal Express, PayPal Pro ou PayPal Payments Advanced, vous serez invité à passer à cette nouvelle passerelle après la mise à jour vers Easy Digital Downloads version 2.11.
Comment fonctionne la mise à niveau ?
Jusqu'à ce que vous vous connectiez à la nouvelle passerelle, les paiements continueront d'être traités via votre site en utilisant la passerelle existante que vous avez sélectionnée. Lorsque vous vous connecterez à la nouvelle intégration PayPal, vous devrez vous connecter en utilisant le même compte PayPal que vous utilisiez auparavant. Une fois le processus de connexion terminé et que vous aurez activé la nouvelle passerelle, les paiements commenceront à être traités via la nouvelle intégration PayPal. Assurez-vous de désactiver l'ancienne passerelle afin que seule la nouvelle soit active.
Dans PayPal lui-même, vous ne remarquerez aucune différence. Les paiements arriveront toujours de la même manière qu'auparavant. Seule l'expérience de paiement sur votre site a été mise à jour.
Qu'en est-il des paiements récurrents ?
Si vous utilisez notre extension Recurring Payments, vous pouvez passer en toute sécurité à la nouvelle passerelle PayPal sans affecter les abonnements existants. Les anciens abonnements continueront d'être traités et renouvelés normalement. Cependant :
- Une fois la nouvelle passerelle configurée, vous pouvez décocher l'ancienne passerelle dans la liste des passerelles de paiement activées.
- Pour PayPal Express et Pro, vous devez conserver votre ancienne configuration IPN PayPal (Documentation IPN Express / Pro), car les abonnements qui ont été créés avec l'ancienne passerelle continueront d'utiliser IPN pour informer EDD des paiements de renouvellement. PayPal Standard ne repose pas sur IPN, car l'URL est codée en dur dans l'IPN. Si vous n'utilisez pas votre compte PayPal avec plusieurs boutiques, nous vous recommandons de le définir au cas où PayPal changerait de fonctionnalité à l'avenir (Documentation IPN Standard), mais ce n'est pas obligatoire.
- Si vous utilisez PayPal Express ou PayPal Pro, vous devez garder ce plugin activé. La passerelle elle-même ne doit pas être activée (Téléchargements » Paramètres » Paiements), mais le plugin doit l'être. Ceci est pour s'assurer que la passerelle peut continuer à traiter les anciennes IPN, comme indiqué à l'étape 2.
Remarque : Vous utilisez Aelia Currency Switcher ?
PayPal devra être rajouté dans les paramètres des passerelles de paiement Aelia pour les devises prises en charge sur votre site. Sinon, PayPal ne sera plus une passerelle disponible lors du paiement.
Dois-je passer à la nouvelle intégration ?
Toutes les anciennes intégrations PayPal seront dépréciées. Elles ne recevront plus de mises à jour à l'avenir. De plus, bon nombre des anciennes intégrations sont également dépréciées du côté de PayPal et représentent des expériences de paiement plus anciennes.
Les anciennes intégrations devraient continuer à fonctionner dans EDD 2.x, mais nous vous recommandons de passer à la nouvelle passerelle avant la 3.0, car les anciennes extensions PayPal ne seront pas mises à jour pour être compatibles avec la 3.0.
FAQ
Je vois SANDHILLS DEVELOPMENT, LLC pendant le processus de connexion. Est-ce normal ?
Oui, Easy Digital Downloads est un produit de SANDHILLS DEVELOPMENT, LLC. Vous acceptez de connecter votre compte PayPal à votre boutique Easy Digital Downloads (un produit de SANDHILLS DEVELOPMENT, LLC). Malheureusement, PayPal exige l'utilisation du nom de l'entreprise au lieu du nom de notre produit.
Puis-je me connecter à PayPal avec un compte personnel ?
Un compte professionnel est requis pour connecter EDD à PayPal. Vous ne pouvez pas connecter EDD à un compte PayPal personnel. Si vous n'avez pas de compte professionnel, vous pouvez en créer un séparé et avoir plusieurs comptes PayPal si vous ne souhaitez pas transformer votre compte personnel en compte professionnel.
Pourquoi « Erreur d'authentification inattendue » s'affiche-t-il sur ma page de paiement ?
Cela est probablement dû au fait que PayPal n'est pas correctement connecté à votre boutique. Vérifiez le statut sous Téléchargements > Paramètres > Paiements > PayPal. Vous voudrez également confirmer que votre compte PayPal Live n'est pas connecté à EDD en mode test, et que votre compte PayPal Sandbox n'est pas connecté à votre connexion PayPal Live (connexion à PayPal avec le mode test désactivé).
Pourquoi PayPal ne parvient-il pas à se connecter à EDD ?
Cela peut être dû à plusieurs problèmes.
– Essayez de vous connecter via un autre navigateur ou appareil.
– Confirmez que le pays de votre compte PayPal est un pays pris en charge, indiqué dans la liste déroulante lors du processus de connexion.
– Confirmez que votre compte PayPal est entièrement actif. PayPal peut avoir des actions en attente que vous devez accomplir. Recherchez les notifications dans votre compte PayPal et/ou contactez le support PayPal pour confirmer que votre compte est actif.
Puis-je ajouter ou supprimer les boutons Payer en 3 fois ou Payer en 4 fois ?
Cette méthode de paiement peut être désactivée dans les paramètres de la passerelle PayPal à l’intérieur d’Easy Digital Downloads.
Vous pouvez également prendre en charge un nombre défini de paiements à l'aide de notre extension Paiements récurrents.
Pourquoi le paiement invité de PayPal ne s’affiche-t-il pas ?
Lors du paiement via une page de paiement sur PayPal.com, il y a parfois la possibilité de payer par carte de crédit sans se connecter à PayPal. C’est ce qu’on appelle le mode de paiement « invité » ou « compte PayPal facultatif ». Voir les instructions de PayPal ici pour activer ou désactiver. Voici comment activer le paramètre de compte PayPal facultatif :
- Survolez votre nom dans le coin supérieur droit.
- Cliquez sur Paramètres du compte dans le menu déroulant.
- Cliquez sur Paiements de site Web sous « Produits et services » à gauche de la page.
- Cliquez sur Mettre à jour à côté de « Préférences de site Web ».
- Sélectionnez Activé sous « Compte PayPal facultatif ».
Ai-je besoin du SSL si j’utilise PayPal ?
Oui, vous avez besoin du SSL activé sur votre site Web, même si les paiements sont traités hors site avec PayPal.
Les clients ne sont pas redirigés vers mon site après avoir payé.
Lorsque les gens paient avec PayPal, ils s’attendent à être redirigés vers votre site Web après avoir payé. Si cela ne fonctionne pas correctement, alors l’option de retour automatique doit probablement être activée dans votre profil PayPal.
Connectez-vous à votre compte PayPal et accédez aux paramètres de votre profil.
Dans vos paramètres, cliquez sur Préférences du site Web.
Vous aurez alors la possibilité d'activer le retour automatique.
Dans l'exemple ci-dessus, il est désactivé. Pour l'activer, choisissez le bouton radio Activé, puis dans le champ ci-dessous, assurez-vous de saisir l'adresse vers laquelle vous souhaitez que vos clients soient redirigés.
