{{tag>Logiciel}}

====== Dolibarr : module Stripe ======

Ce module permet
  * de lier vos tiers Dolibarr à des clients Stripe.
  * d'afficher la liste des moyens de paiement stockés dans Stripe dans Dolibarr.
  * d'afficher la listes des paiements et payouts Stripe dans Dolibarr.
  * de payer, en utilisant l'Authentification Forte SCA (Strong Costomer Authantication https://stripe.com/docs/strong-customer-authentication), des commandes, factures ou lignes de Contrat/Abonnements en ligne, via Stripe. Voir les notes en bas de page pour savoir comment activer l'authentification forte.

===== Pré-requis =====

===== Installation =====

Livré en standard avec la distribution de Dolibarr, ce module est déjà installé.

===== Configuration =====

<WRAP list-deep>
  - **Activez ce module** :
    - connectez-vous avec un compte administrateur
    - allez sur la page **<key>Accueil</key> -> Configuration -> Modules/Applications**
    - Dans l'onglet **Modules/applications installés**, paragraphe **Interfaces avec des systèmes externes**, Activez le module **Stripe** (coulisseau)
  - Paramétrez le module en cliquant sur l'engrenage ou le pictogramme :\\ __Les valeurs des clés privéEs et secrètes pour le mode test et le mode live, fournies par Stripe (à obtenir sur https://www.stripe.com) sont obligatoires.__
    - **Mode live activé (sinon mode test/bac a sable)**
    - **__Clé publique de test__**
    - **__Clé secrète de test__**
    - **Clé test des Webhooks**
    - **__Clé publique live__**
    - **__Clé secrète live__**
    - **Clé live des Webhooks**
    - **Nom publique du vendeur**
    - **Compte d'utilisateur à utiliser pour certains e-mails de notification d'événements Stripe (Stripe payouts)**
    - **Compte bancaire**
    - **URL feuille style css pour le formulaire de paiement**
    - **Message sur l'écran de paiement en ligne**
    - **Message sur la page de retour d'un paiement validé**
    - **Message sur la page de retour d'un paiement annulé**
    - **Email à prévenir en cas de paiement (succès ou non)**
    - **Clé de sécurisation des URLs**
    - **Utiliser un paramètre securekey unique pour chaque URL ?**
</WRAP>

===== Utilisation =====

Une fois les identifiants obligatoireS saisis, Dolibarr fournit des liens URL pour réaliser les paiements en ligne.

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.

Voici un exemple de la page de paiement en ligne qui peut être diffusé aux clients pour leur permettre de vous payer via votre compte Stripe :{{ https://wiki.dolibarr.org/images/3/39/Public_interface_for_payment_with_Stripe.png }}

==== Variantes ====

Stripe propose 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 3D Secure 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 <key>accueil</key> -> **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 <key>accueil</key> -> **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.

Si vous utilisez Dolibarr v11 ou supérieur, le mode par défaut est STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION = 1 sans besoin de changer ou éditer aucune variable de configuration. aussi, si vous voulez utiliser un autre mode dans ces versions, vous devez forcer cette constante à 0. 

===== Désinstallation =====

===== Voir aussi =====

  * **(fr)** [[https://stripe.com/fr]]

----
//Basé sur << [[https://wiki.dolibarr.org/index.php?title=Module_Stripe_FR|Module Stripe FR]] >> par Doc Dolibarr.//