Discord Linking
Assign Discord roles automatically on purchase, and understand when roles are removed.
Linking Discord lets purchases assign roles automatically, so a supporter's rank shows in your community as well as in game. This page covers the purchase-to-role flow.
Before any of it works, the Discord server itself has to be linked: add the PayNow bot, put its role above the roles it will manage, and run /pnregister <unique_id> in a channel. Those steps are in Discord Servers.
Assign roles in Deliverable Actions
Go to Content → Products.
Create or edit a product.
Scroll to Deliverable Actions.
Click Add Action → Assign Discord Role.
Choose your Discord Game Server from the dropdown.
Select the role to assign on purchase.
Save.
Customers buying this product now receive the role automatically.
When roles are removed
On the product's Discord action, Remove role access on offers three triggers. A new action starts with all three ticked.
Expiration
The product expires or you revoke it manually.
Refund
You refund the order.
Chargeback
The customer disputes the charge with their bank.
Revoking runs the expiry path, so Expiration covers manual revocation too. There is no separate "on revoke" trigger to look for.
Unticking one of these is how customers keep a role they no longer paid for. They are on by default for a reason. Untick Chargeback and someone who disputes the charge keeps the role permanently.
FAQ
Can I link multiple Discord servers? Yes. Create multiple Discord server integrations, just as you would game servers.
What permissions does the bot need? Manage Roles to assign roles, and Read Messages to process commands. Both are requested automatically when you invite the bot, so no manual adjustment is needed unless permissions are later changed in Discord.
What happens if a user leaves the server? If they leave and rejoin, the bot automatically reassigns their role, as long as the package is still active and unexpired. It syncs their roles to the current state of their package.
Linking bounces back to checkout without linking. Usually the customer's browser: an ad or privacy blocker interrupting the Discord redirect. Have them retry in a private window with extensions off.
A customer bought but has no role. What now? They probably never linked their Discord. See Customers who forget to link Discord.
Last updated