Delivery Queue
Monitor and manage automated product deliveries to your customers and game servers.
Overview
The Delivery Queue shows the real-time status of all product deliveries for your store. When a customer completes a purchase, each product enters the delivery queue and is processed based on its delivery method.
Delivery Methods
| Method | Description | Processing |
|---|---|---|
| Instant | Delivered immediately after payment | Automatic |
| Instructions sent in order confirmation | Automatic | |
| In-Game | Delivered to game server via plugin/API | Automatic or Manual |
| Manual | Requires store owner to fulfill | Manual |
Accessing the Delivery Queue
- Go to Orders > Delivery Queue
- View the real-time dashboard with status cards and delivery list
Understanding Delivery Status
Each delivery has one of four statuses:
| Status | Color | Meaning |
|---|---|---|
| Pending | Yellow | Waiting to be processed |
| Processing | Blue | Currently being delivered |
| Delivered | Green | Successfully completed |
| Failed | Red | Delivery attempt failed |
Status Cards
At the top of the page, you'll see four cards showing counts for each status:
- Pending - Items awaiting delivery
- Processing - Items currently being processed
- Failed - Items that need attention
- Delivered - Successfully completed items
Filtering Deliveries
Use the filter bar to find specific deliveries:
Search by Order Number
Type an order number (e.g., #12345) to find deliveries for that order.
Filter by Status
Select a status to show only deliveries in that state:
- All Status
- Pending
- Processing
- Failed
- Delivered
Filter by Delivery Method
Filter by how the product is delivered:
- All Methods
- Instant
- In-Game
- Manual
Retrying Failed Deliveries
When a delivery fails (e.g., game server was offline), you can retry it:
Retry Single Delivery
- Find the failed delivery in the list
- Click the retry icon in the Actions column
- The delivery will be re-queued
Retry All Failed
- Click the Retry All Failed button (appears when there are failures)
- All failed deliveries will be re-queued at once
When to Retry
Common reasons for failed deliveries:
- Game server was temporarily offline
- Network connectivity issues
- API rate limiting
- Plugin not responding
Most failures resolve themselves when you retry after the issue is fixed.
Auto-Refresh
The Delivery Queue can automatically refresh to show real-time updates:
- Auto-refresh ON - Page updates every 30 seconds
- Auto-refresh OFF - Manual refresh only
Toggle auto-refresh using the button in the top right, or click Refresh to update manually.
Delivery Queue Table
The main table shows all deliveries with these columns:
| Column | Description |
|---|---|
| Order | Order number (click to view order) |
| Product | Product name that was purchased |
| Customer | Customer name and email |
| Method | Delivery method (Instant, Email, In-Game, Manual) |
| Status | Current delivery status |
| Queued | When the delivery was created |
| Last Attempt | When delivery was last attempted |
| Actions | Retry button for failed/pending items |
How Delivery Processing Works
Instant Delivery
- Customer completes payment
- Product marked as delivered immediately
- Redemption code (if any) shown in order confirmation
Email Delivery
- Customer completes payment
- Delivery instructions included in order receipt email
- Product marked as delivered
In-Game Delivery
- Customer completes payment
- Delivery queued for game server
- Plugin/agent polls API for pending deliveries
- Plugin executes delivery commands
- Plugin confirms delivery complete
- Status updated to delivered
Manual Delivery
- Customer completes payment
- Item stays in "Pending" status
- Store owner fulfills manually
- Store owner marks as delivered in order details
Discord Role Delivery
For Discord-integrated stores, role deliveries appear in the queue:
- Customer purchases product with Discord role reward
- Delivery queued for Discord
- Bot assigns role to customer's Discord account
- Status updated to delivered
See Discord Integration for setup.
Game Server Integration
For in-game deliveries to work automatically:
- Install the Pixlpay plugin on your game server
- Configure the plugin with your API credentials
- Set products to use "In-Game" delivery method
- Plugin polls for pending deliveries and executes commands
See Game Servers for plugin setup.
Delivery Instructions
Products can have custom delivery instructions that are:
- Shown to customers in order confirmation
- Sent via email after purchase
- Displayed in customer account portal
Available Placeholders
Use these placeholders in delivery instructions:
| Placeholder | Replaced With |
|---|---|
{order_number} | Order number (e.g., #12345) |
{customer_name} | Customer's name |
{customer_email} | Customer's email |
{product_name} | Product name |
{redemption_code} | Generated code (if configured) |
{store_name} | Your store name |
{quantity} | Quantity purchased |
Redemption Code Generation
Generate unique codes for each purchase using templates:
| Placeholder | Generates |
|---|---|
{order_number} | Order number |
{order_id} | Order database ID |
{item_id} | Item database ID |
{random:4} | 4 random hex characters |
{random:6} | 6 random hex characters |
{random:8} | 8 random hex characters |
{timestamp} | Unix timestamp |
Example template: PRISM-{order_number}-{random:6}Generated code: PRISM-12345-A3F2B1
Troubleshooting
Deliveries Stuck in Processing
If deliveries stay in "Processing" for too long:
- Check if your game server is online
- Verify plugin is running and connected
- Check plugin logs for errors
- Try restarting the plugin
- Use "Retry" to re-queue the delivery
All Deliveries Failing
Common causes:
- API credentials expired - Regenerate in Settings > API Tokens
- Plugin outdated - Update to latest version
- Server firewall - Ensure plugin can reach
api.pixlpay.net - Rate limiting - Wait a few minutes and retry
Delivery Marked Complete But Not Received
- Check the order details for delivery confirmation
- Verify customer provided correct game username
- Check plugin logs for command execution
- Customer may need to relog in game
Manual Delivery Required
Some situations require manual intervention:
- Custom products with complex fulfillment
- Physical merchandise components
- Services requiring human action
- One-time special orders
Best Practices
Monitor Regularly
- Check the queue daily for failed deliveries
- Enable auto-refresh during peak sales
- Set up Discord webhook notifications for failures
Handle Failures Promptly
- Failed deliveries impact customer satisfaction
- Most failures are temporary - retry first
- Contact customers if delivery can't be completed
Use Appropriate Delivery Methods
| Product Type | Recommended Method |
|---|---|
| Digital downloads | Instant or Email |
| Game items/ranks | In-Game |
| Discord roles | In-Game (via Discord bot) |
| Custom services | Manual |
| Physical goods | Manual (then POD for merch) |
Related Features
- Orders - View order details and delivery status
- Products - Configure delivery methods per product
- Game Servers - Set up game server plugins
- Discord Integration - Configure Discord role delivery
- Webhooks - Get notified of delivery events