Home Data Sources Connections Connect: WooCommerce

Connect: WooCommerce

Last updated on Oct 09, 2025

Setup time: 5-10 minutes

Overview

Connecting WooCommerce to Trackian enables automatic import of your orders, products, and customer data. This integration provides the foundation for tracking your true profitability and understanding your e-commerce performance.

What You'll Need

  • Administrator access to your WordPress/WooCommerce site

  • WooCommerce version 3.0 or higher

  • Your website URL

Step-by-Step Setup Guide

Step 1: Access WooCommerce REST API Settings

  • Log in to your WordPress admin dashboard

  • Navigate to: WooCommerce > Settings

  • Click on the Advanced tab

  • Select REST API from the submenu

Step 2: Create API Keys

  • Click "Add Key" button

  • You'll be taken to the Key Details screen

Step 3: Configure Key Details

Fill in the following information:

Description:

  • Enter a descriptive name (e.g., "Trackian Integration")

  • This helps you identify the key later

User:

  • Select the user to generate the key for

  • Choose an administrator account for full access

Permissions:

  • Select "Read" access only

  • Trackian never needs write permissions

Step 4: Generate Your API Keys

  • Click "Generate API Key"

  • WooCommerce will create the credentials

Important: You'll now see:

  • Consumer Key (starts with ck_)

  • Consumer Secret (starts with cs_)

  • A QR code for mobile access

  • A "Revoke Key" button

⚠️ Copy both keys immediately! Once you leave this page, the Consumer Secret will be hidden for security.

Step 5: Connect to Trackian

In your Trackian dashboard:

  • Go to Projects. Click on your project name. Navigate to Data Sources.

  • Select "WooCommerce"

  • Enter your credentials:

    • Consumer Key: The key starting with ck_

    • Consumer Secret: The secret starting with cs_

    • Shop Name: Your full domain

      • For https://example.com, enter example.com

      • Include the full domain without https://

  • Click "Connect" and then "Save"

Step 6: Verify Connection

After connecting:

  • You'll see a green "Connected" status

  • Historical data extraction begins immediately

  • Full data import completes within 24-48 hours

Important Configuration Notes

SSL Requirement

Your WooCommerce site must have SSL (https://) enabled for API connections to work securely.

Permalink Settings

Ensure pretty permalinks are enabled:

  • Go to Settings > Permalinks

  • Select any option except "Plain"

  • Save changes

Firewall and Security Plugins

If using security plugins (Wordfence, Sucuri, etc.), ensure they're not blocking API access:

  • Whitelist Trackian's IP addresses (contact support for list)

  • Allow REST API access

Troubleshooting

"Consumer key is invalid"

  • Verify you copied the entire key

  • Check for extra spaces or characters

  • Ensure the key hasn't been revoked

"Cannot connect to store"

  • Verify your site is accessible (not in maintenance mode)

  • Check SSL certificate is valid

  • Ensure REST API is enabled

"Authentication error"

  • Confirm you selected "Read" permissions

  • Verify the user account is still active

  • Check if the API keys were accidentally revoked

Shop name format issues

  • Use your actual domain: yourdomain.com

  • Don't include: https://, www., or trailing slashes

  • For subdomains: include full subdomain (e.g., shop.yourdomain.com)

WooCommerce-Specific Data

Once connected, Trackian will import:

  • Order history and statuses

  • Product catalog and variations

  • Customer information

  • Payment methods used

  • Shipping details

  • Refunds and cancellations

  • Tax information

COGS Setup for WooCommerce

After connecting, you'll need to set up your Cost of Goods Sold:

  1. Contact support@trackian.com for guidance on exporting your product costs

  2. We'll help you format the CSV correctly for import

  3. Upload your COGS data to start seeing true profit margins

Security Best Practices

  • Only create read-only API keys

  • Regularly review active API keys in WooCommerce

  • Revoke unused keys immediately

  • Use strong passwords for accounts with API access

  • Keep WooCommerce and WordPress updated

Common Integration Scenarios

Multiple Currencies

If your store uses multiple currencies, Trackian will convert everything to your primary currency for unified reporting.

Custom Order Statuses

Trackian recognizes standard WooCommerce order statuses. Contact support if you use custom statuses that need mapping.

What Happens Next

Once connected, Trackian will:

  1. Import your complete product catalog

  2. Sync historical orders

  3. Pull customer data for analytics

  4. Set up daily automatic syncs

  5. Prepare data for profit calculations (once COGS are added)

Need Help?

If you encounter any issues during setup, contact us at support@trackian.com with:

  • Your domain name

  • WooCommerce version

  • The error message (if any)

  • Step where you're experiencing issues