Kinguin
Kinguin is a popular digital marketplace offering game keys, software, and gift cards at competitive prices.
Overview
| Feature |
Details |
| Type |
Marketplace |
| Catalog |
30,000+ products |
| Regions |
Global, EU, US, etc. |
| Platforms |
Steam, Origin, Xbox, PlayStation, etc. |
Prerequisites
- Kinguin API account
- Approved merchant status
- API key generated
Getting API Credentials
- Log in to Kinguin Business
- Go to API Settings
- Generate a new API key
- Copy your API Key
Connecting to PremiumCDKeys
- Go to Manage → Suppliers
- Find Kinguin and click Connect
- Enter your API Key
- Click Connect
Configuration
Webhook Setup
✅ Recommended: Subscribe to the Order Complete webhook for real-time key delivery.
- In Kinguin Business Portal, go to Webhooks
- Add webhook:
- Event: Order Complete
- URL: Provided in PremiumCDKeys settings
- Save
Dispatch Method
Configure how keys are retrieved:
- Immediate: Keys delivered instantly
- Manual: Requires manual dispatch (not recommended for automation)
Product Mapping
Search Products
Search Kinguin's catalog by:
- Product name
- Platform
- Region
- Price range
Product Details
Each Kinguin product shows:
- Current price
- Available stock
- Region restrictions
- Platform requirements
Create Mapping
- Select your store product
- Find matching Kinguin offer
- Click Map
- Configure margin or fixed price
Order Processing
Flow with Webhook
Order → Purchase from Kinguin → Webhook fires → Key received → Deliver
Flow without Webhook
Order → Purchase from Kinguin → Poll for status → Key received → Deliver
Pricing
Kinguin uses dynamic marketplace pricing:
- Prices updated in real-time
- Multiple sellers available
- Lowest price auto-selected (typically)
Price Factors
- Product popularity
- Stock levels
- Regional variations
- Seller competition
Best Practices
- Enable webhooks for fastest key delivery
- Check stock regularly for popular items
- Set reasonable margins accounting for price fluctuations
- Monitor order completion times
Error Handling
| Error |
Meaning |
Action |
| Product Not Found |
ID changed or removed |
Re-map product |
| Insufficient Funds |
Account balance low |
Add funds |
| Out of Stock |
No available sellers |
Wait or use fallback |
| Region Mismatch |
Wrong region selected |
Check mapping |
Regional Products
Kinguin offers region-specific keys:
- Global: Works worldwide
- EU: European Union only
- US: United States only
- Other: Specific country restrictions
⚠️ Always match the region to your customer base to avoid activation issues.
Troubleshooting
Connection Failed
- Verify API key is correct
- Check API key hasn't expired
- Ensure account is in good standing
Webhook Not Firing
- Verify webhook URL is correct
- Check webhook is active in Kinguin
- Test with a manual order
Slow Key Delivery
- Check if webhook is configured
- Some sellers have manual dispatch
- Contact Kinguin for specific order issues
API Information
Endpoints
PremiumCDKeys uses Kinguin's REST API:
- Product catalog
- Order placement
- Order status
- Key retrieval
Rate Limits
- Standard rate limits apply
- Contact Kinguin for increased limits
Support
For Kinguin-specific issues: