Easy Digital Downloads est livré avec une intégration PayPal intégrée. Cette passerelle utilise la dernière expérience de paiement PayPal, utilisant 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 à l’aide de cette passerelle. 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 pour ouvrir une fenêtre modale PayPal. Cela vous invitera à saisir 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 rencontrez une erreur lors de la connexion à PayPal et que le problème persiste, cela peut être dû à des règles de serveur empêchant l’apparition de la fenêtre modale de connexion. Cela peut se présenter comme une erreur liée à la fonction `hash_equals`. Pour le résoudre, vous ou votre hébergeur devrez peut-être ajuster la `Cross-Origin-Opener-Policy`. Si la valeur est « same-origin », cela peut causer ce problème.
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 ce 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 d’EDD, la zone « État de la connexion » vérifiera votre connexion à PayPal. Il y a trois possibilités :
Succès
Votre compte a été connecté avec succès, vous êtes prêt à accepter les paiements et EDD a créé un webhook en votre nom. Vous pouvez en savoir plus sur le webhook dans la section webhook.
Succès, avec avertissement de webhook
Cela signifie que votre compte PayPal a été connecté avec succès et que vous pouvez commencer à accepter des paiements. Cependant, EDD n'a pas réussi à créer de webhook en votre nom. Ce n'est pas quelque chose dont vous devez vous inquiéter dans un environnement local, mais si cela se produit sur votre site en direct, contactez le support EDD pour obtenir de l'aide. Vous pouvez en savoir plus sur l'utilité du webhook dans la section webhook.
Erreur
Vous pouvez également recevoir un message d'erreur comme celui-ci. La plupart des erreurs dans « Statut du paiement » signifient que quelque chose dans votre compte PayPal n'est pas prêt à recevoir des paiements. Cela signifie que vous devez soit contacter le support client PayPal, soit faire quelque chose dans votre compte PayPal, comme confirmer votre adresse e-mail.
Une fois que vous avez corrigé les erreurs, cliquez sur « Re-vérifier le statut du paiement » pour vérifier à nouveau votre compte auprès de PayPal. Toutes les erreurs doivent être résolues avant que vous puissiez commencer à accepter des paiements.
3. Activer la passerelle PayPal
Une fois connecté, assurez-vous d'activer la passerelle dans les paramètres généraux de la passerelle :
Répéter en mode réel
Si vous vous connectez initialement en mode test, vous devrez répéter ce processus de connexion une fois que vous aurez fait passer votre boutique en mode réel.
Webhook
Easy Digital Downloads tentera automatiquement de créer un webhook en votre nom. Le webhook est principalement utilisé pour transmettre les actions qui se produisent dans le tableau de bord PayPal à EDD. Par exemple : si vous remboursez un paiement dans PayPal, EDD le détectera et mettra automatiquement à jour le statut du paiement dans EDD pour vous.
Les webhooks ne sont pas nécessaires pour traiter les paiements, mais ils sont recommandés pour une intégration la plus complète possible.
Vérification du statut du webhook
Vous pouvez vérifier le statut de votre webhook à tout moment en allant dans Téléchargements » Paramètres » Paiements » PayPal. Le statut du webhook sera affiché, ainsi que les événements enregistrés.
Le bouton « Synchroniser le webhook » vérifiera simplement à nouveau le statut du webhook et enregistrera les événements manquants. Vous ne devriez généralement pas avoir besoin de cliquer dessus sauf si :
- Vous avez changé l'URL de votre site ; ou
- Vous voyez un message d'avertissement indiquant que le webhook n'est pas entièrement configuré ou un avertissement concernant des événements manquants.
IPN de secours
Easy Digital Downloads vous permettra désormais 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 en haut à droite 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 activé l'IPN 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.
PayPal Commerce Pro
PayPal Commerce Pro est une extension payante qui permet aux clients de payer par carte de crédit ou de débit et par d'autres méthodes de paiement (selon votre pays), telles que Venmo, Apple Pay et Google Pay, directement sur votre site au lieu que les clients soient redirigés vers le site de PayPal.
Une fois installé et activé, un nouveau paramètre, "Activer les paiements avancés par carte de crédit et de débit", sera disponible dans les paramètres PayPal situés dans Téléchargements » Paramètres » Paiements » PayPal.
Une fois activés, les boutons "Carte de débit ou de crédit" et "Payer plus tard" (si pris en charge par votre compte PayPal) apparaîtront sur votre page de paiement, ainsi que le bouton PayPal.
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 :
Après avoir cliqué sur le bouton, une fenêtre modale s'ouvre sur PayPal.com, invitant l'utilisateur à se connecter à son compte PayPal. Le client peut effectuer l'intégralité du processus de paiement sans quitter votre site.
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 PayPal Sandbox 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 ne sont facturés, et vous pouvez l'utiliser aussi longtemps que vous le souhaitez car ce sont des 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 pourra vous être demandé de vous connecter avec votre compte PayPal Live une fois que vous aurez désactivé 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 PayPal IPN (Document IPN Express / Pro), car les abonnements 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 (Document 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 » apparaît-elle 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 réel n'est pas connecté à EDD en mode test et que votre compte Sandbox PayPal n'est pas connecté à votre connexion PayPal réelle (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 navigateur ou un appareil différent.
– Confirmez que le pays auquel votre compte PayPal est lié est un pays pris en charge, répertorié dans la liste déroulante lors du processus de connexion.
– Confirmez que votre compte PayPal est entièrement actif. Il est possible que PayPal ait 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 ?
PayPal Commerce Pro est requis pour que le bouton Payer en 3 fois ou Payer en 4 fois apparaisse sur votre site. Si le bouton apparaît et que vous souhaitez le désactiver, vous pouvez le faire via vos paramètres EDD PayPal.
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. Consultez 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 le paiement.
Lorsque les gens paient avec PayPal, ils s'attendent à être redirigés vers votre site Web après le paiement. Si cela ne fonctionne pas correctement, l'option de retour automatique doit probablement être activée dans votre profil PayPal.
Log into your PayPal account and go to your profile settings.
In your settings, click on Website Preferences.
There you will have an option to enable automatic return.
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.
