Discord Integration

Recommended: Custom Discord Bot

Pixlpay now uses a Custom Discord Bot approach for Discord role delivery. This requires no hosting, no infrastructure, and provides instant role delivery.

Go to Custom Discord Bot Setup Guide

Overview

Discord role delivery in Pixlpay works through Discord's HTTP Interactions system. You create your own Discord bot at the Discord Developer Portal, configure it to point to Pixlpay's webhook endpoint, and Pixlpay handles all the role assignment logic.

How It Works

1. Customer purchases product with Discord role
2. Role queued to delivery queue
3. Customer runs /claim in your Discord server
4. Discord sends interaction to Pixlpay
5. Pixlpay assigns role using your bot token
6. Customer receives role instantly!

Key Benefits

Feature	Description
Zero Hosting	No VPS or server required
Always Online	Discord's infrastructure ensures 100% uptime
Easy Setup	~5 minutes to configure
Instant Delivery	Roles assigned immediately when customer runs /claim
Secure	Bot token encrypted, Ed25519 signature verification

Quick Setup

1. Create a Discord Application at Discord Developer Portal
2. Add a Bot and copy the Bot Token
3. Configure in Pixlpay - Enter Application ID, Public Key, and Bot Token
4. Set Interactions Endpoint URL in Discord to your Pixlpay webhook URL
5. Invite the bot to your Discord server with Manage Roles permission

Full Setup Instructions

Customer Commands

Command	Description
/claim	Claim all pending role deliveries
/check	View pending and recent role deliveries
/help	Show available commands

Configuring Products

1. Edit a product in your Pixlpay dashboard
2. Go to the Delivery tab
3. Enable Discord Role
4. Select the role to assign

Subscription Behavior

Event	Action
Purchase	Role assigned when customer runs /claim
Renewal	Role remains active
Cancellation	Role removed after period ends
Expiration	Role automatically removed

Troubleshooting

Bot Can't Assign Role

• Drag the bot's role above target roles in Discord Server Settings > Roles
• Ensure bot has "Manage Roles" permission
• Re-invite bot if needed

Customer Not Receiving Role

• Customer must be in your Discord server
• Customer must have linked their Discord account on your store
• Customer must run /claim in your Discord server

Commands Not Appearing

• Slash commands can take up to 1 hour to appear globally
• Re-invite bot with applications.commands scope
• Click "Re-register Commands" in Pixlpay dashboard

Documentation

• Discord Integration Overview - General Discord integration guide
• Custom Discord Bot Setup - Detailed setup instructions
• Discord API Reference - API documentation for Custom Bot endpoints
• Troubleshooting - Common issues and solutions