Plugin per le sottoscrizioni Discourse

[Discourse]

	Summary	The Discourse Subscriptions plugin allows site owners to sell recurring and one-time purchase subscriptions that grant access to a group on a Discourse instance.
	Install Guide	This plugin is bundled with Discourse core. There is no need to install the plugin separately.

As this is an official plugin maintained by the Discourse team, Support, Bug, UX, and Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

Support Bug UX Feature

The Discourse Subscriptions plugin allows you to create one-time as well as recurring subscriptions that users can pay for in order to access gated content. This can be a great way to fund the hosting cost of your community.

Features

The Discourse Subscriptions plugin supports the following features:

• Create new products and plans from the admin panel
• Cancel and refund subscriptions from the admin panel
• Create one time purchase or recurring subscription plans
• Add free trials on recurring subscriptions
• SCA/3D Secure support
• Add/remove users from plan groups as they subscribe/cancel
• Cancel subscription from user profile
• Cancellation of subscription at end of subscription period
• Optional Support for Stripe Checkout
• Automatic sales tax calculation and collection
• Users can update their card for individual subscriptions

The “Subscribe” button located in the top nav will take you to the Subscribe page /s where it lists the subscriptions you have configured for your site:

Once a user clicks on one of the “Subscribe” button for a specific plan it will open up the payment page for that plan:

After a user fills out their payment details and their address and click “Subscribe”, they are shown a “Thank you!” message and taken to their billing page:

The user is also automatically added to a group of your choosing so that you can easily see which users have subscribed as well as provide gated content in categories only that group can see.

Terms

• Subscription - Subscriptions are a recurring payment plan which allow you to control access to content on your community. When a subscription is created or deleted, a user is added or removed from the user group you associate with your subscription plan. A subscription is made up of a product and plans.
• Product - A product in Stripe’s terms is what you’re selling. A product can contain one or more plans.
  • To add a description to your product, add a metadata field named “description” and use that one instead. You can use Markdown.
• Plan - A plan contains a price, recurring cycle, and associates with a group to which your subscribers gain access.

Be very careful to keep your Stripe private keys safe and secure at all times.

If you were to shut down your instance of Discourse, uninstall this plugin or your site were to go offline, Stripe will continue to bill your customers for your service until the subscription is cancelled.

Configuration

1. Install & enable the plugin
2. Configure Payment Gateway (Stripe)
3. Configure Webhooks & Events in Stripe
4. Add your Stripe keys (public, secret, webhook secret) under Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Create a group for your subscribers to join via purchase
6. Create a product and plan under Admin > Plugins > Subscriptions
7. Profit!

Set up your Payment Gateway.

Firstly, you’ll need an account with the Stripe payment gateway. To get started, you can set up an account in test mode and see how it all works without making any real transactions or having to set up a bank account. There is no test mode toggle in the plugin; instead, be sure to use your developer keys (they begin with pk_test, sk_test)

Set up Webhooks and Events in your Stripe account

Webhooks are required to make subscription cancellations work fully. Be sure you have them configured correctly.

Once you have an account on Stripe, you’ll need to tell Stripe your website’s address so it can notify you about certain transactions. You can enter this in your Stripe dashboard under Endpoints > URL.

Webhooks address: [your server address]/s/hooks – where [your server address] is the URL of your Discourse install.

You’ll also need to tell Stripe which events it should notify you about via the webhook URL.

Currently, Discourse Subscriptions responds to the following events:

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

Add the Stripe API and Webhook keys to your plugin settings

Stripe needs to be authorized to communicate with your website. To do this, it publishes a pair of private and public API keys and a signing secret for your web hooks.

To authorize webhooks, add the API keys and webhook secret from Stripe to your settings page (under Developers).

Adding production keys will make live payments. If you plan to test, be sure to switch to View test data mode and get pk_test and sk_test keys under Developers.

In your Stripe account settings, see:

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

Add these keys under the appropriate settings in Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Set up your User Groups in Discourse

When a user successfully subscribes to your Discourse application, after their credit card transaction has been processed, they are added to a User Group. By assigning users to a User Group, you can manage what your users have access to on your website. User groups are a core functionality of Discourse and this plugin does nothing with them except add and remove users from the group you associated with your Plan.

Create one or more products with plans.

