Account and environment
- You need a WordPress site with WooCommerce active and administrator access.
- No separate WooCommerce developer account is required.
- In WordPress Admin → Settings → Permalinks, save any option other than Plain; Post name is recommended.
- Confirm that the store base URL has a valid HTTPS certificate and is publicly reachable.
Issue Consumer Key/Secret
- Sign in to the WooCommerce store's WordPress admin.
- Open WooCommerce → Settings → Advanced → REST API.
- Select Create an API key or Add key.
- Enter a recognizable description such as 'ORCA order integration'.
- Choose an administrator or dedicated integration user that will remain active.
- Set Permissions to Read.
- Generate the key, then immediately copy the ck_ Consumer Key and cs_ Consumer Secret. The Consumer Secret is displayed only once.
Register in ORCA
- Open ORCA → Integration Management → Sales Channels.
- Choose Add sales channel → WooCommerce.
- Enter a recognizable store name as the channel name.
- Enter the HTTPS store base URL without /wp-admin or /wp-json, for example https://shop.example.com.
- Enter the Consumer Key and Consumer Secret copied from WooCommerce.
- Run the connection test and save after it succeeds.
ORCA Sales Channel Management →
Security and troubleshooting
- Use the current WordPress REST API key, not a Legacy REST API key.
- For 401 or 403, check the Key/Secret, integration user status, and Read permission.
- For 404, check that Permalinks is not Plain and verify /wp-json/wc/v3 on the site.
- For SSL errors, check the HTTPS certificate expiry and certificate chain.
- A lost Consumer Secret cannot be recovered; revoke the pair and generate a replacement.