Plugin d'abonnements Discourse

[Discourse]

	Résumé	Le plugin Discourse Subscriptions permet aux propriétaires de sites de vendre des abonnements récurrents et des achats uniques qui donnent accès à un groupe sur une instance Discourse.
	Guide d’installation	Ce plugin est intégré au noyau de Discourse. Il n’est pas nécessaire d’installer le plugin séparément.

Comme il s’agit d’un plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, de bug, de ux et de #feature peuvent être faites dans les catégories respectives ici sur Meta, et marquées avec l’étiquette de plugin appropriée. Cliquez sur un lien ci-dessous pour en créer un.

Support Bug UX Feature

Le plugin Discourse Subscriptions vous permet de créer des abonnements ponctuels et récurrents que les utilisateurs peuvent payer pour accéder à du contenu restreint. C’est un excellent moyen de financer les coûts d’hébergement de votre communauté.

Fonctionnalités

Le plugin Discourse Subscriptions prend en charge les fonctionnalités suivantes :

• Créer de nouveaux produits et plans depuis le panneau d’administration
• Annuler et rembourser les abonnements depuis le panneau d’administration
• Créer des plans d’achat unique ou d’abonnement récurrent
• Ajouter des périodes d’essai gratuites aux abonnements récurrents
• Prise en charge de SCA/3D Secure
• Ajouter/supprimer des utilisateurs des groupes de plans lors de la souscription/annulation
• Annuler l’abonnement depuis le profil utilisateur
• Annulation de l’abonnement à la fin de la période d’abonnement
• Support optionnel pour Stripe Checkout
• Calcul et collecte automatiques de la taxe de vente
• Les utilisateurs peuvent mettre à jour leur carte pour des abonnements individuels

Le bouton « S’abonner » situé dans la navigation supérieure vous mènera à la page d’abonnement /s où sont listés les abonnements que vous avez configurés pour votre site :

Une fois qu’un utilisateur clique sur le bouton « S’abonner » pour un plan spécifique, la page de paiement pour ce plan s’ouvre :

Après qu’un utilisateur a rempli ses informations de paiement et son adresse et cliqué sur « S’abonner », il voit un message « Merci ! » et est redirigé vers sa page de facturation :

L’utilisateur est également automatiquement ajouté à un groupe de votre choix, afin que vous puissiez facilement voir quels utilisateurs se sont abonnés et fournir du contenu restreint dans des catégories visibles uniquement par ce groupe.

Termes

• Abonnement - Les abonnements sont un plan de paiement récurrent qui vous permet de contrôler l’accès au contenu de votre communauté. Lorsqu’un abonnement est créé ou supprimé, un utilisateur est ajouté ou retiré du groupe d’utilisateurs que vous associez à votre plan d’abonnement. Un abonnement est composé d’un produit et de plans.
• Produit - Un produit, selon les termes de Stripe, est ce que vous vendez. Un produit peut contenir un ou plusieurs plans.
  • Pour ajouter une description à votre produit, ajoutez un champ de métadonnées nommé « description » et utilisez celui-ci. Vous pouvez utiliser le Markdown.
• Plan - Un plan contient un prix, un cycle de récurrence et est associé à un groupe auquel vos abonnés accèdent.

Soyez très prudent et gardez vos clés privées Stripe en sécurité en tout temps.

Si vous arrêtez votre instance Discourse, désinstallez ce plugin ou si votre site devient hors ligne, Stripe continuera de facturer vos clients pour votre service jusqu’à ce que l’abonnement soit annulé.

Configuration

1. Installez et activez le plugin
2. Configurez la passerelle de paiement (Stripe)
3. Configurez les Webhooks et Événements dans Stripe
4. Ajoutez vos clés Stripe (publique, secrète, secret du webhook) sous Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Créez un groupe pour vos abonnés via l’achat
6. Créez un produit et un plan sous Admin > Plugins > Subscriptions
7. Encaissez !

Configurez votre passerelle de paiement.

Tout d’abord, vous aurez besoin d’un compte auprès de la passerelle de paiement Stripe. Pour commencer, vous pouvez configurer un compte en mode test et voir comment tout fonctionne sans effectuer de transactions réelles ou sans avoir à configurer un compte bancaire. Il n’y a pas de bouton de bascule pour le mode test dans le plugin ; assurez-vous plutôt d’utiliser vos clés développeur (elles commencent par pk_test, sk_test)

Configurez les Webhooks et Événements dans votre compte Stripe