Under Admin > Plugins > Subscriptions, click add a new Product. Once you have a product saved, you can add plans to it. Keep in mind that the pricing and billing intervals of plans cannot be changed once you create them. This is to avoid confusion around subscription management.

If you take a look at your Stripe Dashboard, you’ll see all those products and plans are listed. Discourse Subscriptions does not create them locally. They are created in Stripe.

Testing

Test with these credit card numbers:

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (no authentication required)
• 4000 0027 6000 3184 (authentication required)

For more test card numbers: Test card numbers | Stripe Documentation

Visit /s and enter a few test transactions.

Going Live

Once you’re ready to go live, change your API and webhook secret keys to production keys. You will need to create new products and plans in live mode.

Do be aware that if if you don’t properly configure Stripe webhooks, and recurring payments fail to process for any reason (expired credit card, etc.), users will still have access to the group . To have Stripe automatically cancel subscriptions, be sure to set your Manage failed payments settings similar to the below image and configure webhooks as described above.

Update Payment Info

Users can update their card used for individual subscriptions by visiting the billing page and clicking the edit button next to the subscription which will open up this screen:

Stripe Checkout with Stripe Pricing Tables

You can also opt to replace the Subscription Plugin product and checkout pages and instead use Stripe Checkout with Stripe Pricing Tables.

In your Stripe Dashboard:

1. After you’ve created the products on Discourse, Go to Products > Product catalog
2. Click on the product you’d like to include in the pricing table
3. Click Edit product
4. More Options and enter the following under Metadata:
   • Key: group_name
   • Value: The group’s name on Discourse (e.g., trust_level_0)
5. Click Update product to save

Make sure the group name matches the group that is selected under User_Groups on Discourse

Create your Stripe pricing table

1. Go to Products > Pricing tables
2. Create a new table and add the products you just created
3. After publishing the table, copy the pricing table ID found within the embed code (it starts with prctbl_...)
4. Paste the pricing table ID into your discourse_subscriptions_pricing_table_id and enable the subscriptions pricing table setting.
5. Click the green checkmarks to save both settings.

Recommended step:

When setting up the Pricing Table inside of Stripe it is recommended to link the user to your site after checkout is complete otherwise they will stay on a Stripe confirmation page without a link back to your site.

Redirecting to https://<your-site>/my/billing/subscriptions is a good choice for subscriptions. For one-off payments you could link directly to https://<your-site>/my/billing/payments.

Automatic Tax Collecting

To enable Automatic Tax Collecting check the Site Setting box for discourse_subscriptions_enable_automatic_tax.

If you enable it, but you have not configured your Stripe instance properly to collect tax users may see this popup after completing the checkout process:

There is this guide for more info, but there shouldn’t be much to do since the plugin is now passing in the appropriate automatic_tax[enabled]=true parameter (step 5).

Be sure you configure your registrations (step 4) as well:

Here is an example Discourse Subscription Plugin transaction in Stripe showing that tax was automatically collected:

Settings

Name	Description
discourse subscriptions enabled	Enable the Discourse Subscriptions plugin.
discourse subscriptions extra nav subscribe	Show the subscribe button in the primary navigation
discourse subscriptions public key	Stripe Publishable Key
discourse subscriptions secret key	Stripe Secret Key
discourse subscriptions webhook secret	Stripe Webhook Secret
discourse subscriptions currency	Default Currency Code. This can be overridden when creating a subscription plan.
discourse subscriptions campaign enabled	Enables a campaign banner to promote supporting this community financially.
discourse subscriptions campaign goal	The numerical goal for your support campaign (subscribers or amount raised).
discourse subscriptions campaign type	Selects the type of campaign to run (subscribers or monthly amount raised).
discourse subscriptions campaign banner location	Selects the location of the campaign banner (top or sidebar).
discourse subscriptions campaign banner bg image	Upload a custom image to use as the background on the campaign banner.
discourse subscriptions campaign banner shadow color	Selects the color of the campaign banner drop shadow.
discourse subscriptions campaign show contributors	Show avatars of the most recent purchases of subscription products.
discourse subscriptions campaign product	The Stripe product id to send supporters when they click the button on the campaign. If this setting is blank, supporters will be directed to the main products page.
discourse subscriptions campaign grant	Grants the user a free month of subscriptions
discourse subscriptions pricing table id	The Stripe pricing table id from the embed code
discourse subscriptions pricing table enabled	Enables using the Stripe pricing table and replaces the existing subscribe page
discourse_subscriptions_enable_automatic_tax	Toggles if sales tax is going to be collected. Requires some setup in Stripe.
discourse_subscriptions_enable_verbose_logging	Enables more verbose logging to aid in debugging. Please do not leave permanently enabled in production.

