Discord
Available via: Dashboard (setup) · Discord (notifications)
The Discord integration links a subscription template to a role in your Discord server. Subscribers connect their Discord account at checkout, the Inflow bot gives them the role, and removes it when their subscription ends.
How It Works
- The buyer opens your subscription link. Before paying, they click Connect Discord and sign in to Discord. It's required for a template with a Discord role.
- When the subscription starts, or its trial starts, the bot adds the buyer to your server if they aren't a member yet, and gives them the role.
- When the subscription ends, the bot removes the role and removes the member from your server.
Access is removed when:
- The subscription is Cancelled, either right away or at the end of the billing period.
- A renewal fails three times.
A subscription that's Pending Cancellation keeps its access until it ends. While a subscription is Past due, the bot sends the member a direct message about the failed payment.
A member keeps the role, and stays in the server, if another of their subscriptions still gives the same role or server.
Set Up
1. Add the bot to your server
- Open your Inflow Dashboard, and go to Settings → Integrations.
- Click Connect on the Discord card. Discord opens.
- Choose your server, keep the permissions selected, and click Authorize.
You need the Manage Server permission in Discord to add a bot. The bot asks for these permissions:
| Permission | Why |
|---|---|
| Manage Roles | To give and remove the subscribers' role. |
| Kick Members | To remove members from your server when their access ends. |
| Create Invite | To invite subscribers to your server. |
2. Place the bot's role above your subscriber roles
In Discord, go to Server Settings → Roles, and drag the Inflow bot's role above every role it should give. Discord doesn't let a bot give a role that's above its own, and the role isn't given.
3. Link a template to a role
- Go to Product catalog → Subscription templates, and create or edit a template.
- Turn on Discord Roles.
- Choose the Discord server, then the role subscribers receive in Select role.
A template with a Discord role can't also use Redirect after checkout: a template either gives a Discord role or sends subscribers to your website or app, not both. Turn off the redirect before turning on Discord Roles, and the reverse.
Discord roles are set in the Dashboard only; the API doesn't accept them. To use a template created with the API, edit it in the Dashboard to add the role.
Your Servers
Click See details on the Discord card to see your servers and their roles.
- Add server adds the bot to another server. Each template uses one server and one role.
- ⋮ → Open in Discord opens the server.
- ⋮ → Disconnect server stops Inflow from managing that server: no roles are given to new subscribers, and no notifications are posted. To connect it again, use Add server. The bot stays in your server: remove it in Discord, under Server Settings → Integrations.
Disconnecting doesn't remove anyone's access. Members who already have the role keep it, and stay in your server, even after their subscription ends: Inflow no longer removes roles or members on a disconnected server. Remove them yourself in Discord if needed.
To see who subscribed with which Discord account, add the Discord username column in Subscriptions, or open a subscription's Details.
Payment Notifications
The bot can post your subscription payments in a channel of your server: first payments, renewals, failed payments and status changes such as cancellations. Set it up in Discord with these commands, as a server administrator, in the channel that should receive them:
| Command | What it does |
|---|---|
/setup-notifications | Posts notifications in this channel. Choose All Payments, Success Only or Failures Only in type. |
/notification-status | Shows the channel and settings in use. |
/test-notification | Posts a test notification. |
/ping | Checks that the bot responds. |
The bot needs permission to send messages in that channel.
Customer Portal
If a subscriber left your server or lost their role, they can open the customer portal and click Sync Discord account. The bot adds them back to the server and gives them the role again, if their subscription is still active.
Troubleshooting
| Problem | Fix |
|---|---|
| The subscriber didn't get the role | Check that the bot's role is above the subscriber role in Server Settings → Roles, and that the server isn't disconnected in Inflow. Then ask the subscriber to click Sync Discord account in the customer portal. |
| A role isn't in the Select role list | Roles managed by an integration and @everyone can't be given by the bot, so they aren't listed. Create a regular role in Discord. |
| A server isn't in the Discord server list | Add the bot to it with Add server. |
| The subscriber connected the wrong Discord account | At checkout, they can click Switch Account before paying. After paying, contact [email protected]. |
| A former subscriber still has the role | Their subscription's server was disconnected in Inflow, so the role wasn't removed. Remove it in Discord, or connect the server again with Add server to manage roles automatically. |
| Notifications don't show | Run /notification-status in the channel, and check that the bot can send messages there. Run /setup-notifications again if needed. |
Updated 15 days ago
