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

  1. 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.
  2. 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.
  3. 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

  1. Open your Inflow Dashboard, and go to Settings → Integrations.
  2. Click Connect on the Discord card. Discord opens.
  3. 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:

PermissionWhy
Manage RolesTo give and remove the subscribers' role.
Kick MembersTo remove members from your server when their access ends.
Create InviteTo 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

  1. Go to Product catalog → Subscription templates, and create or edit a template.
  2. Turn on Discord Roles.
  3. Choose the Discord server, then the role subscribers receive in Select role.
Discord Roles on a subscription template

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

Discord 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:

CommandWhat it does
/setup-notificationsPosts notifications in this channel. Choose All Payments, Success Only or Failures Only in type.
/notification-statusShows the channel and settings in use.
/test-notificationPosts a test notification.
/pingChecks 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

ProblemFix
The subscriber didn't get the roleCheck 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 listRoles 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 listAdd the bot to it with Add server.
The subscriber connected the wrong Discord accountAt checkout, they can click Switch Account before paying. After paying, contact [email protected].
A former subscriber still has the roleTheir 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 showRun /notification-status in the channel, and check that the bot can send messages there. Run /setup-notifications again if needed.

Did this page help you?