Skip to Content
Getting startedConnect your WooCommerce store

TL;DR

Add your WooCommerce store from Add shop in Orderpiqer, choose guided connection (recommended) or manual credentials, wait for installation to finish, then confirm orders appear in the dashboard.

Only WooCommerce store connections are available today.

Prerequisites

  • An active Orderpiqer account with an available shop slot on your plan (check Settings → Plan & Billing).
  • A live WooCommerce store with the REST API enabled (default in modern WooCommerce).
  • Admin access to your WordPress/WooCommerce site (for guided OAuth or creating API keys).
  • Store URL must be reachable from Orderpiqer (public HTTPS URL; local dev requires extra setup — see developer docs).

Steps

1. Open Add shop

  1. Sign in to Orderpiqer.
  2. Go to Add shop (profile menu + add shop, or /shop/add).
  3. Select WooCommerce as the platform (other platforms are not available yet).

2. Enter store details

  1. Enter a display name for the shop (internal label in Orderpiqer).
  2. Enter your store URL (e.g. https://yourstore.com — use the site root, not /wp-admin).

3. Choose a connection method

Option A — Guided connection (recommended)

  1. Select Guided connection.
  2. Click to start authorization.
  3. Log in to WordPress if prompted and approve Orderpiqer access.
  4. You return to Orderpiqer automatically; installation continues in the background.

Option B — Manual credentials

  1. Select Manual credentials.
  2. In WordPress: WooCommerce → Settings → Advanced → REST API → Add key.
  3. Set permissions to Read/Write, generate keys, copy Consumer key and Consumer secret.
  4. Paste keys into Orderpiqer and submit.

4. Wait for installation

While installing, the page shows progress (validating credentials, provisioning, syncing). Typical steps:

  • Link your user to the shop
  • Register WooCommerce webhooks (orders, products)
  • Initial product and order sync

Do not close the tab until you see installation complete.

5. Confirm in the dashboard

  1. Open Orders — recent WooCommerce orders should appear (may take a few minutes on large catalogs).
  2. Open Products — catalog should match WooCommerce.
  3. Optional: Settings → Webshop — verify store URL and connection status.

Verify it worked

CheckExpected result
Add shop status“Installation complete” on /shop/add
Orders listWoo orders with correct statuses
New Woo orderAppears in Orderpiqer after webhook (or after manual sync)
Settings → WebshopStore URL and platform = WooCommerce

Troubleshooting

SymptomFix
Guided auth fails or returns an errorConfirm store URL is correct HTTPS; retry guided connection; check WordPress login session
“Name and URL required”Fill both shop name and store URL before starting guided setup
Installation fails on currencyWoo Settings → General must have a valid currency; fix in Woo then retry
Plan limit — cannot add shopUpgrade plan or remove an unused shop (Settings → Plan & Billing)
Orders empty after installWait for sync to finish; run order sync from shop settings if available; see Troubleshoot order sync
Connection test fails (manual keys)Regenerate REST API keys with Read/Write; no trailing spaces in URL or keys
Local WordPress (Local WP, Docker)Requires HTTPS dev setup and callback configuration — contact support
Orderpiqer HelpReinstall WooCommerce webhooks