Skip to main content
All CollectionsIntegration Settings
Troubleshoot Common WooCommerce Integration Problems
Troubleshoot Common WooCommerce Integration Problems

Here are some reasons 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 πŸ˜‰

Things to check if you can't connect your WooCommerce store to Pirate Ship

  • Website Status: 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.
    ​

  • Base URL: Are you trying to connect to the base URL? For example, you should be connecting to yourwebsitenamehere.com, not yourwebsitenamehere.com/shop πŸ‘
    ​

  • Minimum Requirements: Does your setup meet the minimum requirements? Here's what they are:

    • 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://)

  • Enter Credentials Manually: 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:

  • Error Message: 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!

  • Firewall Enabled: Do you have a firewall? Sometimes firewalls will block unknown User Agents πŸ™ˆ

    • Whitelisting: You will want 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.

  • Proper Admin Credentials: 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).

  • HPOS Compatability Mode: 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.

Chat with ARRrrr Support Crew if you need any help

Still hitting rough waters connecting your WooCommerce store, Matey? Chat in with our Support Crew so we can get you sailin' in the right direction β›΅

Did this answer your question?