Les Webhooks sont nécessaires pour que les annulations d’abonnement fonctionnent pleinement. Assurez-vous qu’ils sont correctement configurés.

Une fois que vous avez un compte sur Stripe, vous devrez indiquer à Stripe l’adresse de votre site web afin qu’il puisse vous notifier de certaines transactions. Vous pouvez saisir ceci dans votre tableau de bord Stripe sous Endpoints > URL.

Adresse des Webhooks : [votre adresse serveur]/s/hooks – où [votre adresse serveur] est l’URL de votre installation Discourse.

Vous devrez également indiquer à Stripe quels événements il doit vous notifier via l’URL du webhook.

Actuellement, Discourse Subscriptions répond aux événements suivants :

• customer.subscription.deleted
• customer.subscription.updated
• checkout.session.completed

Ajoutez les clés API et Webhook Stripe à vos paramètres de plugin

Stripe doit être autorisé à communiquer avec votre site web. Pour ce faire, il publie une paire de clés API privée et publique ainsi qu’un secret de signature pour vos webhooks.

Pour autoriser les webhooks, ajoutez les clés API et le secret du webhook de Stripe à votre page de paramètres (sous Developers).

L’ajout de clés de production rendra les paiements réels. Si vous prévoyez de tester, assurez-vous de passer en mode View test data et d’obtenir les clés pk_test et sk_test sous Developers.

Dans les paramètres de votre compte Stripe, consultez :

• https://dashboard.stripe.com/apikeys
• https://dashboard.stripe.com/webhooks

Ajoutez ces clés sous les paramètres appropriés dans Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Configurez vos groupes d’utilisateurs dans Discourse

Lorsqu’un utilisateur s’abonne avec succès à votre application Discourse, après que sa transaction par carte de crédit a été traitée, il est ajouté à un groupe d’utilisateurs. En assignant des utilisateurs à un groupe d’utilisateurs, vous pouvez gérer ce à quoi vos utilisateurs ont accès sur votre site web. Les groupes d’utilisateurs sont une fonctionnalité centrale de Discourse et ce plugin ne fait rien d’autre qu’ajouter et retirer des utilisateurs du groupe que vous avez associé à votre Plan.

Créez un ou plusieurs produits avec des plans.

Sous Admin > Plugins > Subscriptions, cliquez sur ajouter un nouveau Produit. Une fois que vous avez enregistré un produit, vous pouvez lui ajouter des plans. Gardez à l’esprit que les tarifs et les intervalles de facturation des plans ne peuvent pas être modifiés une fois créés. Cela évite toute confusion autour de la gestion des abonnements.

Si vous regardez votre Tableau de bord Stripe, vous verrez que tous ces produits et plans sont répertoriés. Discourse Subscriptions ne les crée pas localement. Ils sont créés dans Stripe.

Test

Testez avec ces numéros de carte de crédit :

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (aucune authentification requise)
• 4000 0027 6000 3184 (authentification requise)

Pour plus de numéros de cartes de test : Test card numbers | Stripe Documentation

Visitez /s et effectuez quelques transactions de test.

Mise en production

Une fois que vous êtes prêt à passer en production, changez vos clés API et votre secret de webhook pour des clés de production. Vous devrez créer de nouveaux produits et plans en mode live.

Soyez conscient que si vous ne configurez pas correctement les webhooks Stripe, et que les paiements récurrents échouent pour une raison quelconque (carte expirée, etc.), les utilisateurs auront toujours accès au groupe. Pour que Stripe annule automatiquement les abonnements, assurez-vous de configurer vos paramètres Gérer les paiements échoués comme dans l’image ci-dessous et de configurer les webhooks comme décrit ci-dessus.

Mise à jour des informations de paiement

Les utilisateurs peuvent mettre à jour leur carte utilisée pour des abonnements individuels en visitant la page de facturation et en cliquant sur le bouton modifier à côté de l’abonnement, ce qui ouvrira cet écran :

Stripe Checkout avec les tableaux de prix Stripe

Vous pouvez également choisir de remplacer les pages de produit et de paiement du plugin Subscription et d’utiliser à la place Stripe Checkout avec Stripe Pricing Tables.

Dans votre tableau de bord Stripe :

1. Après avoir créé les produits sur Discourse, allez dans Produits > Catalogue de produits
2. Cliquez sur le produit que vous souhaitez inclure dans le tableau de prix
3. Cliquez sur Modifier le produit
4. Plus d'options et saisissez ce qui suit sous Métadonnées :
   • Clé : group_name
   • Valeur : Le nom du groupe sur Discourse (par ex. trust_level_0)
