1. Prérequis
Dolibarr 18 à 24 avec PHP 7.4 à 8.3 et l’extension cURL. Un compte Stripe avec accès aux clés API. Un serveur Dolibarr joignable en HTTPS depuis internet, car Stripe appelle le webhook. Travaillez d’abord sur une copie de votre base.
Stripe Payment Links · Dolibarr 18 → 24Stripe Payment Links
Stripe Payment Links
Guide d’installation Dolibarr
Prérequis, installation dans custom/, configuration, premier test et mise à jour. Commencez sur une copie de votre base.
2. Installer le module
Téléchargez l’archive depuis Dolistore et décompressez-la dans le répertoire custom/ de Dolibarr (custom/stripepaymentlinks). Dans Accueil → Configuration → Modules, activez Stripe Payment Links. Aucun paquet Composer ni bibliothèque externe n’est nécessaire.
3. Saisir les clés Stripe
Dans la configuration du module, collez la clé secrète du mode test, puis plus tard la clé réelle. Les clés sont masquées et stockées séparément. Choisissez l’utilisateur Dolibarr qui portera les règlements et, si vous le souhaitez, le compte bancaire du rapprochement.
4. Créer le webhook dans Stripe
Copiez l’URL de webhook affichée dans la configuration. Dans le tableau de bord Stripe, créez un point de terminaison pour l’événement checkout.session.completed avec cette URL, puis collez le secret de signature dans le module. Enregistrez.
5. Faire un paiement de test
Ouvrez une facture validée, cliquez sur « Générer un lien de paiement Stripe », ouvrez le lien et payez avec la carte de test Stripe 4242 4242 4242 4242. De retour dans Dolibarr, l’encart doit afficher le règlement et la facture doit être payée.
6. Vérifier le diagnostic
La page « À propos » du module exécute douze contrôles (cURL, HMAC, table, clé active, webhook, utilisateur, banque). Chaque ligne doit être verte avant de passer en mode réel.
7. Passer en réel et mettre à jour
Basculez le sélecteur en mode réel et créez le webhook réel de la même façon. Pour mettre à jour, remplacez le répertoire custom/stripepaymentlinks par la nouvelle version, puis désactivez et réactivez le module.