Difference between revisions of "Module PayPal FR"

Latest revision as of 16:56, 14 October 2023

PayPal
Numéro/ID du module	50200
Doc utilisateur du module	Cette page
Doc développeur du module	None

Introduction

Ce module permet de gérer l'intégration des comptes professionnels Paypal à Dolibarr afin que vos clients puissent payer en ligne de manière autonome : factures, adhésions, ou "des dons".

A noter que PayPal permet à vos clients de payer en ligne par carte bancaire même s'ils ne possèdent pas de compte PayPal.

Installation

Ce module est livré en standard avec la distribution de Dolibarr, aussi il est déjà installé.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Account creation

Visitez paypal.com pour créer un Compte professionnel et effectuez toutes les étapes de vérification d'identité qui correspondent à votre organisation (entreprise avec des frais PayPal réguliers, organisation à but non lucratif avec des frais moins élevés, ...).

Configurer l'API PayPal NVP/SOAP (version legacy) pour Dolibarr

1. Notez que l'interface utilisateur de PayPal change régulièrement et que vous pouvez être confronté à des écrans différents. Cette procédure a été mise à jour en décembre 2022 et nécessite de configurer paypal.com et NON développeur.paypal.com.

2. Cliquez sur ici pour ouvrir la configuration de l'accès à l'API, ou si ce lien est rompu, allez dans paypal.com, et ouvrez ce qui suit : Paramètres du compte > Accès au compte > Accès API > cliquez sur Mettre à jour et sélectionnez l'API NVP/SOAP (version legacy).

3. Demandez un accès API, et plus précisément une signature API comme sur la capture d'écran :

UI française pour la demande d'accès API

4. Vous devez obtenir 3 champs pour le Nom d'utilisateur API, le Mot de passe API et la signature :

UI française pour le nom d'utilisateur, le mot de passe et la signature de l'API.

'IMPORTANT : PayPal dispose de plusieurs API, n'essayez donc pas d'utiliser d'autres informations d'identification API si elles ne sont pas nommées Nom d'utilisateur API, Mot de passe API' et signature. En particulier, ne créez PAS une application pour l'~~API REST~~ qui vous donnerait un ~~compte, un ID Client et un Secret~~ puisque Dolibarr ne serait pas compatible avec eux.

5.a. Ouvrez la configuration du module PayPal dans Dolibarr et :

Cochez la case PayPal Live, car le bac à sable semble générer des erreurs
Copiez/collez le nom d'utilisateur, le mot de passe et la signature. Assurez-vous de ne copier/coller aucun espace de fin
Activer TLS v1.2

5.b. Personnalisez n'importe quel autre champ dans le reste de la configuration du module dans Dolibarr pour qu'il corresponde à vos besoins et appliquez les modifications. 5.c. Ouvrez l'un des liens de paiement proposés en bas de page pour tester votre intégration PayPal dans Dolibarr.

Troubleshooting

SetExpressCheckout failed: Security error code 10002

French Dolibarr error message for a PayPal security error code 10002

Vérifiez que:

Vous avez activé TLS 1.2 dans la configuration du module Dolibarr
Vous avez activé l'environnement Live, car l'environnement sandbox renvoie souvent cette erreur

@@ Line 1: / Line 1: @@
+<!-- BEGIN interlang links -->
+<!-- Do NOT edit this section
+     Links below are automatically managed by PolyglotBot
+     You can edit links on the English source page : Module_Google -->
+[[en:Module_PayPal]]
+<!-- END interlang links -->
 {{TemplateDocUtil}}
 {{TemplateModFR}}
-{{BasculeDevUtil|
+{{BasculeDevUser|
 nom=PayPal|
-num=TODO|
+num=50200|
 devdoc=None|
-userdoc=This page|}}
+userdoc=Cette page|}}
 =Introduction=
@@ Line 21: / Line 28: @@
 =Account creation=
