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, you must disconnect or replace it before WooCommerce becomes the active commerce platform
• Once a real commerce platform is connected, the workspace leaves demo mode

What Data Does MerchantFlow Sync from WooCommerce?

The WooCommerce connection powers:

• Products -- SKUs, variants, pricing, and inventory
• Orders -- revenue, refunds, and transaction details
• Commerce-side syncs -- all store data needed for downstream analytics
• Profitability and reporting views -- dashboards and reports that depend on store data

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.

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: March 14, 2026