Suppliers Overview

Suppliers are the source of your game keys. PremiumCDKeys connects to multiple suppliers, allowing you to offer a wide range of products while automating the procurement process.

Available Suppliers

Supplier Type Catalog Size API
CodesWholesale B2B Distributor 10,000+ REST
G2A Marketplace 50,000+ REST
Kinguin Marketplace 30,000+ REST
Gamivo Marketplace 25,000+ REST
PrepaidForge Gift Cards 5,000+ REST
Key Storage Self-managed Unlimited N/A

How Suppliers Work

┌──────────────┐     ┌──────────────────┐     ┌──────────────┐
│  Your Order  │────▶│  PremiumCDKeys   │────▶│   Supplier   │
│              │     │  (finds best     │     │   (delivers  │
│              │◀────│   price/stock)   │◀────│    key)      │
└──────────────┘     └──────────────────┘     └──────────────┘
  1. Order Received: Customer places order in your store
  2. Supplier Selection: PremiumCDKeys checks mapped suppliers
  3. Key Purchase: Automatically purchases from supplier API
  4. Key Delivery: Key is delivered to your customer

Connecting a Supplier

  1. Go to ManageSuppliers
  2. Click Connect next to your chosen supplier
  3. Enter your API credentials
  4. Test the connection
  5. Start mapping products

Supplier Priority

When multiple suppliers have the same product, PremiumCDKeys uses:

  1. Primary Mapping: The supplier explicitly mapped to the product
  2. Fallback Suppliers: Alternative suppliers if primary is out of stock
  3. Price Comparison: Optionally choose the cheapest available

API Credentials

Each supplier requires different credentials:

Supplier Required Credentials
CodesWholesale Client ID, Client Secret
G2A API Key, API Secret
Kinguin API Key
Gamivo API Key, Secret
PrepaidForge API Key, IP Whitelist
Key Storage None (managed internally)

Important Notes

IP Whitelisting

Some suppliers require you to whitelist the PremiumCDKeys IP address:

IP: [Contact support for current IP]

Webhooks

Some suppliers support webhooks for order status updates:

  • Kinguin: Subscribe to Order Complete webhook
  • Others: PremiumCDKeys polls for updates

PayPal Warning

⚠️ G2A: Never connect your personal PayPal account to G2A through PremiumCDKeys. Use G2A Balance or other payment methods.

Managing Stock

Automatic Stock Checking

PremiumCDKeys automatically checks stock:

  • Before processing orders
  • During product mapping
  • On scheduled intervals

Out of Stock Handling

When a supplier is out of stock:

  1. Order is marked as Pending Stock
  2. Fallback supplier is checked (if configured)
  3. You're notified to take manual action

Cost Tracking

Track your spending per supplier:

  • Go to Dashboard to see "Spent at Supplier"
  • View detailed reports in Orders
  • Calculate margins per product

Next Steps


Powered by Converge