Connect WooCommerce — MerchantFlow

Connect WooCommerce to MerchantFlow

The WooCommerce integration connects your WooCommerce store to MerchantFlow using your store URL and read-only REST API credentials. Once connected, MerchantFlow syncs your products, orders, and commerce data for profitability analysis, P&L tracking, and business reporting.

What Is the WooCommerce Integration?

MerchantFlow's WooCommerce integration uses the WooCommerce REST API to pull product and order data into your MerchantFlow workspace. Unlike the Shopify integration which uses OAuth, WooCommerce requires a consumer key and consumer secret generated from your WooCommerce settings.

What You Need

Before connecting, gather the following:

• MerchantFlow owner or admin access (check your role)
• An HTTPS-enabled WooCommerce store
• A WooCommerce consumer key with read access
• A WooCommerce consumer secret with read access

You can generate API credentials in your WooCommerce dashboard under WooCommerce > Settings > Advanced > REST API.

How to Connect WooCommerce

1. Open /onboarding/commerce or navigate to Settings > Integrations
2. Choose WooCommerce
3. Enter the store URL, consumer key, and consumer secret
4. Save the connection

MerchantFlow normalizes the store URL and stores the credentials for future product and order syncs. Your first sync begins automatically.

Important Platform Rules

• MerchantFlow supports one primary commerce platform per merchant tenant
• If Shopify is already connected, saving WooCommerce returns Disconnect Shopify before connecting WooCommerce. MerchantFlow then offers a confirmation prompt that replaces the Shopify connection in place -- confirming it deletes the stored Shopify credential
• Once a real commerce platform is connected, the workspace leaves demo mode

What Data Does MerchantFlow Sync from WooCommerce?

The WooCommerce connection powers:

• Products -- product name, SKU, effective price, regular and sale price, and the primary product image
• Product cost -- read from the first product meta field it finds among _cost, _alg_wc_cog_cost, _wc_cog_cost, and cost_price, so the common cost-of-goods plugins are picked up automatically
• Orders -- revenue, refunds, line items, payment method, and order attribution meta
• Profitability and reporting views -- dashboards and reports that depend on store data

Unlike Shopify, the WooCommerce sync does not pull per-variant rows or live inventory levels. Products are synced at the parent-product level.

All access is read-only. MerchantFlow never modifies your WooCommerce store.

Troubleshooting WooCommerce Connection Issues

If the connection fails:

• Confirm the store URL is correct, reachable, and uses HTTPS
• Confirm the consumer key and consumer secret are valid and have read access
• Confirm you are not trying to keep Shopify connected to the same merchant tenant -- only one commerce platform is allowed at a time
• See Troubleshooting Integrations for additional diagnostic steps

Frequently Asked Questions

Does WooCommerce require OAuth like Shopify?

No. WooCommerce uses REST API credentials (consumer key and consumer secret) instead of an OAuth redirect flow. You generate these credentials directly in your WooCommerce admin panel.

WooCommerce is also the one connect path that does not enforce MerchantFlow's email-verification and two-factor prerequisites -- it checks only the integrations:manage permission. This is specific to the WooCommerce endpoint, not a general property of credential-based integrations: the fulfillment providers are connected with pasted API keys and do enforce both checks.

Can I connect WooCommerce and Shopify at the same time?

No. MerchantFlow supports one primary commerce platform per merchant tenant. You must disconnect one before connecting the other.

What WooCommerce permissions does MerchantFlow need?

MerchantFlow requires read-only API access. When generating your consumer key, select "Read" permissions. MerchantFlow never writes data back to your WooCommerce store.

Related Guides

• Connect Integrations -- full onboarding walkthrough
• Shopify -- alternative commerce platform
• Data Security -- how MerchantFlow protects your credentials
• Sync Troubleshooting -- fix sync issues

---

Last updated: August 29, 2026