Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

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

  1. Activez ce module :
    1. connectez-vous avec un compte administrateur
    2. allez sur la page Accueil → Configuration → Modules/Applications
    3. Dans l'onglet Modules/applications installés, paragraphe Interfaces avec des systèmes externes, Activez le module Stripe (coulisseau)
  2. 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.
    1. Mode live activé (sinon mode test/bac a sable)
    2. Clé publique de test
    3. Clé secrète de test
    4. Clé test des Webhooks
    5. Clé publique live
    6. Clé secrète live
    7. Clé live des Webhooks
    8. Nom publique du vendeur
    9. Compte d'utilisateur à utiliser pour certains e-mails de notification d'événements Stripe (Stripe payouts)
    10. Compte bancaire
    11. URL feuille style css pour le formulaire de paiement
    12. Message sur l'écran de paiement en ligne
    13. Message sur la page de retour d'un paiement validé
    14. Message sur la page de retour d'un paiement annulé
    15. Email à prévenir en cas de paiement (succès ou non)
    16. Clé de sécurisation des URLs
    17. Utiliser un paramètre securekey unique pour chaque URL ?

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 :

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 :

  1. En allant dans Accueilconfiguration → 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.
  2. En allant dans Accueilconfiguration → 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


Basé sur « Module Stripe FR » par Doc Dolibarr.

QR Code
QR Code Dolibarr : module Stripe (generated for current page)