Skip to main content
Your Discord bot gives buyers a role after they pay, and lets your staff check orders, stock and coupons without leaving Discord. It is your bot. You create it in Discord, and Join Markt runs its commands. The bot shows as offline in the member list. That is normal: it answers through Discord’s web endpoint, not a live connection.

Buyer roles

Paid buyers get a role on their own, or with one button.

Store commands

Stock, orders, coupons and prices from any channel.

Staff only

Store commands need Manage Server by default.

​
Set up

1

Create a Discord application

Open the Discord Developer Portal and press New Application.Under Bot, press Reset Token and copy the token. Under OAuth2, copy the Client ID and Client Secret.
2

Paste the keys in Join Markt

In the dashboard, go to Configure → Discord bot. Paste the Client ID, Client Secret and Bot Token, then press Save settings.Join Markt then sets the bot’s Interactions Endpoint URL in Discord for you.
3

Add the redirect URIs

The Setup guide card shows two redirect URIs. In the Developer Portal, open OAuth2 → Redirects and add both:
4

Invite the bot

Press Invite bot to server and pick your server. The bot asks for Manage Roles.
In Server Settings → Roles, drag the bot’s role above every role it gives. Discord does not let a bot give a role higher than its own.
5

Pick the roles

  • Per product: open a product, then Discord role delivery. Pick a server and a role.
  • For every buyer: set Default customer role ID in Configure → Discord bot.
6

Post the claim panel

In the channel where buyers should claim, run /roles panel. It posts a message with a Claim role button.

​
How buyers get their role

The order must be paid, completed or delivered, and the email must match the order. Each role is given once per order. The buyer must already be a member of your server. Set Customer server invite URL so checkout shows a Join link.
At checkout, the Discord link only keeps the buyer’s email when it matches the verified email on their Discord account. If it does not match, the account is still linked, but the role is not given on its own. The buyer then uses the claim panel or /claim.

​
Commands

Store commands need Manage Server. You can change who sees them in Server Settings → Integrations → your bot. /claim and /help work for everyone. Replies are only visible to the person who ran the command, except the claim panel.
/stock add takes up to 5,000 keys and files up to 512 KB. Keys can be split by new lines, commas or semicolons.
Product and coupon options search as you type.

​
Fix common problems

Press Sync slash commands in Configure → Discord bot, or run /store sync. Then restart Discord.
The buyer is not a member yet. They join with your invite link, then claim again.
  • Check the bot’s role sits above the role it gives.
  • Check the product has a role in Discord role delivery, or a default customer role is set.
  • Check the order is paid.
The server still has old commands. Run Sync slash commands once.

​
API

Read and change the bot settings with an API key: Merchant Discord.