Product Mapping
Product Mapping connects your store products to supplier offers. When a customer buys a product, PremiumCDKeys knows exactly which key to purchase from which supplier.
How Mapping Works
Your Store Product Supplier Offer
┌────────────────┐ ┌─────────────────────┐
│ FIFA 24 PC Key │ ──────▶ │ FIFA 24 - Steam EU │
│ (SKU: F24) │ │ (CodesWholesale) │
└────────────────┘ └─────────────────────┘
Each mapping tells PremiumCDKeys:
- Which product in your store
- Which supplier to purchase from
- Which offer from that supplier
- What price/margin to use
Accessing Product Mapping
- Go to your connected application
- Click Product Import in the sidebar
- View all mappings or create new ones
Creating a Mapping
Step 1: Select Store Product
- Click Add Mapping
- Browse or search your store products
- Select the product to map
Step 2: Find Supplier Offer
- Search supplier catalogs
- Use filters:
- Platform (Steam, Origin, etc.)
- Region (EU, US, Global)
- Price range
- Select the matching offer
Step 3: Configure Pricing
Choose your pricing strategy:
Fixed Price
Set a specific selling price:
Supplier Cost: €20.00
Your Price: €24.99
Profit: €4.99
Margin Percentage
Set a profit margin:
Supplier Cost: €20.00
Margin: 25%
Your Price: €25.00
Profit: €5.00
Dynamic Pricing
Follow supplier price changes:
Supplier Cost: Changes
Your Price: Cost + Margin
Profit: Consistent %
Step 4: Save
Click Save Mapping to activate.
Mapping Options
Priority
Set fulfillment priority:
| Priority |
Behavior |
| 1 (High) |
Try this supplier first |
| 2 |
Use as second choice |
| 3 (Low) |
Last resort fallback |
Fallback Suppliers
Configure backup suppliers:
- Primary: CodesWholesale
- Fallback 1: G2A
- Fallback 2: Key Storage
If primary is out of stock, system tries fallbacks.
Stock Threshold
Set minimum stock alerts:
- Alert when stock drops below threshold
- Pause mapping when critically low
Viewing Mappings
List View
See all mappings in a table:
- Product name
- Supplier
- Status
- Stock
- Price/Margin
Mapping Details
Click a mapping to see:
- Complete configuration
- Price history
- Order count
- Stock levels
Editing Mappings
- Find the mapping
- Click Edit
- Modify settings
- Save changes
Changes take effect immediately for new orders.
Deleting Mappings
- Select mapping(s)
- Click Delete
- Confirm
⚠️ Deleting a mapping stops automatic fulfillment for that product.
Bulk Operations
Import Mappings
Import multiple mappings via CSV:
store_product_id,supplier,offer_id,margin
123,codeswholesale,CW-12345,25
124,g2a,G2A-67890,20
Export Mappings
Export current mappings:
- Go to Product Import
- Click Export
- Download CSV
Bulk Edit
Select multiple mappings to:
- Change margin
- Update supplier
- Enable/disable
Stock Management
Real-time Stock
PremiumCDKeys checks stock:
- Before order processing
- During catalog browsing
- On scheduled intervals
Stock Indicators
| Indicator |
Meaning |
| 🟢 In Stock |
Available |
| 🟡 Low Stock |
Below threshold |
| 🔴 Out of Stock |
Unavailable |
Out of Stock Behavior
Configure what happens when out of stock:
- Wait: Hold order until restocked
- Fallback: Try next supplier
- Notify: Alert admin for manual handling
Price Synchronization
Manual Sync
Click Sync Prices to update:
- Supplier prices
- Stock levels
- Product availability
Automatic Sync
Enable scheduled syncing:
- Hourly, daily, or custom
- Updates all active mappings
Best Practices
1. Match Products Carefully
Ensure exact match:
- Same game/software
- Correct edition (Standard, Deluxe, etc.)
- Right region
- Correct platform
2. Set Reasonable Margins
Consider:
- Market prices
- Competition
- Supplier reliability
- Volume discounts
3. Configure Fallbacks
Always have backup suppliers:
- Prevents stockouts
- Maintains customer satisfaction
- Diversifies risk
4. Monitor Stock
Regular checks prevent:
- Failed orders
- Customer complaints
- Revenue loss
5. Update Regularly
Review mappings when:
- Suppliers change prices
- Products are updated
- New editions release
Troubleshooting
Mapping Not Working
- Verify mapping is active
- Check supplier connection
- Confirm product IDs match
Wrong Product Delivered
- Review mapping configuration
- Check region/edition
- Verify supplier offer details
Price Mismatch
- Sync prices manually
- Check margin calculation
- Verify currency settings
Stock Shows 0
- Check supplier API status
- Verify product is still available
- Try manual stock refresh