Connecting WooCommerce

Overview

The WooCommerce integration connects invisor directly to your WordPress store's WooCommerce REST API. Once connected, invisor syncs order and revenue data so you can see your store performance alongside your marketing channels.

What data is synced

• Orders – order count, order status breakdown
• Revenue – gross and net revenue
• Average Order Value (AOV)
• Products – top products by revenue and quantity sold
• Customers – new vs returning customers
• Customer Lifetime Value (CLV)
• Returning customer rate
• Refunds – refund amounts and rates

WooCommerce data is synced on a 1-day rolling window for incremental updates.

Before you begin

You'll need:

• A WooCommerce store running on WordPress
• WooCommerce version 3.5 or later
• Admin access to your WordPress dashboard
• Your store must be accessible over HTTPS

Step 1 – Create WooCommerce API credentials

1. Log in to your WordPress admin (yoursite.com/wp-admin).
2. Go to WooCommerce → Settings → Advanced → REST API.
3. Click Add key.
4. Fill in the details:

• Description: invisor
• User: select a WordPress admin user
• Permissions: Read

1. Click Generate API Key.
2. Copy both the Consumer Key (ck_...) and Consumer Secret (cs_...) — they are only shown once.

Step 2 – Connect in invisor

1. Go to Settings → Channels in invisor.
2. Click Connect on the WooCommerce card.
3. Enter your store URL (e.g. https://yourstore.com). Include https:// and do not include a trailing slash.
4. Paste the Consumer Key and Consumer Secret.
5. Click Connect.

invisor will verify the credentials and begin the first sync immediately. Historical data for the past 3 days is backfilled on first connection.

Permalink settings

The WooCommerce REST API requires pretty permalinks to be enabled. In WordPress, go to Settings → Permalinks and choose any option other than Plain. Click Save Changes to apply.

Multisite and subdirectory installs

If your WordPress store is installed in a subdirectory (e.g. yoursite.com/shop), enter the full store URL including the subdirectory path when connecting.

Troubleshooting

"401 Unauthorised" error

This means the Consumer Key and Secret are incorrect or have been revoked. Return to WooCommerce → Settings → Advanced → REST API, delete the existing key, and generate a new one.

"SSL certificate" error

The WooCommerce REST API requires HTTPS. If your store uses an invalid or self-signed SSL certificate, the connection will fail. Ensure your SSL certificate is valid and issued by a trusted certificate authority.

No orders appearing

Check that the API key has Read permissions and that orders exist in the selected date range. Also confirm that pretty permalinks are enabled (see above).

Connection times out

This may indicate a firewall or server security plugin (e.g. Wordfence) is blocking requests from invisor's IP addresses. Add invisor's IP range to your allowlist, or temporarily disable the security plugin to test the connection.

curl -X GET "https://yourstore.com/wp-json/wc/v3/orders" \
  -u ck_your_consumer_key:cs_your_consumer_secret