WooCommerce Integration

Connect your WooCommerce store to automate game key fulfillment.

Requirements

  • WordPress 5.0 or higher
  • WooCommerce 5.0 or higher
  • SSL certificate (HTTPS required)
  • REST API enabled

Step 1: Generate API Keys

  1. In your WordPress admin, go to WooCommerceSettingsAdvancedREST API
  2. Click Add Key
  3. Fill in the details:
    • Description: PremiumCDKeys Integration
    • User: Select an admin user
    • Permissions: Read/Write
  4. Click Generate API Key
  5. Copy both keys (Consumer Key and Consumer Secret) - you'll need these

⚠️ Important: The Consumer Secret is only shown once. Save it securely.

Step 2: Connect to PremiumCDKeys

  1. In PremiumCDKeys, go to Dashboard
  2. Click Connect ApplicationWooCommerce
  3. Enter your store details:
    • Store URL: https://yourgamestore.com
    • Consumer Key: Paste from Step 1
    • Consumer Secret: Paste from Step 1
  4. Click Connect

Step 3: Configure Webhooks

Webhooks notify PremiumCDKeys of new orders in real-time.

Automatic Setup

PremiumCDKeys can automatically create the required webhooks. Click Setup Webhooks in your application settings.

Manual Setup

If automatic setup fails:

  1. Go to WooCommerceSettingsAdvancedWebhooks
  2. Add a new webhook:
    • Name: PremiumCDKeys Order Created
    • Status: Active
    • Topic: Order created
    • Delivery URL: https://premiumcdkeys.com/api/webhook/woocommerce/{your-shop-id}
    • Secret: Copy from PremiumCDKeys settings
  3. Save the webhook

Step 4: Test the Connection

  1. In PremiumCDKeys, go to your WooCommerce application
  2. Click Browse Orders
  3. You should see your recent WooCommerce orders

Order Processing

Automatic Mode

Enable automatic processing in Control settings:

New Order → Auto-detect → Purchase Key → Deliver to Customer

Manual Mode

Process orders manually:

  1. Go to Orders
  2. Select pending orders
  3. Click Process Selected

Product Sync

PremiumCDKeys syncs your WooCommerce products for mapping:

  • Product names and SKUs
  • Variations (if applicable)
  • Stock status

Products are refreshed automatically or manually via Sync Products.

Troubleshooting

Connection Failed

  • Verify your API keys are correct
  • Ensure REST API is enabled
  • Check that your site uses HTTPS

Orders Not Syncing

  • Verify webhooks are active in WooCommerce
  • Check webhook delivery URL is correct
  • Review webhook logs for errors

Products Not Appearing

  • Click Sync Products to force a refresh
  • Ensure products are published (not draft)
  • Check product visibility settings

Best Practices

  1. Use a dedicated API user for PremiumCDKeys
  2. Keep webhooks active for real-time order processing
  3. Test with small orders before going live
  4. Monitor order status regularly

Next Steps


Powered by Converge