Creator Setup Guide
Contents
- Before you start
- Step 1 — Invite the bot
- Step 2 — Choose your paid role
- Step 3 — Connect Stripe
- Step 4 — Generate your join link
- Step 5 — Test the flow
- Troubleshooting
- FAQ
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.