Xsolla Bot in Discord

Overview

The bot operates directly within your Discord server and enables users to sign in, claim rewards, and make purchases without leaving the Discord environment. In addition, the bot supports outbound messaging to channels.

User flow in Discord:

1. The user types in /shop in any channel in which the bot is connected to. The shop appears to the exact user who used the command — other users in the channel won’t see it.

2. The user logs in with their player ID.
3. The user browsers through the catalog.
4. The user clicks the purchase button next to the desired item.
5. The user is redirected to the payment UI.
6. After successful payment, the user returns to the Discord channel, and the item is granted to the user in the game.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as User
    participant D as Discord Bot
    participant X as Xsolla
    activate U
    U->>D: /shop command
    activate D
    D-->>U: Shop UI appears
    deactivate D
    U->>D: Log in with Player ID
    activate D
    D-->>U: Catalog displayed
    deactivate D
    U->>D: Click purchase on desired item
    activate D
    D->>X: Player ID + Item SKU
    activate X
    X-->>D: Return link to Payment UI
    D-->>U: Redirect to Payment UI
    deactivate D
    U->>X: Complete payment
    activate X
    note right of X: Grant item to player inventory
    deactivate X
    X->>D: Webhook: item granted notification
    deactivate X
    activate D
    D-->>U: Confirmation of successful purchase
    deactivate D
    deactivate U

Prerequisites

To sell your in-game items using the bot, you need to:

1. Use Discord to communicate with users.
2. Create an item catalog. You can do it manually, via API, or by importing from JSON files or external platforms.
3. Configure the following webhooks to validate users and grant purchases to the users:
   • User validation
   • Successful payment for order
   • Order cancellation
4. Sign the Licensing agreement with Xsolla.

How to set it up

Create bot

1. In your project in Publisher Account, go to the Storefront > Xsolla Bot in Discord section.
2. Click Create.

3. Upload the logo and specify the bot name.
4. Click Create.
5. Go to the Settings tab to complete the bot configuration:
   1. In the Player ID help configurator block, click Set up and provide concise instructions on how users can find their player ID. It will be displayed in the Discord UI once the user clicks How to find player ID.

2. The API key is generated automatically. If you want to update it, click Generate key.
3. The bot token is generated automatically. If you already have a bot in Discord, click Change and provide its token in the corresponding field.

Instructions on finding bot token in Discord

1. Go to the page of your application in the Discord developers portal.
2. Go to the Overview > Bot section.
3. In the Token section, click Reset token. You might be prompted to pass verification.
4. Copy the new token value.

To check if you added the token successfully, reload the page in Publisher Account. If you see an invite link at the top of the page, the configuration is successful. Follow this link to add the bot to your Discord server.

4. In the User authentication webhook block, click Change and specify the webhook URL from the Project settings > Webhooks section.
5. If you don’t need to connect your Web Shop, leave the Web Shop URL block unchanged.

Once you configured all required settings, the bot status will change to Active.

Configure items

To configure items to sell:

1. Go to the Shop tab and click Build your shop.
2. On the Shop items tab:
   1. Upload the shop cover image.
   2. Specify the shop title (required).
   3. Check the boxes next to the items you want to sell via Discord (required).
   4. Click Confirm.

After that you can go to your Discord server to check if the bot works correctly.

Configure reward items

To motivate users to visit your store more often, you can set up the following rewards:

• Login reward — rewards that become available to the user when they log into the store for the first time.
• Daily rewards — exclusive items that can be claimed once per day.

To set it up:

1. Go to the Shop tab and click Build your shop.

2. Set up reward items:
   1. On the Login rewards tab, select a free item and click Confirm.
   2. On the Daily rewards tab, select free items and click Confirm. To rearrange items in the correct order, drag and drop them on the main settings page.

After that you can go to your Discord server to check if the bot works correctly.