Nitromule

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

  1. In WordPress: WooCommerce → Settings → Integration → Nitromule → Credentials.
  2. Generate new REST API keys if the Consumer Key was lost.
  3. Copy Consumer Key, Consumer Secret, Authentication Key, and Store URL.
  4. Paste into Nitromule Stores → WooCommerce matching fields exactly (do not swap Auth Key with Consumer Secret).
  5. Test Connection.

2. HTTPS Store URL

Store URL must be https:// and match the Credentials page. Mismatched www vs apex can fail.

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.