Launch a Discord supporter tier

Documentation Index

Fetch the complete documentation index at: https://docs.shoppex.io/llms.txt

Use this file to discover all available pages before exploring further.

You have a Discord server. You want to sell access to a private channel, a supporter role, or ongoing perks for a monthly fee. This walkthrough takes you from zero to a working supporter tier in about 20 minutes.

​

What you’ll have at the end

• A Discord role that gets granted automatically when someone subscribes on your shop.
• The role is revoked when the subscription is canceled or fails (as long as “Remove role on cancel” stays on — it’s the default).
• A customer dashboard your buyers use to manage their subscription themselves.

​

Prerequisites

• A Discord server you own (you need Manage Server permission).
• A Shoppex shop with at least one payment gateway connected. If you don’t, do Quickstart first.

​

Step 1 — Connect Discord and invite the bot

In your Shoppex dashboard, open Settings → Integrations → Discord.

1. Click Connect Discord. This is the OAuth step that links your Discord identity to your Shoppex account.
2. Pick the target server from the dropdown that appears.
3. Click Invite Bot. Discord opens its OAuth approval flow asking you to authorize the Shoppex bot on the server you just picked.
4. The bot requests Manage Roles, View Channels, Send Messages, and Embed Links. Accept.
5. Discord redirects you back to Shoppex with the bot connected.

In your Discord server settings, you’ll now see the Shoppex bot listed as a member. Important: its role in the server hierarchy must sit above any role you intend to sell. This is a Discord rule — bots can only manage roles below their own. Drag the Shoppex role up in Server Settings → Roles if needed.

​

Step 2 — Create the supporter role

In Discord → Server Settings → Roles → Create Role. Give it a name like Supporter, pick a color, set any permissions for private channels you want this role to see. This role is now ready to be tied to a Shoppex product.

​

Step 3 — Create the subscription product

Back in Shoppex → Products → New product.

• Type: Subscription (this is the product Type — not the Discord-role concept; that comes next).
• Title: “Supporter — Monthly” (or whatever fits).
• Price: Set monthly amount and billing interval.

Then scroll to the product’s Discord section and:

• Toggle Assign Role on.
• Pick the server.
• Pick the Supporter role (loaded live from your server).
• Leave Remove role on cancel on (the default) so the role gets revoked when the subscription ends.

Save the product. It’s now live on yourshop.shoppex.io.

​

Step 4 — Test the flow yourself

Open your shop in an incognito window. Buy the product with one of your own gateways (or use a Stripe test key if you connected one). You should see:

1. Checkout asks you to link your Discord account.
2. You authorize via Discord OAuth.
3. You pay.
4. Within a few seconds, the Supporter role appears on your Discord account.

If anything stalls: the order page in your dashboard tells you exactly which step is pending.

​

Step 5 — Announce it

Share the product link in your server (or anywhere). Buyers click → checkout → done.

​

What happens when someone subscribes

Each month:

• The subscription auto-renews against the gateway the buyer used at signup.
• If renewal succeeds, the role stays. No action needed from you or them.
• If renewal fails, Shoppex enters a 7-day grace period (configurable in shop settings). The role stays. The buyer is asked to update payment.
• Once the subscription has two voided invoices total (cumulative across its lifetime, not just consecutive), Shoppex auto-cancels it. The role is revoked at cancel time.

Buyers can cancel anytime from their customer dashboard. Cancellation behavior depends on gateway — see Subscriptions for the specifics (Stripe/crypto cancel at period end, PayPal cancels immediately).

​

Common questions

“Can I have multiple supporter tiers?” Yes. Create a separate product per tier (Bronze / Silver / Gold), bound to different roles. A buyer can hold several at once. “Can I grant roles across multiple servers?” Not from one product — Assign Role binds to one role on one server. To cover multiple servers, create multiple products and either bundle them or use addons. “What if a buyer leaves my Discord server?” Shoppex can’t grant a role to someone who isn’t in the server. The order pauses in pending-fulfillment until they rejoin, then you can re-trigger fulfillment from the order page. “What if I delete the role?” Shoppex can’t grant a role that no longer exists. Existing holders lose it implicitly (because the role is gone), and new orders fail to fulfill. Don’t delete roles tied to active subscriptions.