-Visit paypal.com to create a '''Business Account''', and make all ID verification steps that match your organization (company with regular PayPal fees, non-profit with lower fees, ...).
+Visitez paypal.com pour créer un '''Compte professionnel''' et effectuez toutes les étapes de vérification d'identité qui correspondent à votre organisation (entreprise avec des frais PayPal réguliers, organisation à but non lucratif avec des frais moins élevés, ...).
+=Configurer l'API PayPal NVP/SOAP (version legacy) pour Dolibarr=
+. Notez que l'interface utilisateur de PayPal change régulièrement et que vous pouvez être confronté à des écrans différents. Cette procédure a été mise à jour en décembre 2022 et nécessite de configurer paypal.com et NON développeur.paypal.com.
-=Setup PayPal NVP/SOAP API (legacy version) for Dolibarr=
+. Cliquez sur [https://www.paypal.com/businessprofile/mytools/apiaccess/firstparty ici pour ouvrir la configuration de l'accès à l'API], ou si ce lien est rompu, allez dans '''paypal.com''', et ouvrez ce qui suit : '''Paramètres du compte''' > '''Accès au compte''' > '''Accès API''' > cliquez sur '''Mettre à jour''' et sélectionnez l''''API NVP/SOAP (version legacy)'''.
-. Note that PayPal user interface changes on a regular basis and you may face different screens. This procedure has been updated in December 2022 and requires to setup paypal.com and NOT developer.paypal.com.
-. Click [https://www.paypal.com/businessprofile/mytools/apiaccess/firstparty here to open the API access configuration], or if that link is broken, go in '''paypal.com''', and open the following: '''Account Parameters''' > '''Account Access''' > '''API access''' > click '''Update''' and select the '''NVP/SOAP API (legacy version)'''.
+. Demandez un accès API, et plus précisément une '''signature API''' comme sur la capture d'écran :
-. Request an API access, and more precisely an '''API signature''' as on the screenshot:
+[[File:Demander des identifiants API.png|UI française pour la demande d'accès API|alt=|center|frame]]
-[[File:Demander des identifiants API.png|French UI for the request of API access|alt=|center|frame]]
+. Vous devez obtenir 3 champs pour le '''Nom d'utilisateur API''', le '''Mot de passe API''' et la '''signature''' :
-. You must obtain 3 fields for the '''API username''', '''API password''' and '''signature''':
+[[File:Nom d'utilisateur API, mot de passe et signature.png|UI française pour le nom d'utilisateur, le mot de passe et la signature de l'API.|alt=|center|frame]]
-[[File:Nom d'utilisateur API, mot de passe et signature.png|French UI for the API username, password and signature.|alt=|center|frame]]
+'''<u>IMPORTANT :</u>''' PayPal dispose de plusieurs API, n'essayez donc pas d'utiliser d'autres informations d'identification API si elles ne sont pas nommées '''Nom d'utilisateur API''', '''Mot de passe API' '' et '''signature'''. En particulier, ne créez PAS une application pour l'<s>API REST</s> qui vous donnerait un <s>compte, un ID Client et un Secret</s> puisque Dolibarr ne serait pas compatible avec eux.
-'''<u>IMPORTANT:</u>''' PayPal has several APIs, thus do not try to use any other API credential if they are not named '''API username''', '''API password''' and '''signature'''. In particular, do NOT create an app for the <s>REST API</s> that would give you an <s>account, Client ID and Secret</s> since Dolibarr would not be compatible with them.
+.a. Ouvrez la configuration du module PayPal dans Dolibarr et :
-.a. Open the configuration of the PayPal module in Dolibarr and:
+*Cochez la case '''PayPal Live''', car le bac à sable semble générer des erreurs
+*Copiez/collez le nom d'utilisateur, le mot de passe et la signature. Assurez-vous de ne copier/coller aucun espace de fin
+*Activer '''TLS v1.2'''
-*Check the '''PayPal Live checkbox''', since the sandbox seem to generate errors
+.b. Personnalisez n'importe quel autre champ dans le reste de la configuration du module dans Dolibarr pour qu'il corresponde à vos besoins et appliquez les modifications.
-*Copy/paste the username, password and signature. Make sure that you copy/paste no trailing space characters
+.c. Ouvrez l'un des liens de paiement proposés en bas de page pour tester votre intégration PayPal dans Dolibarr.
-*Enable '''TLS v1.2'''
-.b. Customize any other field in the rest of the module configuration in Dolibarr to match your needs and apply changes.
-.c. Open one of the payment links proposed at the bottom of the page to test your PayPal integration in Dolibarr.
 =Troubleshooting=
@@ Line 51: / Line 59: @@
 [[File:Security Error 10002.png|thumb|French Dolibarr error message for a PayPal security error code 10002 ]]
-Make sure that:
+Vérifiez que:
-*You enabled TLS 1.2 in the Dolibarr module configuration
+*Vous avez activé TLS 1.2 dans la configuration du module Dolibarr
-*You enabled the Live environment, since the sandbox environment often returns that error
+*Vous avez activé l'environnement Live, car l'environnement sandbox renvoie souvent cette erreur