Skip to main content
SellAuth can join a buyer to your Discord server and give them a role the moment their payment clears. This is how paid access, supporter roles and subscription tiers are usually delivered on Discord.

Connect your bot first

Roles cannot be configured until a Discord application is connected to your shop, under Discord Auto Join & Role in shop settings. That needs a client ID, a client secret and a bot token from your own Discord application. The bot has to be in the server, and its role has to sit above the roles it will assign. Discord does not let a bot grant a role equal to or higher than its own. When that happens the assignment fails with no visible error, so a setup that looks correct does nothing at all.

Configure roles on a variant

Roles are set per variant, so a monthly tier and a lifetime tier on the same product can grant different access. Remove In is what makes timed access work. A 30 day role on a monthly product expires on its own, with no cleanup from you. Without a plan that includes role removal, the roles you grant stay until you take them off by hand.

Requiring a Discord login

Delivery needs to know which Discord account to act on. Turn on Force Discord Login on the product so buyers authenticate before purchase, which links their Discord account to the order. Without it, a buyer can complete checkout with no Discord account attached, and there is nobody to add to the server. The same integration also lets customers sign in to their dashboard with Discord. See Signing in for how accounts are matched and where to switch it off.

Restricting a product to a role

Required Discord Role limits who can buy a product to people who already hold a role in one of your servers. Use it for member-only drops, renewals that only existing subscribers can buy, or upgrades that need a lower tier first. Set it on the product’s Checkout tab, in the Discord card: pick a Discord Server and a Discord Role. It applies to the whole product, not per variant, and requires the Business or Scale plan. To set it on many products at once, use the Discord field in bulk edit. When you save, SellAuth checks that your bot is in the selected server. A role requirement also turns on Force Discord Login and keeps it locked on until you clear the role, since the check needs to know who the buyer is. The product page and cart stay open to everyone. The check runs when the buyer submits payment at checkout: SellAuth looks up their connected Discord account in the server with your bot, and only lets the order through if they are a member and hold the role. Role changes can take up to a minute to be picked up, so a buyer you just gave the role may need to retry shortly after.
The requirement is enforced only while your Discord application is connected. If you remove the client ID, client secret or bot token under Discord Auto Join & Role, role-gated products become purchasable by anyone.
Over the API, the product create and update endpoints take required_discord_guild_id and required_discord_role_id, which only take effect together. Update replaces them on every call, so leaving them out, or sending either as null, removes the requirement.

Checkout errors

These are the messages a buyer sees when a Discord check fails at checkout. Payment does not start, and the buyer can fix the problem and pay again. If every buyer gets the last message, your bot has most likely been removed from the server. Add it back, or pick a server it is in.

Troubleshooting

Nothing happens after purchase. Check the bot’s role position first, then that the bot is still in the server. Buyer was added but received no role. Same cause, in the case where the bot can join people but cannot assign that particular role. No Discord account on the order. Force Discord Login was off when they bought. Add the role by hand and turn the setting on. Role never expires. Remove In was left empty. It is set per variant, so check the variant they bought rather than the product. Buyer has the role but is told they are not authorized. Check they connected the same Discord account that holds the role, and that the role is in the server picked on the product. If you gave them the role in the last minute, have them try again. Required Discord Role shows “Business Plan Feature”. Role requirements need the Business or Scale plan. “Your Discord bot is not in the selected server.” when saving. Invite the bot to that server, or pick a server it is already in.

Next steps

How delivery works

What else runs when a payment clears.

Products and variants

Where Force Discord Login and Required Discord Role are configured.