Skip to main content

Connecting Discord

Link your Discord server to PayBru so that membership roles are managed automatically. The setup takes about five minutes.

Prerequisites​

  • A PayBru creator account with at least one membership tier.
  • Manage Server permission on the Discord server you want to connect.

Step 1 - Start the Connection​

  1. Open your PayBru Creator Dashboard.
  2. Navigate to Settings > Integrations > Discord.
  3. Click Connect Discord Server.

You will be redirected to Discord's OAuth2 authorization screen.

Step 2 - Authorize the PayBru Bot​

PayBru uses the Discord.Net library with a DiscordSocketClient under the hood. When you authorize, the bot requests two OAuth2 scopes:

  • bot - allows the bot to join your server and manage roles.
  • applications.commands - enables slash command support.

Choose a Permission Profile​

During authorization, you can select one of four permission profiles depending on your needs:

ProfilePermissionsBest For
MinimalManageRoles, SendMessages, EmbedLinksCreators who only need role sync
Moderation (default)ManageRoles, ViewAuditLog, BanMembers, SendMessages, EmbedLinksMost communities - includes ban sync
SetupManageRoles, ManageChannels, ViewAuditLog, BanMembers, SendMessages, EmbedLinksInitial server setup with channel management
AdministratorAdministratorFull control - use only if needed
  1. Select the server you want to connect from the dropdown.
  2. Review the permissions for your chosen profile.
  3. Click Authorize and complete the CAPTCHA if prompted.
tip

If you manage multiple servers, make sure you pick the correct one from the dropdown before authorizing. The Moderation profile is recommended for most communities.

Gateway Intents​

The PayBru bot uses the following gateway intents to function correctly:

  • Guilds: track server structure and roles.
  • GuildMembers: detect when members join or leave.
  • GuildMessages: respond to commands in your server.
  • MessageContent: read command arguments.
  • GuildBans: sync ban lists across connected communities.

These intents are configured automatically - no action is required on your part.

Step 3 - Configure Bot Permissions​

After authorization, the PayBru bot joins your server. Verify its permissions:

  1. Open Server Settings > Roles in Discord.
  2. Find the PayBru role that was created automatically.
  3. Confirm the following guild permissions are enabled: ManageRoles, ViewAuditLog, BanMembers, ManageChannels, SendMessages, EmbedLinks.
  4. Drag the PayBru role above any roles it needs to manage in the role hierarchy. Discord prevents bots from assigning roles that sit higher than their own role.
caution

If the PayBru role is below a membership role in the hierarchy, the bot will not be able to assign that role. Always keep the PayBru role near the top of the list.

Step 4 - Confirm the Connection​

Return to your PayBru dashboard. The Discord integration panel should now show your server name and a Connected status. If you see an error, double-check that:

  • The bot has not been kicked from the server.
  • The required permissions (ManageRoles, ViewAuditLog, BanMembers, ManageChannels, SendMessages, EmbedLinks) are still enabled.
  • Your Discord account has Manage Server permission.

How Members Connect Their Discord Account​

Members connect their Discord account to PayBru via OAuth2:

  1. The member visits their PayBru Profile > Connected Accounts.
  2. They click Connect Discord and authorize PayBru to read their Discord identity.
  3. Their Discord user ID is stored in their PayBru user claims.
  4. PayBru checks the member's guild membership via the Discord REST API (with a 5-minute cache) to verify they are in your server before assigning roles.

Next Steps​

With the connection in place, head to Role Mapping Basics to link your PayBru membership tiers to Discord roles.