Ce plugin fournit :
- un formulaire de paiement,
- un historique des paiements,
- la création automatique de contributions dans Galette une fois les paiements validés.

Note — Ce plugin nécessite que votre instance de Galette soit accessible publiquement et servie avec un certificat SSL valide.
Installation
Tout d’abord, téléchargez le plugin :
Décompressez l’archive téléchargée dans le répertoire plugins de Galette. Par
exemple, sous Linux (en remplaçant {url} et {version} par les valeurs
correspondantes) :
$ cd /var/www/html/galette/plugins
$ wget {url}
$ tar xjvf galette-plugin-stripe-{version}.tar.bz2
Initialisation de la base de données
Pour fonctionner, ce plugin requiert des tables dans la base de données. Référez-vous à l’interface de gestion des plugins de Galette.
Et c’est tout ; le plugin Stripe est installé. :)
Utilisation du plugin
Une fois le plugin installé, un groupe Stipe est ajouté au menu de Galette lorsqu’un utilisateur est connecté, permettant aux administrateurs et membres du bureau de définir les préférences du plugin et de consulter l’historique des paiements.

Le formulaire de paiement est accessible depuis les pages publiques de Galette.
Seuls les utilisateurs connectés peuvent payer des contributions avec extension d’adhésion (ou cotisations).

Les visiteurs (utilisateurs non connectés à leur compte) ne peuvent payer que des contributions sans extension d’adhésion (ou dons). Dans ce cas, aucune contribution n’est créée automatiquement dans Galette, le paiement apparaît uniquement dans l’historique des paiements du plugin avec la valeur “Aucun” dans la colonne “Adhérent”.

Préférences

- URL du point de terminaison du webhook Stripe : URL à utiliser pour créer un « Webhook » dans le compte de votre association sur Stripe (lire plus bas).
- Évènement webhook Stripe : nom de l’évènement à utiliser pour créer un « Webhook » sur le compte Stripe de votre association (lire plus bas).
- Clé publique Stripe : vous trouverez cette information dans le compte Stripe de votre association (lire plus bas).
- Clé secrète Stripe : vous trouverez cette information dans le compte Stripe de votre association (lire plus bas).
- Clé secrète du webhook Stripe : vous trouverez cette informations dans les détails du « Webhook » que vous devez créer depuis le compte de votre association sur Stripe (lire plus bas).
- Pays de votre compte Stripe : choisissez un pays selon les paramètres de votre compte Stripe (lire plus bas).
- Devise du paiement : choisissez une devise selon les paramètres de votre compte Stripe (lire plus bas).
-
Types de contribution : dans ce tableau, vous pouvez désactiver les types de contribution configurés dans Galette que vous ne souhaitez pas voir proposés comme motif de paiement sur le formulaire de paiement.
Les types de contribution dont le montant est nul, ou dont le montant n’est pas configuré, ne seront pas proposés comme motifs de paiement sur le formulaire, même si ceux-ci ne sont pas marqués comme inactifs dans le tableau.
Note — Une description, affichée sous chaque motif de paiement proposé sur le formulaire de paiement, peut être définie dans la configuration des types de contributions de Galette.
Note — Il est possible de décider qui peut accéder au formulaire de paiement dans les préférences de Galette. Choisissez l’option souhaitée dans les paramètres de visibilité des pages publiques.
Note sur le mode bac à sable

Il est recommandé de tester les fonctionnalités du plugin en mode bac à sable. Pour savoir comment mettre en place un tel environnement de test, veuillez vous référer à la documentation de Stripe.
Avertissement — Dans ce mode, n’utilisez jamais de véritables numéros de cartes bancaire, mais uniquement des cartes fictives (voir la liste de cartes fictives dans la documentation de Stripe)
Configurez votre compte Stripe
Pour savoir comment créer un compte, veuillez vous référer à la [documentation Stripe] (https://docs.stripe.com/get-started/account).
Obtenez le pays et la devise définis dans les paramètres de votre compte
Le choix d’un pays et d’une devise est généralement demandé lors de la création de votre compte. Vous pouvez trouver ces informations dans les paramètres de votre compte :

- Paramètres > Entreprise > Informations du compte

- Paramètres > Entreprise > Comptes bancaires et devises

Créer un Webhook et obtenir la clé secrète correspondante
Le Webhook requis pour le bon fonctionnement du plugin peut être créé à partir du menu Développeurs (situé en bas à gauche de votre tableau de bord) :

L’URL du point de terminaison à définir dans votre webhook est indiquée dans
les préférences du plugin (exemple :
https://YOUR_DOMAIN_NAME/plugins/stripe/webhook).
Un seul Évènement doit être défini dans votre webhook. Il est également
indiqué dans les préférences du plugin ; c’est payment_intent.succeed.

Une fois créé, vous devez obtenir la clé secrète du webhook pour la définir dans les paramètres du plugin. Dans la liste des webhooks, cliquez sur celui que vous avez créé :

La clé secrète du webhook peut être copiée depuis ses détails :

Obtenir les clés d’API
Les Clés d’API requises pour le bon fonctionnement du plugin peuvent être créées à partir du menu Développeurs (situé en bas à gauche de votre tableau de bord) :

Note — Pour réduire l’impact potentiel d’une compromission, créez une clé restreinte. Cette clé peut être créée sans personnaliser les permissions. Veuillez consulter la documentation Stripe pour plus d’informations sur les clés restreintes.

Activer les moyens de paiement nécessaires
Stripe offre de nombreux moyens de paiement. Dans les paramètres de votre compte, vous devez activer uniquement les moyens que vous souhaitez utiliser.
- Paramètres > Paiements > Moyens de paiement
