Difference between revisions of "Module Stripe"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
m
Tag: 2017 source edit
Tag: 2017 source edit
Line 25: Line 25:
 
= Introduction =
 
= Introduction =
  
Ce module permet
+
This module allows
* de lier vos tiers Dolibarr à des clients Stripe
+
* to bind your Dolibarr third parties to Stripe customers
* d'afficher la liste des moyens de paiement stockés dans Stripe dans Dolibarr
+
* to display the list of the means of payment stored in Stripe in Dolibarr
* de payer des commandes, factures ou lignes de Contrat/Abonnements en ligne en utilisant Stripe
+
* to pay for orders, invoices or lines of Contract / Subscriptions online using Stripe
  
 
= Installation =
 
= Installation =
{{NoInstallModuleFr}}
+
{{NoInstallModuleEn}}
  
 
= Configuration =
 
= Configuration =
{{ActivationModuleFr}}
+
{{ActivationModuleEn}}
  
Après avoir cliquer sur le pictogramme de configuration, vous accéder à une page pour saisir différentes informations. Les informations obligatoires sont les identifiants des votre compte Stripe (à créer sur stripe.com).
+
After clicking on the configuration icon, you will access a page to enter different information. The required information is the login of your Stripe account (to be created on stripe.com).
Les valeurs des clés privés et secrètes pour le mode test et le mode live fournies par Stripe sont obligatoires.
+
Private and secret key values for test mode and live mode provided by Stripe are required.
  
 
<div class="divforimgcentpercent">
 
<div class="divforimgcentpercent">
Line 43: Line 43:
 
</div>
 
</div>
  
= Utilisation =
+
= Usage =
Une fois les identifiants obligatoire saisies, vous bénéficiez de liens URL, fournies par Dolibarr, pour réaliser les paiements en ligne.
+
Once the mandatory identifiers are entered, you benefit from URL links, provided by Dolibarr, to make online payments.
Ces liens sont rappelés de manière générique sur la page de configuration du module Stripe. Mais vous les trouverez de manière complète sur la page de chaque facture, chaque commande, chaque contrat, ou chaque adhérent pour le paiement des adhésions.
+
These links are generically recalled on the Stripe configuration page. But you will find them completely on the page of each invoice, each order, each contract, or each member for the payment of memberships.
  
 +
= Variants =
 +
Stripe offers several modes of operation. The current default mode is the use of Stripe's "load" APIs. As of September 2019, these APIs are deprecated to implement the SCA on online payments and SecureID v2 (https://stripe.com/docs/strong-customer-authentication).
 +
The v10 is ready for this change. Dolibarr v10 offers 2 other modes of operation:
 +
* By going to home - configuration - various and adding the constant STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION to 1, Dolibarr will use the PaymentIntent Stripe APIs according to the workflow "Automatic Confirmation" (https://stripe.com/docs/payments/payment-intents/quickstart) , which is ready for the SCA.
 +
* By going into home - configuration - miscellaneous and adding the STRIPE_USE_NEW_CHECKOUT constant to 1, Dolibarr will use the CheckOut Stripe APIs according to the "Server Integration" workflow (https://stripe.com/docs/payments/checkout), which is also ready for the SCA.
  
 
+
At maturity, one of these two variants, already operational in v10, will become the default mode.
 
 
= Variantes =
 
Stripe proposent plusieurs mode de fonctionnement. Le mode actuel par défaut est l'utilisation des API "charge" de Stripe. A partir de septembre 2019, ces API sont dépréciés afin de mettre en oeuvre le SCA sur les paiements en ligne et le SecureID v2 (https://stripe.com/docs/strong-customer-authentication).
 
La v10 est prête pour ce changement. Dolibarr v10 propose 2 autres modes de fonctionnements:
 
* En allant dans accueil - configuration - divers et en ajoutant la constante STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION à 1, Dolibarr utilisera les API Stripe PaymentIntent selon le workflow "Automatic Confirmation" (https://stripe.com/docs/payments/payment-intents/quickstart), lequel est prêt pour le SCA.
 
* En allant dans accueil - configuration - divers et en ajoutant la constante STRIPE_USE_NEW_CHECKOUT à 1, Dolibarr utilisera les API Stripe de CheckOut selon le workflow "Server Integration" (https://stripe.com/docs/payments/checkout), lequel est également prêt pour le SCA.
 
 
 
A l'échéance, une de ces 2 variantes, déjà opérationelle en v10, deviendra le mode par défaut.
 

Revision as of 10:39, 29 July 2019

Stripe
Numéro/ID du module 50300
Doc utilisateur du module This page
Doc développeur du module





Introduction

This module allows

  • to bind your Dolibarr third parties to Stripe customers
  • to display the list of the means of payment stored in Stripe in Dolibarr
  • to pay for orders, invoices or lines of Contract / Subscriptions online using Stripe

Installation

This module is included with the Dolibarr distribution, so there is no need to install it.

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears Cog circle.svg on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

After clicking on the configuration icon, you will access a page to enter different information. The required information is the login of your Stripe account (to be created on stripe.com). Private and secret key values for test mode and live mode provided by Stripe are required.

Doc setup stripe 1.png

Usage

Once the mandatory identifiers are entered, you benefit from URL links, provided by Dolibarr, to make online payments. These links are generically recalled on the Stripe configuration page. But you will find them completely on the page of each invoice, each order, each contract, or each member for the payment of memberships.

Variants

Stripe offers several modes of operation. The current default mode is the use of Stripe's "load" APIs. As of September 2019, these APIs are deprecated to implement the SCA on online payments and SecureID v2 (https://stripe.com/docs/strong-customer-authentication). The v10 is ready for this change. Dolibarr v10 offers 2 other modes of operation:

  • By going to home - configuration - various and adding the constant STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION to 1, Dolibarr will use the PaymentIntent Stripe APIs according to the workflow "Automatic Confirmation" (https://stripe.com/docs/payments/payment-intents/quickstart) , which is ready for the SCA.
  • By going into home - configuration - miscellaneous and adding the STRIPE_USE_NEW_CHECKOUT constant to 1, Dolibarr will use the CheckOut Stripe APIs according to the "Server Integration" workflow (https://stripe.com/docs/payments/checkout), which is also ready for the SCA.

At maturity, one of these two variants, already operational in v10, will become the default mode.