PayBot Setup Guide

Connect Stripe, verify your setup, and start monetizing your Discord server in under 5 minutes.

Table of Contents

PayBot setup dashboard showing a connected Stripe account

Prerequisites

Before you begin the setup process, ensure you have the following:

👤

Administrator Permissions

You must have Administrator permissions in your Discord server to run the /setup command.

💳

Stripe Account

An active Stripe account is required. Create one for free if needed.

🤖

Bot Permissions

PayBot needs "Manage Roles" permission to automatically assign membership roles to subscribers.

Step 1: Connect Your Stripe Account

Securely connect your Stripe account to PayBot using Discord's OAuth flow.

1

Run the Setup Command

In your Discord server, type /setup in any channel where PayBot has permission to read messages.

/setup
2

Click "Connect Stripe Account"

You'll see a "Connect Stripe Account" button in the setup interface. Click this button to begin the OAuth process.

Note: This redirects you to Stripe's secure authorization page. PayBot only requests access to create payment links and manage subscriptions on your behalf.

3

Authorize PayBot

On Stripe's page, review the permissions and click "Authorize" to grant PayBot access.

Security Note: PayBot uses Stripe Connect's secure OAuth flow. Your API keys are never shared - Stripe provides secure access tokens instead.

4

Return to Discord

After authorization, you'll be redirected back to Discord. The setup interface will update to show your connected Stripe account.

Step 2: Verify Connection

Verify that your Stripe integration is working properly.

1

Click "Verify Connection"

In the /setup interface, click the "🔍 Verify Connection" button to test your Stripe integration.

2

Check Connection Status

PayBot will attempt to connect to your Stripe account. You'll see one of these results:

  • ✅ Connected: Your Stripe account ID will be displayed with available features
  • ❌ Connection Failed: Check your Stripe dashboard for errors or try reconnecting

Common Verification Issues

  • Stripe Account Restricted: Complete Stripe's verification process in your Stripe dashboard
  • OAuth Authorization Failed: Try the connection process again, ensuring you complete the full OAuth flow

Step 3: How PayBot Pricing Works

PayBot is free to install and use. We get paid when you make a sale, not before.

🚀

Free to Install

No monthly fee, no trial clock, no card up front. Add the bot, connect Stripe, and start selling.

💸

You Get Paid Directly

Members pay you on your own Stripe account. The money lands with you. Payouts, customers, and history stay yours.

🤝

We Earn When You Do

PayBot keeps a small share of each sale you make. No sales yet means nothing to pay.

What You Get

Every server gets the full toolkit at no upfront cost: membership tiers, one-time sales, payment links, the link-in-bio storefront, automatic role assignment, subscriber management, analytics, automations, and the courses tools. While you're small it costs almost nothing. As you grow, PayBot grows with you. No subscriber caps, ever.

The Fine Print

PayBot's share is about 3% of each sale, charged on your own Stripe only when a payment clears. You keep the rest.

Already on a Plan?

Communities that signed up on an earlier monthly plan keep it. You don't need to switch. Your existing billing carries on as before.

Step 4: Configure Bot Permissions

Proper Discord permissions are crucial for PayBot to function correctly.

Required Permissions

  • Manage Roles - For automatic role assignment
  • Send Messages - To respond to commands
  • Use Slash Commands - For /setup and /subscription
  • Embed Links - For rich embeds in responses

Role Hierarchy Setup

Critical: PayBot's role must be positioned above all membership roles in your server's role hierarchy.

  1. Go to Server Settings > Roles
  2. Find PayBot's role in the list
  3. Drag PayBot's role above your membership roles
  4. Ensure: PayBot > Premium Role > Basic Role > @everyone

⚠️ Important: If PayBot's role is below membership roles, it cannot assign them to users.

Step 5: Test Your Setup

Before launching to your community, test that everything works correctly.

1

Create a Test Membership Tier

Create a low-cost test tier (e.g., $1.00) that you can use for testing.

2

Test Role Assignment

Have a friend or alt account subscribe and verify the role is assigned correctly.

3

Test Cancellation

Test the cancellation flow to ensure roles are removed properly.

4

Verify Stripe Integration

Check your Stripe dashboard to confirm payments are being recorded correctly.

Pre-Launch Checklist

  • Stripe account connected and verified
  • Bot permissions configured correctly
  • Role hierarchy set up properly
  • Test payment completed successfully
  • Membership tiers created and configured
  • Community notified about new payment system

Common Issues & Solutions

❌ Stripe Connection Failed

Possible Causes:

  • Stripe account is restricted or requires verification
  • OAuth authorization was cancelled or failed
  • Network connectivity issues

Solutions:

  1. Check your Stripe dashboard for restrictions
  2. Try the connection process again
  3. Contact Stripe support if account is restricted

❌ Roles Not Being Assigned

Possible Causes:

  • PayBot's role is below membership roles in hierarchy
  • Bot lacks "Manage Roles" permission
  • Role no longer exists or was deleted

Solutions:

  1. Move PayBot above membership roles in Server Settings
  2. Ensure PayBot has "Manage Roles" permission
  3. Recreate the role if it was deleted

❌ Payment Button Not Working

Possible Causes:

  • Stripe account not properly connected
  • Membership tier is archived or inactive
  • Stripe account restricted or requires verification

Solutions:

  1. Use /setup and click "🔍 Verify Connection"
  2. Ensure the membership tier is not archived
  3. Check your Stripe dashboard for account restrictions

❌ Can't Create One-Time Payments

Possible Causes:

  • Stripe account not fully connected or verified
  • You opened "Add Recurring" instead of "Add One-Time"

Solutions:

  1. Run /setup and click "🔍 Verify Connection"
  2. Use /setup → "Add One-Time" to create the payment
  3. Contact support if the option still doesn't appear

Need More Help?

If you're still having issues after trying these solutions:

  • Check the Troubleshooting Guide for detailed solutions
  • Join our Discord support server for community help
  • Contact our support team for personalized assistance

What's Next?

Now that PayBot is connected, explore what you can do next:

Core Features

Advanced Features