Galette

Ce plugin fournit :

Formulaire de paiement visible par les utilisateurs *non connectés* à leur
compte

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.

Menu du plugin

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

Formulaire de paiement visible par les utilisateurs
connectés

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

Écran de l'historique des paiements

Préférences

Écran des préférences

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

Mode bac à sable Stripe

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 :

Menu des paramètres de Stripe

Pays défini dans les paramètres du compte

Devise définie dans les paramètres du
compte

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) :

Webhooks dans le meu développeurs

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.

Webhook créé dans le compte Stripe

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éé :

Liste des Webhooks dans le compte Stripe

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

Secret Webhook

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) :

Clés d'API dans le menu
développeurs

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.

Clés d'API créés dans le compte Stripe

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.

Les moyens de paiement définis dans les paramètres du
compte