Module Stripe Payment Links
Stripe Payment Links est un module complémentaire pour Dolibarr ERP/CRM qui génère un lien de paiement Stripe (carte bancaire, Apple Pay, Google Pay) pour chaque facture client, et réconcilie automatiquement le règlement dans Dolibarr grâce au webhook Stripe. Le client paie en ligne, la facture passe à « payée » sans intervention.
| Éditeur |
arcchester
|
| Licence |
GPL v3
|
| Compatibilité Dolibarr |
18.0 à 24.x
|
| PHP |
7.4 minimum (extension cURL)
|
| Dépendances |
Aucune (cURL pur : pas de Composer, pas de SDK Stripe)
|
| Distribution |
Fiche sur le Dolistore
|
Fonctionnalités
- Bouton « Générer un lien de paiement Stripe » sur la fiche facture.
- Création de véritables Stripe Payment Links (chaîne Product → Price → Payment Link de l'API Stripe), et non de simples liens de checkout jetables.
- Statut visible sur la fiche facture : aucun lien / en attente de paiement / payé, avec la date de règlement.
- Copie du lien en un clic et insertion automatique dans les emails via le jeton de substitution
__STRIPEPAYMENTLINK__.
- Webhook sécurisé (vérification de la signature HMAC-SHA256 de Stripe) : à réception de l'événement
checkout.session.completed, le paiement est créé dans Dolibarr et la facture est marquée payée.
- Rapprochement bancaire optionnel : le règlement peut être affecté au compte bancaire de votre choix.
- Modes test et live séparés, bascule par la configuration.
- Interface et documentation en français et en anglais.
Prérequis
- Un compte Stripe (l'ouverture est gratuite ; Stripe prélève sa commission sur les transactions).
- Une URL de webhook accessible en HTTPS depuis Internet pour la réconciliation automatique. Sans elle, le lien de paiement fonctionne mais le règlement doit être saisi à la main dans Dolibarr.
Installation
- Télécharger le zip
module_stripepaymentlinks-x.y.z.zip depuis le Dolistore.
- Dans Dolibarr : Accueil → Configuration → Modules/Applications → Déployer/installer un module externe et sélectionner le zip.
- Activer Stripe Payment Links dans la liste des modules (famille « Finance / Facturation »).
- Aucune dépendance à installer sur le serveur.
Configuration
Menu Configuration → Modules → Stripe Payment Links :
- Clés API : coller la clé secrète
sk_test_… pour les essais, et sk_live_… pour la production (Stripe → Développeurs → Clés API).
- Webhook : dans Stripe → Développeurs → Webhooks, créer un endpoint pointant vers l'URL affichée par la page de configuration du module (
.../custom/stripepaymentlinks/webhook/stripe.php), s'abonner à l'événement checkout.session.completed, puis coller le secret de signature whsec_… dans le module.
- Utilisateur auteur des paiements : l'utilisateur Dolibarr au nom duquel les règlements automatiques sont enregistrés.
- Compte bancaire de rapprochement (facultatif).
- Mode : test ou live.
Utilisation
- Ouvrir une facture validée.
- Cliquer sur « Générer un lien de paiement Stripe ».
- Transmettre le lien au client — manuellement, ou en insérant
__STRIPEPAYMENTLINK__ dans le modèle d'email d'envoi de facture.
- À réception du paiement, Stripe appelle le webhook : le règlement est créé et la facture passe à « payée ». Le badge de la fiche facture affiche l'état et la date.
Historique des versions
| Version |
Apports principaux
|
| 1.0.1 |
Corrections de robustesse du webhook et du rapprochement bancaire
|
| 1.0.0 |
Version initiale : génération du lien de paiement, badge d'état, webhook signé, jeton d'email, modes test/live
|
Support