5. Cliquez sur Mettre à jour le produit pour enregistrer

Assurez-vous que le nom du groupe correspond au groupe sélectionné sous User_Groups sur Discourse

Créez votre tableau de prix Stripe

1. Allez dans Produits > Tableaux de prix
2. Créez un nouveau tableau et ajoutez les produits que vous venez de créer
3. Après avoir publié le tableau, copiez l’ID du tableau de prix trouvé dans le code d’intégration (il commence par prctbl_...)
4. Collez l’ID du tableau de prix dans votre discourse_subscriptions_pricing_table_id et activez le paramètre du tableau de prix des abonnements.
5. Cliquez sur les coches vertes pour enregistrer les deux paramètres.

Étape recommandée :

Lors de la configuration du tableau de prix dans Stripe, il est recommandé de rediriger l’utilisateur vers votre site une fois le paiement terminé, sinon ils resteront sur la page de confirmation de Stripe sans lien vers votre site.

Rediriger vers https://<votre-site>/my/billing/subscriptions est un bon choix pour les abonnements. Pour les paiements ponctuels, vous pourriez lier directement vers https://<votre-site>/my/billing/payments.

Collecte automatique de la taxe

Pour activer la collecte automatique de la taxe, cochez la case du paramètre de site discourse_subscriptions_enable_automatic_tax.

Si vous l’activez, mais que vous n’avez pas correctement configuré votre instance Stripe pour collecter la taxe, les utilisateurs peuvent voir cette pop-up après avoir terminé le processus de paiement :

Il y a ce guide pour plus d’informations, mais il ne devrait pas y avoir grand-chose à faire puisque le plugin transmet maintenant le paramètre approprié automatic_tax[enabled]=true (étape 5).

Assurez-vous de configurer vos enregistrements (étape 4) ainsi :

Voici un exemple de transaction du plugin Discourse Subscription dans Stripe montrant que la taxe a été collectée automatiquement :

Paramètres

Nom	Description
discourse subscriptions enabled	Activer le plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Afficher le bouton d’abonnement dans la navigation principale
discourse subscriptions public key	Clé Publiable Stripe
discourse subscriptions secret key	Clé Secrète Stripe
discourse subscriptions webhook secret	Secret du Webhook Stripe
discourse subscriptions currency	Code de devise par défaut. Cela peut être remplacé lors de la création d’un plan d’abonnement.
discourse subscriptions campaign enabled	Active une bannière de campagne pour promouvoir le soutien financier à cette communauté.
discourse subscriptions campaign goal	L’objectif numérique pour votre campagne de soutien (abonnés ou montant collecté).
discourse subscriptions campaign type	Sélectionne le type de campagne à lancer (abonnés ou montant mensuel collecté).
discourse subscriptions campaign banner location	Sélectionne l’emplacement de la bannière de campagne (haut ou barre latérale).
discourse subscriptions campaign banner bg image	Téléchargez une image personnalisée à utiliser comme arrière-plan de la bannière de campagne.
discourse subscriptions campaign banner shadow color	Sélectionnez la couleur de l’ombre portée de la bannière de campagne.
discourse subscriptions campaign show contributors	Afficher les avatars des achats les plus récents de produits d’abonnement.
discourse subscriptions campaign product	L’ID du produit Stripe à envoyer aux supporters lorsqu’ils cliquent sur le bouton de la campagne. Si ce paramètre est vide, les supporters seront redirigés vers la page principale des produits.
discourse subscriptions campaign grant	Accorde à l’utilisateur un mois gratuit d’abonnements
discourse subscriptions pricing table id	L’ID du tableau de prix Stripe issu du code d’intégration
discourse subscriptions pricing table enabled	Active l’utilisation du tableau de prix Stripe et remplace la page d’abonnement existante
discourse_subscriptions_enable_automatic_tax	Active ou désactive la collecte de la taxe de vente. Nécessite une configuration dans Stripe.
discourse_subscriptions_enable_verbose_logging	Active une journalisation plus verbeuse pour aider au débogage. Veuillez ne pas laisser activé en permanence en production.

Hébergé par nous ? Ce plugin est disponible sur nos plans d’hébergement Pro, Business et Enterprise Subscriptions | Discourse - Civilized Discussion