Module PayPal FR - Revision history

Eldy: /* SetExpressCheckout failed: Security error code 10002 */

2023-10-14T16:56:17Z

SetExpressCheckout failed: Security error code 10002

← Older revision		Revision as of 16:56, 14 October 2023
Line 59:		Line 59:
	[[File:Security Error 10002.png\|thumb\|French Dolibarr error message for a PayPal security error code 10002 ]]		[[File:Security Error 10002.png\|thumb\|French Dolibarr error message for a PayPal security error code 10002 ]]

	~~Sois sûr~~ que:		Vérifiez que:

	*Vous avez activé TLS 1.2 dans la configuration du module Dolibarr		*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		*Vous avez activé l'environnement Live, car l'environnement sandbox renvoie souvent cette erreur

Eldy at 16:55, 14 October 2023

2023-10-14T16:55:16Z

← Older revision		Revision as of 16:55, 14 October 2023
Line 3:		Line 3:
	Links below are automatically managed by PolyglotBot		Links below are automatically managed by PolyglotBot
	You can edit links on the English source page : Module_Google -->		You can edit links on the English source page : Module_Google -->
	[[en:~~Module_Paypal~~]]		[[en:Module_PayPal]]
	<!-- END interlang links -->		<!-- END interlang links -->

Eldy at 16:53, 14 October 2023

2023-10-14T16:53:28Z

← Older revision		Revision as of 16:53, 14 October 2023
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}}		{{TemplateDocUtil}}
	{{TemplateModFR}}		{{TemplateModFR}}

Eldy: /* SetExpressCheckout failed: Security error code 10002 */

2023-10-14T16:32:28Z

SetExpressCheckout failed: Security error code 10002

← Older revision		Revision as of 16:32, 14 October 2023
Line 52:		Line 52:
	[[File:Security Error 10002.png\|thumb\|French Dolibarr error message for a PayPal security error code 10002 ]]		[[File:Security Error 10002.png\|thumb\|French Dolibarr error message for a PayPal security error code 10002 ]]

	~~Make sure that~~:		Sois sûr 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

Eldy at 16:32, 14 October 2023

2023-10-14T16:32:06Z

← Older revision		Revision as of 16:32, 14 October 2023
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=

Eldy at 16:24, 14 October 2023

2023-10-14T16:24:44Z

← Older revision		Revision as of 16:24, 14 October 2023
Line 1:		Line 1:
	{{TemplateDocUtil}}		{{TemplateDocUtil}}
	{{TemplateModFR}}		{{TemplateModFR}}
	{{~~BasculeDevUtil~~\|		{{BasculeDevUser\|
	nom=PayPal\|		nom=PayPal\|
	num=TODO\|		num=TODO\|

Eldy at 16:24, 14 October 2023

2023-10-14T16:24:12Z

← Older revision		Revision as of 16:24, 14 October 2023
Line 1:		Line 1:
	{{~~TemplateDocUser~~}}		{{TemplateDocUtil}}
	{{~~TemplateModEN~~}}		{{TemplateModFR}}
	{{~~BasculeDevUser~~\|		{{BasculeDevUtil\|
	nom=PayPal\|		nom=PayPal\|
	num=TODO\|		num=TODO\|
Line 8:		Line 8:

	=Introduction=		=Introduction=
	~~This~~ module ~~is to manage integration of~~ '''Paypal ~~business accounts~~''' to Dolibarr ~~so that your customers can~~ '''~~autonomously pay online~~''': '''~~invoices~~''', '''~~memberships~~''', ~~or '''donations'''~~.		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".

	~~Note that~~ PayPal ~~allows you customers to pay online by credit card even if they do not owe a~~ PayPal ~~account~~.		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.

	<br />		<br />

	=Installation=		=Installation=
	{{~~NoInstallModuleEn~~}}		{{NoInstallModuleFr}}

	=Configuration=		=Configuration=
	{{~~ActivationModuleEn~~}}		{{ActivationModuleFr}}

	=Account creation=		=Account creation=

Eldy: Created page with "{{TemplateDocUser}} {{TemplateModEN}} {{BasculeDevUser| nom=PayPal| num=TODO| devdoc=None| userdoc=This page|}} =Introduction= This module is to manage integration of '''Payp..."

2023-10-14T16:22:30Z

Created page with "{{TemplateDocUser}} {{TemplateModEN}} {{BasculeDevUser| nom=PayPal| num=TODO| devdoc=None| userdoc=This page|}} =Introduction= This module is to manage integration of '''Payp..."

New page

{{TemplateDocUser}}
{{TemplateModEN}}
{{BasculeDevUser|
nom=PayPal|
num=TODO|
devdoc=None|
userdoc=This page|}}

=Introduction=
This module is to manage integration of '''Paypal business accounts''' to Dolibarr so that your customers can '''autonomously pay online''': '''invoices''', '''memberships''', or '''donations'''.

Note that PayPal allows you customers to pay online by credit card even if they do not owe a PayPal account.

<br />

=Installation=
{{NoInstallModuleEn}}

=Configuration=
{{ActivationModuleEn}}

=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, ...).

=Setup PayPal NVP/SOAP API (legacy version) for 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.

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)'''.

3. Request an API access, and more precisely an '''API signature''' as on the screenshot:

[[File:Demander des identifiants API.png|French UI for the request of API access|alt=|center|frame]]

4. You must obtain 3 fields for the '''API username''', '''API password''' and '''signature''':

[[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 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.

5.a. Open the configuration of the PayPal module in Dolibarr and:

*Check the '''PayPal Live checkbox''', since the sandbox seem to generate errors
*Copy/paste the username, password and signature. Make sure that you copy/paste no trailing space characters
*Enable '''TLS v1.2'''

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=
==SetExpressCheckout failed: Security error code 10002==
[[File:Security Error 10002.png|thumb|French Dolibarr error message for a PayPal security error code 10002 ]]

Make sure that:

*You enabled TLS 1.2 in the Dolibarr module configuration
*You enabled the Live environment, since the sandbox environment often returns that error