Shopify Integration

Connect your Shopify store to automate game key fulfillment.

Requirements

  • Active Shopify store
  • Shopify Basic plan or higher
  • Store owner or staff account with full permissions

Step 1: Install the App

  1. In PremiumCDKeys, go to Dashboard
  2. Click Connect ApplicationShopify
  3. Enter your Shopify store domain (e.g., your-store.myshopify.com)
  4. Click Connect
  5. You'll be redirected to Shopify to authorize the app

Step 2: Authorize Permissions

The PremiumCDKeys app requires the following permissions:

Permission Purpose
Read orders Sync orders to PremiumCDKeys
Write orders Update order status and add notes
Read products Sync products for mapping
Read customers Access customer email for key delivery

Click Install App to grant these permissions.

Step 3: Configure Settings

After installation, configure your integration:

  1. Go to your Shopify application in PremiumCDKeys
  2. Navigate to Control
  3. Enable/disable features:
    • Auto-process orders
    • Send customer notifications
    • Enable download page

Order Processing

How Orders Flow

Shopify Order → Webhook → PremiumCDKeys → Supplier → Key Delivery

Order Statuses

Shopify Status PremiumCDKeys Action
Paid Triggers key fulfillment
Partially Paid Waits for full payment
Refunded Cancels processing

Fulfillment

When a key is delivered:

  1. Order is marked as Fulfilled in Shopify
  2. Customer receives email with key
  3. Download page link is added to order

Product Sync

Products are automatically synced from your Shopify store:

  • Product titles
  • Variants
  • SKUs
  • Inventory status

Refresh Products

To manually refresh your product list:

  1. Go to your Shopify application
  2. Click Sync Products

Digital Products Setup

For best results with digital game keys:

1. Create a Digital Product

  • Uncheck This is a physical product
  • Set Track quantity to disabled (PremiumCDKeys manages stock)

2. Set Product Type

Use clear product types:

  • Game Key
  • Digital Code
  • Gift Card

3. Add SKU

Add a unique SKU that matches your supplier's product identifier for easy mapping.

Troubleshooting

App Not Installing

  • Ensure you're logged in as store owner or admin
  • Check that your Shopify plan supports apps
  • Clear browser cache and try again

Orders Not Appearing

  • Verify the order is marked as Paid
  • Check that webhooks are registered (see app settings)
  • Wait a few minutes for sync

Fulfillment Not Updating

  • Check PremiumCDKeys order status
  • Verify API permissions are still valid
  • Re-authorize the app if needed

Webhooks

PremiumCDKeys automatically registers these webhooks:

Webhook Purpose
orders/create Detect new orders
orders/updated Track payment status
orders/cancelled Cancel pending fulfillment
products/update Keep product list current

Best Practices

  1. Use consistent SKUs across Shopify and your mappings
  2. Test with draft orders before going live
  3. Enable email notifications for customer assurance
  4. Monitor the orders dashboard for any issues

Next Steps


Powered by Converge