WooCommerce: Troubleshooting


  • This article outlines some of the common errors you could experience while using the Starshipit/WooCommerce integration, and how to resolve them.
  • Read more information about how to integrate with WooCommerce.

Error: Unsuccessful - The remote server returned an error: (400) Bad Request.

If you test the connection and get this error, you may need to enable permalinks. To do this:

  1. In your WooCommerce account, select Settings, then select Permalinks.
  2. Under Common Settings, select Post name.
  3. Click Save changes.
  4. In your Starshipit account, go to Settings, then select Integrations.
  5. Select Settings next to WooCommerce.
  6. Scroll down and click Test to ensure it works.

You should get a successful result. If you continue to receive an error, please contact our support team.

Error when importing WooCommerce orders

If you get an Unsuccessful 404 error when trying to import orders, you may need to check your store URL.

  1. Check your domain URL with http://.
  2. If your browser gets redirected to https://, test your integration with your consumer key and secret e.g. https://www.YOURSTORE.com/wc-api/v2/orders?consumer_key=XXXXXXX&consumer_secret=XXXXXXX 
  3. If you can see a list of orders, go to your Starshipit account > Settings > Integrations > WooCommerce.
  4. In the URL field, change your URL to start with https://.


  5. Test to ensure the connection works. You should get a successful result. If you continue to receive an error, please contact our support team.
  6. If you get a successful result with the above test but the connection in Starshipit is stating unsuccessful, please disable Bot Fight Mode with your CloudFlare in WooCommerce.

Error: Unsuccessful - The underlying connection was closed: The connection was closed unexpectedly

If you test the connection and get this error, add the following content into the Custom Request Headers field:

user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.119 Safari/537.36


Error: Writeback failing with 401 error

This means that we do not have the proper authentication to update your orders. Try ticking the Use consumer key and secret as query string parameters option. This usually bypasses many of the security/firewall issues a server may be having with processing the authorisation 

Error: Writeback failing with 403 error

This means we do not have the proper permissions to update your orders in your store. Make sure the API key has both read and write permissions. 

Also ensure that the user you have assigned is a stand alone user with admin permissions.

Want to deliver great shipping experiences?

Start a 30-day free trial or book a demo with one of our shipping experts

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.