Hosted by us? This plugin is available on our Pro, Business, and Enterprise hosting plans Subscriptions | Discourse - Civilized Discussion

Last edited by @tobiaseigen 2025-07-16T21:50:25Z

Last checked by @MarkDoerr 2024-07-11T20:25:35Z

Check document

Perform check on document:

[tvavrda (Tomas Vavrda)]

L’impostazione di Sidebar sembra non fare nulla (ultima versione di Discourse aeb3d717dc, ultimo plugin cc43d32a).

[tvavrda (Tomas Vavrda)]

Ricevo anche questo messaggio di log:

Avviso di deprecazione: il nome dell'icona "donate" è stato aggiornato a "circle-dollar-to-slot". Si prega di utilizzare il nuovo nome nel codice. I vecchi nomi verranno rimossi nel Q2 2025. [deprecation id: discourse.fontawesome-6-upgrade] [info: https://meta.discourse.org/t/325349]

MODIFICA: Ho creato una PR per questo

FIX: FontAwesome 6 compatibility icon upgrade

[blake (Blake Erickson)]

Hmmm… localmente mi appare nella barra laterale quando la cambio.

Se lo hai nella barra laterale, aggiungiamo questa classe CSS, puoi ispezionare la tua pagina e cercare subscription-campain-sidebar

Ti rimane solo in alto?

[tvavrda (Tomas Vavrda)]

Capisco. Avevo la pagina Categoria come predefinita. Lì non viene visualizzato, ovviamente. Viene visualizzato nell’elenco Più recenti. Quindi funziona bene. Grazie!

[nathank (Nathan Kershaw)]

Dovrebbe davvero apparire sulla pagina delle categorie (o altre pagine predefinite), non credi?

[rui5man]

A causa delle restrizioni nella Cina continentale, è difficile per Stripe superare la revisione. Potresti considerare l’integrazione delle interfacce di Alipay o WeChat Pay?

[pfaffman (Jay Pfaffman)]

Domande simili in passato hanno avuto una risposta come “la cosa da fare sarebbe creare un plugin per Alipay o WeChat Pay”. discourse.org guadagna da coloro che pagano per l’hosting e non credo che abbiano molti clienti Enterprise che desiderano Alipay o WeChat Pay, quindi dovrai chiedere in Marketplace o svilupparlo tu stesso. Forse potresti interessare Alipay o WeChat Pay a finanziare lo sviluppo.

[tknospdr (David Muszynski)]

