WooCommerceIntegration Guide

WooCommerce Integration Setup

Connect your WooCommerce store to WarpWare by generating a REST API key. No app installs, no plugins — just a key pair from your WordPress admin.

What We Need From You

To connect your WooCommerce store, we just need two things:

Your Store URL

The WordPress site URL where WooCommerce is installed.

REST API Key Pair

A Consumer Key and Consumer Secret generated from WooCommerce settings.

Estimated time: 5 minutes — no plugins or app installs required.

Before You Start

Your site must have an SSL certificate (HTTPS). WooCommerce REST API requires it for key-based auth.
You need WordPress admin access (or a role with WooCommerce settings permission).
WooCommerce must be installed and activated on your WordPress site.
REST API Key Setup

Step-by-Step Setup

1

Open WooCommerce REST API Settings

Log into your WordPress admin dashboard and navigate to:

WooCommerceSettingsAdvancedREST API

Click the Add key button (or Create an API key on newer versions).

2

Configure the API key

Fill in the key details:

Description
Enter a name like WarpWare Integration so you can identify it later.
User
Select your admin user account (or a dedicated service account).
Permissions
Set to Read/Write — the only option that allows WarpWare to both pull orders/products and push fulfillments, inventory, and webhook registrations.
About WooCommerce permissions: WooCommerce doesn't offer per-resource scopes (like read_orders, write_products, etc.). It has three global levels: Read, Write, or Read/Write — applied to the whole REST API. WarpWare requires Read/Write.
What WarpWare calls on your store (WooCommerce REST API v3):
• GET /wc/v3/orders — pull orders
• PUT /wc/v3/orders/{id} — update status
• GET /wc/v3/products — sync catalog
• PUT /wc/v3/products/{id} — inventory sync
• GET /wc/v3/products/{id}/variations
• POST /wc/v3/webhooks — auto-register webhooks
Tip: Creating a dedicated WordPress user for WarpWare (e.g. warpware-api) makes it easy to revoke access later without affecting other users.
3

Generate and copy your keys

Click Generate API key. WooCommerce will display your credentials:

Consumer Key
ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Consumer Secret
cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
The Consumer Secret is only shown once. Copy both keys immediately and send them to us, or store them somewhere safe. If you lose the secret, you'll need to generate a new key pair.
4

Send your credentials to WarpWare

Send us the following:

Your store URL (e.g. https://your-store.com)
Consumer Key (starts with ck_)
Consumer Secret (starts with cs_)
Security: Send credentials via a secure channel. Email us at [email protected] or through your existing support thread. All credentials are AES-256 encrypted at rest in WarpWare.
5

We bridge the connection

On our end, we go to Integrations → Add WooCommerce and enter your store URL, Consumer Key, and Consumer Secret.

WarpWare verifies the connection and begins syncing:

Orders
Pull new and updated orders
Products
Sync product catalog and variants
Inventory
Two-way stock level sync
Fulfillments
Push tracking numbers and status
6

You're connected

Once verified, we'll notify you that the integration is live. Orders will start flowing into WarpWare automatically. You can manage or revoke the API key at any time from:

WooCommerceSettingsAdvancedREST API

Just click the Revoke button next to the WarpWare key to disconnect instantly.

Frequently Asked Questions

Does WooCommerce need any plugins for this?
No. The REST API is built into WooCommerce core (version 3.5+). No plugins or extensions are required — just generate a key from the settings page.
What permissions does WarpWare need?
Read/Write. WooCommerce offers three global permission levels (Read, Write, or Read/Write) — there are no per-resource scopes. Read/Write is required so WarpWare can pull orders and products, push fulfillment updates and tracking numbers, sync inventory two-way, and register webhooks programmatically.
Does my site need HTTPS?
Yes. WooCommerce requires SSL (HTTPS) for REST API key-based authentication. If your site doesn't have SSL, most hosts offer free certificates through Let's Encrypt.
Can I connect multiple WooCommerce stores?
Yes — each store gets its own API key pair and isolated connection in WarpWare, with independent sync settings and audit trails.
Is my data secure?
All API keys are AES-256 encrypted at rest and transmitted over TLS 1.3. WarpWare never stores your WordPress admin password. The REST API key can be revoked at any time from your WooCommerce settings.
What WooCommerce version is required?
WooCommerce 5.0 or later (tested with 8.x). WarpWare uses the WooCommerce REST API v3, which is stable across all modern releases. Older versions may work but are not supported — we recommend keeping WooCommerce updated.
Can I revoke access later?
Yes. Go to WooCommerce → Settings → Advanced → REST API and click Revoke next to the WarpWare key. This immediately stops all API access without affecting your store.

Need help with setup?

Contact Support