Eldy at 16:55, 14 October 2023

2023-10-14T16:55:50Z

← Older revision		Revision as of 16:55, 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 -->
			[[fr:Module_PayPal_FR]]
			<!-- END interlang links -->

	{{TemplateDocUser}}		{{TemplateDocUser}}
	{{TemplateModEN}}		{{TemplateModEN}}

Eldy at 16:29, 14 October 2023

2023-10-14T16:29:20Z

← Older revision		Revision as of 16:29, 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=This page\|}}

Eldy: Eldy moved page Module PayPal En to Module PayPal

2022-12-22T14:41:16Z

Eldy moved page Module PayPal En to Module PayPal

← Older revision

Revision as of 14:41, 22 December 2022

Yoan: Creation of the wiki for the PayPal module

2022-12-17T20:05:59Z

Creation of the wiki for the PayPal module

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

Module PayPal - Revision history

Eldy at 16:55, 14 October 2023

Eldy at 16:29, 14 October 2023

Eldy: Eldy moved page Module PayPal En to Module PayPal

Yoan: Creation of the wiki for the PayPal module