Module PayPal FR

Revision as of 16:24, 14 October 2023 by Eldy (talk | contribs)

Template:BasculeDevUtil

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

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 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:

 
French UI for the request of API access

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

 
French UI for the API username, password and signature.

IMPORTANT: 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 REST API that would give you an account, Client ID and Secret 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

 
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