View source for Module Stripe Payment Links

== 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.

{| class="wikitable"
|-
! É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 || [https://www.dolistore.com/product.php?id=3208 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 <code>__STRIPEPAYMENTLINK__</code>.
* '''Webhook sécurisé''' (vérification de la signature HMAC-SHA256 de Stripe) : à réception de l'événement <code>checkout.session.completed</code>, 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 <code>module_stripepaymentlinks-x.y.z.zip</code> 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 <code>sk_test_…</code> pour les essais, et <code>sk_live_…</code> 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 (<code>.../custom/stripepaymentlinks/webhook/stripe.php</code>), s'abonner à l'événement <code>checkout.session.completed</code>, puis coller le secret de signature <code>whsec_…</code> 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 <code>__STRIPEPAYMENTLINK__</code> 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 ==

{| class="wikitable"
|-
! 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 ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]