Troubleshoot your WooCommerce connection
Updated 2026-09-07
On this page
Most WooCommerce connection failures are bad credentials, Plain permalinks, or a firewall blocking /wp-json/. Work the list in order.
Symptom
- Test Connection fails
- Sync returns authentication or network errors
- Orders stop importing
- Checkout rates missing on the storefront
Fixes (in order)
1. Credentials
- In WordPress: WooCommerce → Settings → Integration → Nitromule → Credentials.
- Generate new REST API keys if the Consumer Key was lost.
- Copy Consumer Key, Consumer Secret, Authentication Key, and Store URL.
- Paste into Nitromule Stores → WooCommerce matching fields exactly (do not swap Auth Key with Consumer Secret).
- Test Connection.
2. HTTPS Store URL
Store URL must be https:// and match the Credentials page. Mismatched www vs apex can fail.
3. Permalinks
Settings → Permalinks → anything except Plain → Save.
Quick check: open https://your-store/wp-json/ — you should see JSON, not the shop homepage.
4. Plugin active
Nitromule for WooCommerce must be installed and activated. WooCommerce must be active.
5. Firewall / WAF
Allowlist HTTPS to /wp-json/nitromule/v1/ (and Woo REST if used). Corporate WAFs often block unknown User-Agents.
6. SSL
Fix invalid certificates; then Test Connection again.
Checkout rates specifically
See Live checkout rates for WooCommerce. Confirm:
- US selling locations
- Shipping zones include Nitromule Rates
- Checkout Rates enabled on the Nitromule store card
- Customer address is in the United States
Orders import but look wrong
- Adjust Export Order Statuses on the plugin integration page
- Sync again and open Orders
- Create Label from the imported order so tracking can sync
Still failing?
Full connect guide: Connect WooCommerce. Error catalog: common errors.