WooCommerce Integration

Connecting WooCommerce

Before you start

• Your store must be served over HTTPS.
• You need to log in to WordPress as an administrator or shop manager.

Connect your store

1. Go to Integrations and click WooCommerce
2. Enter your store address, for example yourstore.com. If WooCommerce is installed in a folder, include it (yourstore.com/shop)
3. Click Connect with WooCommerce. You'll be sent to your WordPress admin (log in if asked)
4. WooCommerce asks you to approve Shopimize. Click Approve
5. You're sent back to Shopimize and the import starts automatically

Approving creates an API key named "Shopimize" that you can revoke at any time in WooCommerce → Settings → Advanced → REST API. The approval screen shows Read/Write access: Shopimize only reads your orders, refunds, products and settings. Write access is used for one thing: adding webhooks named "Shopimize" (WooCommerce → Settings → Advanced → Webhooks) so new orders, refunds and product changes reach Shopimize within minutes.

What gets imported

• Your most recent orders straight away, then your full history in the background
• Refunds (including partial refunds per product), cancellations and status changes
• Products and variations, with their costs if WooCommerce has them: the built-in Cost of Goods field (WooCommerce 10.3+) or the Cost of Goods plugin. Each order uses the cost WooCommerce recorded when it was placed; costs read from WooCommerce show a WooCommerce badge in Costs → Product Costs, where you can also enter or correct costs
• Payment fees recorded by WooPayments, the WooCommerce Stripe plugin and PayPal Payments. If a Stripe payment has no fee on the order and your Stripe account is connected in Shopimize, the real fee is read from Stripe. Otherwise your fee rules apply, or an estimate at the standard rate for your currency
• Order attribution (UTM campaign, referrer, landing page) from WooCommerce's built-in Order Attribution. Ad clicks without UTM tags are recognised from their click ID (Google, Microsoft Ads, TikTok, Facebook/Instagram)

Orders in other currencies

If your store sells in several currencies (WooPayments multi-currency, Aelia Currency Switcher, FOX/WOOCS or another plugin), every order is converted into your store currency, so totals and profit add up. Shopimize uses the exchange rate the plugin recorded on the order, or the European Central Bank reference rate of the order date. The currency the customer paid in and the rate used are kept with the order.

How fast changes arrive

Changes reach Shopimize through the webhooks within a few minutes. WooCommerce sends webhooks from its scheduled-actions queue, which on quiet sites only runs when someone visits, so a delivery can occasionally take longer. Shopimize also checks for changes every hour as a safety net, and every 15 minutes if the webhooks couldn't be added.

Failed, pending-payment, draft and trashed orders are never counted as sales.

Connect with API keys instead

Some hosts block the request WooCommerce makes back to Shopimize after you approve. In that case:

1. In WordPress, go to WooCommerce → Settings → Advanced → REST API and click Add key
2. Description: Shopimize — User: an administrator — Permissions: Read/Write
3. Click Generate API key and copy the consumer key and consumer secret
4. In Shopimize, open Integrations → WooCommerce, click Connect with API keys instead and paste them

Common issues

"We couldn't reach your store" — check the address loads over HTTPS without a browser warning.

"A security, firewall or caching layer blocked our request" — plugins such as Wordfence, iThemes Security or a Cloudflare rule can block the REST API. Allow requests to /wp-json/wc/, then try again.

"The key is valid but can't read orders" — the key must have Read or Read/Write permission and belong to an administrator or shop manager.

"WooCommerce isn't active on this site" — WooCommerce must be activated, and its REST API must not be disabled by another plugin.

Changes take up to 15 minutes to appear — the webhooks couldn't be added: the API key only has Read permission, or a security plugin blocks webhook requests. Reconnect with Read/Write access. If a Shopimize webhook shows as Disabled in WooCommerce → Settings → Advanced → Webhooks, Shopimize re-activates it within a few hours.

If none of those fix it, contact support at hello@shopimize.com with your store URL.