{“content”:“[quote="Discourse, post:1, topic:140818"]\n### Configurazione\n\n1. Installa e abilita il plugin\n2. Configura il Gateway di Pagamento (Stripe)\n3. Configura Webhook & Event in Stripe\n4. Aggiungi le tue chiavi Stripe (pubblica, segreta, webhook secret) sotto Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions\n5. Crea un gruppo per i tuoi abbonati a cui possono unirsi tramite acquisto\n6. Crea un prodotto e un piano sotto Admin > Plugins > Subscriptions\n7. Guadagna!\n[/quote]\nSono arrivato a completare 1 - 5, ma credo di essere stupido o cieco. Non riesco a trovare l’interfaccia per configurare prodotti e piani sul mio server.\n\nUgh, lasciamo perdere… l’ho trovata. L’ultimo pezzo del puzzle è che non capisco questa parte:\n\n28 * Per aggiungere una descrizione al tuo prodotto, aggiungi un campo metadata chiamato “description” e usalo al suo posto. Puoi usare Markdown.”}

[tknospdr (David Muszynski)]

Credo di aver impostato tutto correttamente. Se controllo l’impostazione per:\n~~Il pulsante di iscrizione mostrerà la tabella dei prezzi incorporata e verrà utilizzato Stripe Checkout.\nAllora gli acquisti funzionano correttamente, tuttavia, se deseleziono questa opzione e utilizzo l’interfaccia integrata, ottengo caselle di errore come:\n\n\u003eEra previsto un metodo di pagamento di tipo card, ma questo PaymentIntent non ha un metodo di pagamento e nessuno è stato fornito. Riprova fornendo i parametri payment_method o payment_method_data.\n\no~~\n\n\u003eQuesto cliente non ha una fonte di pagamento o un metodo di pagamento predefinito associato. Si prega di considerare l’aggiunta di un metodo di pagamento predefinito. Per ulteriori informazioni, visitare https://stripe.com/docs/billing/subscriptions/payment-methods-setting#payment-method-priority.\n\nL’errore principale è su un piano non ricorrente, quello in basso è un piano ricorrente.\nQualche indizio su come risolverlo? Preferisco l’interfaccia integrata.\n\nHo risolto questo problema, sembra che mentre stavo giocando con gli utenti nell’ambiente di test, a Stripe non sia piaciuto che io abbia utilizzato lo stesso utente Discourse con diversi "utenti di abbonamento".\n\nInoltre, l’OP dovrebbe chiarire che \n\n\u003ePer aggiungere una descrizione al tuo prodotto, aggiungi un campo di metadati chiamato “description” e usalo invece. Puoi usare Markdown.\n\nVai alla dashboard di Stripe, fai clic su Catalogo prodotti, fai clic su un prodotto, quindi fai clic su un prezzo. È qui che troverai i campi di metadati a cui puoi aggiungere una descrizione.\n\nTuttavia, non mi è sembrato funzionare. Ho aggiunto una descrizione di test e non è cambiato nulla sia utilizzando la tabella Stripe che il layout integrato.

[SubStrider]

Quando provo a creare un prodotto, ricevo un errore “500”. Sto configurando questo su un setup di test. Cosa posso controllare per scoprire perché si verifica l’errore del server?

Cosa simile sui coupon

[Moin]

È stata creata una voce nello stesso momento in {YOURFORUM}/logs ?

[SubStrider]

Oh wow.. non sapevo che esistesse una pagina del genere. Mostra una chiave API non valida. Ho inserito della spazzatura per la chiave segreta per andare avanti e configurare i pacchetti di abbonamento per ora e tornare alle chiavi più tardi quando sarò pronto per testare.

[SubStrider]

Sono stato in grado di configurare il plugin senza problemi, ma poi mi sono reso conto che questo plugin consente solo abbonamenti ricorrenti. Non abbonamenti una tantum che scadono dopo il periodo definito.

Ad esempio, addebita X importo per 30 giorni. Dopo 30 giorni l’utente viene rimosso dal gruppo premium. Possono acquistarlo di nuovo se vogliono. Di solito offro abbonamenti di 1 mese, 3 mesi, 12 mesi.

Stripe richiede che mi registri come un’azienda per poter supportare i pagamenti ricorrenti. Sto accettando pagamenti una tantum su XenForo e la funzionalità nativa di XenForo gestisce la scadenza dell’abbonamento e la rimozione dall’appartenenza al gruppo.

Questo distrugge completamente il mio piano di passare a Discourse entro un mese.

[pfaffman (Jay Pfaffman)]

Ho una soluzione. Posso aiutarti a creare un’azione di GitHub che estrarrà dati da Data Explorer, includendo il nome utente e l’ID del gruppo da cui rimuoverli, e poi cambierà il loro gruppo di conseguenza.

Lo sto facendo per un cliente che si sta spostando su Discourse e ha un campo personalizzato con date al suo interno. Quindi dobbiamo spostare gli utenti in un gruppo “in scadenza” per dare loro un banner e poi in un altro per rimuoverli dal gruppo a pagamento quando il tempo scade.

Se hai un budget, puoi contattarmi o chiedere su Marketplace. Sto pianificando un post sul blog a riguardo con un esempio di uso generale, se mai avrò una pausa.

[SubStrider]

Ciao, le sottoscrizioni hanno funzionato bene fino al momento in cui è arrivato il callback da Stripe. Sto usando la tabella dei prezzi di Stripe.

Posso vedere che l’abbonamento è stato registrato correttamente nella pagina admin/plugins/discourse-subscriptions/subscriptions.

Tuttavia, l’utente non è stato spostato nel gruppo utente richiesto.

Ho configurato il prodotto con lo stesso nome esatto del prodotto su Stripe e ho anche creato un piano tariffario con il gruppo selezionato. Il prezzo che ho impostato a zero nel piano tariffario poiché presumo che per la configurazione della tabella dei prezzi di Stripe sia irrilevante.

Cosa mi sto perdendo?