All Collections
Integration Settings
Troubleshoot Common WooCommerce Integration Problems
Troubleshoot Common WooCommerce Integration Problems

Here's why your WooCommerce site may not connect to Pirate Ship

Updated over a week ago

There are many reasons why a WooCommerce store may have some trouble connecting to Pirate Ship. The steps below will go over some easy settings to check, but you may need to reach out to your site developer for further assistance 😉

  • Is your website live? Pirate Ship won't be able to connect to your store if your website is under maintenance, or in password-protected mode.
    ​

  • Are you trying to connect to the base URL? For example, you should be connecting to yourwebsitenamehere.com, not yourwebsitenamehere.com/shop 👍
    ​

  • Does your setup meet the minimum requirements?
    - Your WooCommerce plugin should be at least version 2.6 or newer.
    - Your WordPress installation must be at least version 4.4 or newer.
    - You must have an SSL certificate installed on your website (https://)

  • Try logging out of WooCommerce and PirateShip, then try logging in again and enter your credentials manually. Sometimes this helps refresh the connection and get your integration up and running again 💪 If you get to the login window in WooCommerce, it will look like this:

  • If you go to https://yourwebsitenamehere.com/wp-json/wc/v1, do you get an error, or a ton of code? (For example, https://piratepeglegs.com/wp-json/wc/v1)
    - Getting a page full of code is a good sign 🙂
    - If you see an actual error, the built-in API for your website was disabled or deleted. You'll need to work with your website developer to add it back!

  • Do you have a firewall? Sometimes firewalls will block unknown User Agents 🙈

    You will want to be sure to whitelist Pirate Ship's User Agent String ("Pirate Ship WooCommerce Integration"). Your web developer can test if everything is working by running the following command: curl --verbose --user-agent "Pirate Ship WooCommerce Integration" https://www.yourwebsite.com/wp-json/wc/v1. You should then receive an HTTP response (200) and JSON result of your store configuration.

  • Are you using the right admin credentials to log in to WordPress? To connect the Pirate Ship integration to WooCommerce, you'll need to log in to WordPress using the admin credentials associated with your WooCommerce account, not just another site admin (such as your tech admin, for instance).

  • Do you have High-Performance Order Storage (HPOS) enabled? HPOS is optional, but if you have it enabled, WooCommerce requires you to enable compatibility mode to synchronize your orders to Pirate Ship's import grid ✅ You can check to make sure compatibility mode for HPOS is enabled by going to your WooCommerce Settings > Advanced > Features > and then checking the box "Enable compatibility mode (synchronizes orders to the posts table)" in the section marked Other data storage.

Still hitting rough waters? Chat in with our Support Crew so we can get you sailin' in the right direction ⛵

Did this answer your question?