Discord bot

Detailed technical guide for installing & configuring the StreamPay bot in your Discord server

The Discord bot requires an active StreamX subscription

Turning on Developer Mode

Before proceeding, please turn on developer mode for Discord. This will allow you to see the server, role, and user IDs required to setup the Discord bot:

1. Open up the Discord app

2. Click on the settings cog in the bottom left corner

3. Go to Appearance -> all the way at the bottom

4. Toggle "Developer Mode" on

5. Exit user settings

Channel & role setup

The StreamPayments Discord bot is typically used to manage user access & subscriptions to premium channels.

Add the required channels and roles first. In this example, we've created a new channel called "premium" which is a private channel with the padlock icon below the "general" channel.

Image here

Setup a new role, or use an existing role if preferred. Navigate to the Discord side nav and then select "Server Settings" --> "Roles" to see your roles or an option to add a new one if you don't have any.

We created a role called "StreamPayments access" in this example:

Select the three dots for more options and copy and save the role ID for later configuration in the StreamPayments dashboard. It will look similar to this: Discord code here

StreamPayments settings

Log in to the StreamPayments dashboard, and select "Settings" --> "Discord".

Image here

Hit "Authenticate" to allow the StreamPayments bot to be installed via Discord. This authentication will use your Discord administrator credentials in your default browser to approve the installation of the bot for the required server as follows:

Image here

Head back to the dashboard URL here /settings and you will notice the Discord section has changed to allow you to enter the two IDs. Enter the Server ID and the Role ID and hit "Save Settings".

Image here

Great! That's everything configured on the StreamPayments dashboard side to get everything linked. Now let's head back to the Discord server and finish off the last remaining tasks.

If you want to set up multiple roles and subscriptions in a single Discord server you can do so by logging in to StreamPayments from a different Web3 wallet and going through the same setup process.

Finalise Discord setup

Return to "Server Settings" then "Roles" and you should now see the "StreamPayments" role appear:

Image here

Select "StreamPayments" to see the following. This is the bot role and should NOT be changed. Note that you can remove the bot in "Server Settings" --> "Integrations" if required.

Image here

You MUST move the StreamPayments bot above the roles that you want to assign due to Discord's role hierarchy logic. Drag the StreamPayments role up above the "StreamPayments Access" group as follows

Image here

Ok, we're ready to create a StreamPayments Link to charge and gate access for your premium role.

Create a Pay Link or Pay Stream

Log in to the StreamPayments dashboard URL and hit CREATE PAYMENT. Choose a Pay Link to enable access to your premium channel with a 1-time payment, or Pay Stream to enable access based on a recurring payment, e.g. a monthly subscription payment. Configure your Payment details, Pricing options and select the Discord setting in Advanced options as follows:

Image here

This associates the Discord configuration settings with this payment. Hit CREATE and that's it. All done!

Users need to be existing members in your Discord server for the StreamPayments bot to assign roles. Therefore, it's best practice to only share the Pay Link in your Discord server

Once the payment is completed, the relevant role ID will be assigned. In our case, they will be added to the "StreamPayments Access" role where the premium content is located.

Image here

If we check back in Discord, we notice my user has been assigned the "StreamPayments Access" role instantly.

Image here

If you run into any problems please go into our Discord server to create a support ticket.