Line 3:
Line 3:
{{BasculeDevUser|
{{BasculeDevUser|
nom=PayPal|
nom=PayPal|
−
num=TODO|
+
num=50200|
devdoc=None|
devdoc=None|
−
userdoc=This page|}}
+
userdoc=Cette page|}}
=Introduction=
=Introduction=
Line 21:
Line 21:
=Account creation=
=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, ...).
−
=Setup PayPal NVP/SOAP API (legacy version) for Dolibarr=
+
=Configurer l'API PayPal NVP/SOAP (version legacy) pour Dolibarr=
−
1. 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.
+
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. 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)'''.
+
2. 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)'''.
−
3. Request an API access, and more precisely an '''API signature''' as on the screenshot:
+
3. Demandez un accès API, et plus précisément une '''signature API''' comme sur la capture d'écran :
−
[[File:Demander des identifiants API.png|French UI for the request of API access|alt=|center|frame]]
+
[[File:Demander des identifiants API.png|UI française pour la demande d'accès API|alt=|center|frame]]
−
4. You must obtain 3 fields for the '''API username''', '''API password''' and '''signature''':
+
4. Vous devez obtenir 3 champs pour le '''Nom d'utilisateur API''', le '''Mot de passe API''' et la '''signature''' :
−
[[File:Nom d'utilisateur API, mot de passe et signature.png|French UI for the API username, password and signature.|alt=|center|frame]]
+
[[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]]
−
'''<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.
+
'''<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.
−
5.a. Open the configuration of the PayPal module in Dolibarr and:
+
5.a. Ouvrez la configuration du module PayPal dans Dolibarr et :
−
*Check the '''PayPal Live checkbox''', since the sandbox seem to generate errors
+
*Cochez la case '''PayPal Live''', car le bac à sable semble générer des erreurs
−
*Copy/paste the username, password and signature. Make sure that you copy/paste no trailing space characters
+
*Copiez/collez le nom d'utilisateur, le mot de passe et la signature. Assurez-vous de ne copier/coller aucun espace de fin
−
*Enable '''TLS v1.2'''
+
*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.
−
5.b. Customize any other field in the rest of the module configuration in Dolibarr to match your needs and apply changes.
−
5.c. Open one of the payment links proposed at the bottom of the page to test your PayPal integration in Dolibarr.
=Troubleshooting=
=Troubleshooting=