GuildPass Dashboard
GUIDE

Creator Setup Guide

Get GuildPass running in about 5 minutes. Stripe subscriptions sync automatically to the Discord role you choose.

Start setup

Contents

Before you start

You'll need:

  • A Discord server where you want to manage paid access
  • A Stripe account (existing or new)
  • Admin permissions on the Discord server to invite bots and manage roles

GuildPass connects your Stripe subscriptions to your Discord roles. When someone subscribes, they get the role. When they cancel or payment fails, the role is removed automatically.

Step 1 — Invite the bot

Go to your Discord server settings and open the "Integrations" or "Server Settings" menu. Click "Add Bot" or use the GuildPass invite link from the setup wizard.

Grant the bot permission to manage roles (required for automatic role assignment).

Tip: The bot only needs the "Manage Roles" permission. No other permissions are required.

Step 2 — Choose your paid role

In the setup wizard, select the Discord role that marks an active, paying member. This role will be automatically assigned when subscriptions become active and removed when payments fail or subscriptions cancel.

Tip: Create a dedicated role (e.g., "Member" or "Premium") if you don't have one yet. Make sure the GuildPass bot's role is positioned above this role in Discord's role hierarchy.

Step 3 — Connect Stripe

Click "Connect Stripe" in the setup wizard to authorize GuildPass via Stripe Connect. Use your existing Stripe account (no new account needed). GuildPass will listen for subscription events from your connected account.

Tip: You can test everything in Stripe test mode first. Test subscriptions will sync to Discord roles just like live ones.

Step 4 — Generate your join link

After connecting Stripe, GuildPass generates a unique join link for your server. Share this link with members who want to subscribe. Members will connect Discord, subscribe via Stripe, and get the role automatically.

Tip: You can regenerate the join link anytime from your dashboard if needed.

Step 5 — Test the flow

Use Stripe test mode to create a test subscription through your join link. Verify that the Discord role is assigned immediately after payment. Test cancellation or failed payment to confirm the role is removed automatically.

Tip: Use a test Discord account or your own account to verify the full flow before going live.

Troubleshooting

Role not being assigned

  • Verify the GuildPass bot has the "Manage Roles" permission
  • Ensure the bot's role is positioned above the paid member role in Discord's role hierarchy
  • Check that the subscription is active in Stripe
  • Review your dashboard for any error messages

Role not being removed

  • Confirm the subscription status in Stripe (failed, canceled, or past due)
  • Check that webhook events are being received (view in your dashboard)
  • Verify the bot still has access to your Discord server

Stripe connection issues

  • Ensure you're using the correct Stripe account
  • Try disconnecting and reconnecting Stripe in your dashboard
  • Verify Stripe webhooks are configured correctly

FAQ

How long does setup take?

Most servers are fully configured in 5–10 minutes. You'll invite the bot, choose a role, connect Stripe, and generate your join link.

Does it work with my existing Stripe account?

Yes. GuildPass connects to your existing Stripe account via Stripe Connect. You keep full control of your products, pricing, and payouts.

Can I test before going live?

Yes. Run everything in Stripe test mode first. Test subscriptions will sync to Discord roles just like live ones, so you can verify the flow before accepting real payments.

What happens on failed payments?

When Stripe marks a subscription as failed, canceled, or past due, GuildPass automatically removes the member's Discord role. They lose access immediately.

How do I change the role or regenerate the join link?

Visit your dashboard to update the paid member role or regenerate your join link at any time. Changes take effect immediately.

What permissions does the bot need?

The GuildPass bot only needs the "Manage Roles" permission. It cannot read, send, or delete messages. It only manages the one role you configure during setup.

Can I disconnect GuildPass anytime?

Yes. You can revoke GuildPass access to your Discord server or Stripe account at any time from your dashboard or the respective service settings.

Start setup