Orders

The Orders system is the heart of PremiumCDKeys. It tracks every order from your store, handles fulfillment, and ensures keys reach your customers.

Order Lifecycle

┌─────────┐    ┌──────────┐    ┌───────────┐    ┌───────────┐
│ Pending │───▶│Processing│───▶│ Fulfilled │───▶│ Delivered │
└─────────┘    └──────────┘    └───────────┘    └───────────┘
     │              │                │
     ▼              ▼                ▼
┌─────────┐    ┌──────────┐    ┌───────────┐
│ Waiting │    │  Failed  │    │ Refunded  │
└─────────┘    └──────────┘    └───────────┘

Order Statuses

Viewing Orders

Dashboard Overview

The Dashboard shows recent orders with:

• Order number
• Customer name
• Product
• Status
• Actions

Orders List

Go to Orders for the full list:

1. Filter by status, date, product
2. Search by order number or customer
3. Sort by date, value, status

Order Details

Click any order to see:

• Customer information
• Product details
• Supplier and cost
• Delivery key
• Timeline of events

Automatic Processing

Enable Auto-Processing

1. Go to Application → Control
2. Enable Auto-process orders
3. Configure options:
   • Process delay (immediate or delayed)
   • Notification settings
   • Error handling

How It Works

New Order → Product Mapping Check → Stock Check → Purchase → Deliver

PremiumCDKeys automatically:

1. Detects new orders via webhook
2. Finds mapped supplier product
3. Checks stock availability
4. Purchases key from supplier
5. Delivers to customer

Manual Processing

Process Single Order

1. Go to Orders
2. Find the pending order
3. Click Process
4. Confirm the action

Bulk Processing

1. Select multiple orders (checkboxes)
2. Click Process Selected
3. Review and confirm

Manual Key Entry

For orders requiring manual fulfillment:

1. Open order details
2. Click Enter Key Manually
3. Paste the key
4. Save and deliver

Order Actions

View Key

See the purchased/stored key for an order.

Resend Delivery

Resend the key delivery email:

1. Open order details
2. Click Resend Email
3. Optionally update email address

Mark as Delivered

For manual deliveries:

1. Open order
2. Click Mark Delivered
3. Add notes if needed

Refund/Cancel

Cancel or refund an order:

1. Open order
2. Click Cancel or Refund
3. Key is released back to inventory (if applicable)

Order Search

Basic Search

• Order number
• Customer email
• Product name

Advanced Filters

• Date range
• Status
• Supplier
• Application
• Price range

Order Notifications

Customer Notifications

Customers receive:

• Order confirmation
• Key delivery email
• Download page link

Admin Notifications

You receive alerts for:

• Failed orders
• Low stock warnings
• Manual action required

Reports & Analytics

Order Summary

View aggregated data:

• Total orders
• Revenue
• Costs
• Profit margins

Export Orders

Export to CSV or Excel:

1. Apply desired filters
2. Click Export
3. Choose format
4. Download file

Troubleshooting Orders

Order Stuck in Processing

1. Check supplier API status
2. Verify product mapping
3. Check for errors in order details
4. Retry or process manually

Key Not Delivered

1. Verify customer email
2. Check spam/junk folders
3. Resend delivery
4. Check SMTP settings

Wrong Key Delivered

1. Document the issue
2. Contact supplier for replacement
3. Manually deliver correct key
4. Update records

Supplier Out of Stock

1. Wait for restock
2. Use fallback supplier
3. Refund customer
4. Source key manually

Best Practices

1. Monitor daily: Check orders dashboard regularly
2. Handle failures quickly: Don't let failed orders sit
3. Keep mappings current: Update when suppliers change
4. Test regularly: Place test orders periodically
5. Document issues: Track problems for pattern recognition

Order API

Access orders programmatically:

• List orders
• Get order details
• Update order status
• Trigger fulfillment

See API Documentation for details.