Goal: Set up the WooCommerce REST API connection that lets Altera read your products, customers, orders, and coupons for a migration to Shopify.
Prerequisites:
You have Altera installed on your destination Shopify store
Admin access to your WooCommerce site
The WooCommerce site is reachable from the public internet (not behind a VPN, IP allowlist, or HTTP basic auth). If your host restricts inbound traffic by IP, allowlist
34.182.181.120- Altera's outbound IP for all migration and remote-connection trafficWordPress permalinks are set to anything other than Plain (under Settings > Permalinks)
Step 1 - Open WooCommerce REST API settings
In your WordPress admin, go to WooCommerce > Settings > Advanced > REST API.
Step 2 - Add a new key
Click Add key, then fill in:
Description:
Altera migration(any name is fine)User: an admin user
Permissions: Read (Altera never writes to your WooCommerce site, so read access is enough)
Click Generate API key.
Step 3 - Copy the consumer key and secret
WooCommerce shows the Consumer key (starts with ck_) and Consumer secret (starts with cs_) on the confirmation page. Copy both. You won't be able to view the secret again later - if you lose it you'll need to generate a new key.
Step 4 - Open the migrations page in Altera
In your Shopify admin, open Altera and click Migrations in the left sidebar. On the WooCommerce tab, you'll see fields for Site URL, Consumer key, and Consumer secret.
Step 5 - Paste your credentials
Paste your WooCommerce site URL (e.g. https://yourstore.com), the consumer key, and the consumer secret into the matching fields. (If you have WooCommerce's combined URL with the credentials embedded, pasting it into Site URL will auto-fill the key and secret.) Click Connect.
Step 6 - Confirm the connection test passes
Altera tests the connection immediately. If it succeeds, you're taken to the migration's detail page and the migration shows product and order counts pulled from WooCommerce. If it fails, the page shows a banner with an error code (e.g. WOO003 - Invalid API credentials) and a Learn more link. Fix the issue at the source, then click Test connection in the More actions menu to retry.
Outcome
You have a working WooCommerce connection saved in Altera, and you can run as many migrations against it as you need from the migration's detail page.
Next Steps
Tutorial: Migrate WooCommerce to Shopify walks through pulling data and importing it.
The error codes documentation explains every connection error in detail.