Troubleshooting WooCommerce Integration Connectivity Issues

If you’re receiving an error message when setting up the WooCommerce Deep Data integration, there could be a few reasons why. In this article, we'll list connection errors that can appear when configuring the WooCommerce Deep Data integration and what you can do to troubleshoot them.

In this article:

  • WooCommerce Connection Error
  • WooCommerce API Misconfigured
  • WooCommerce Plugin Not Detected
  • Invalid WooCommerce URL
  • Unexpected Error

WooCommerce Connection Error

What to check:

  • Your protocol
    Some WooCommerce store URLs use an HTTP protocol while others use an HTTPS protocol. Double check to see which protocol you're using. Depending on your server configuration, you may need to try both protocols to see which one works.
  • Your SSL certificate
    Your SSL certificate may have an issue. You will need to work with your server admin, or the individual who set up the SSL, to diagnose and fix any SSL certificate issues. You can also use this SSL checker to diagnose any problems with your SSL certificate installation.

WooCommerce Pluigin Status Disconnected

What to check:

  • Do you have any WordPress security plugins such as Sucuri, Wordfence or MalCare activated?
    The easiest solution is to disable these plugins temporarily and connect Gist with your WooCommerce store. Alternatively, if you are using Sucuri, you can whitelist the Gist for WooCommerce plugin directory.

WooCommerce API Misconfigured

What to check:

  • Is your WooCommerce Rest API enabled?  
    In the WooCommerce plugin of your Wordpress account, ensure the "Enable the REST API" box is checked. Click to enable and save settings.
  • Permalinks
    Permalinks are the permanent URLs of your individual blog post or page on your WordPress site. You'll need to make sure that they're configured correctly. All permalink options in the red box in the image below will work, including: "Day and name," "Month and name," "Numeric," "Post name," and "Custom Structure."
    Using the "Plain" permalinks option will not work with this integration.
  • Your .htaccess file 
    You'll need to make sure that the .htaccess file in your WordPress account does not include default WordPress rewrite rules:
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

Server-related configuration can affect access to your WordPress site and the WooCommerce API endpoints. You may need to consult a server admin if the issues persist, or consult with someone who is familiar with maintaining or troubleshooting your web server configuration.

WooCommerce Plugin Not Detected

What to check:

  • Your WooCommerce plugin in your WordPress install
    Make sure that the WooCommerce WordPress plugin is installed and ena bled in your WordPress account. 

Invalid WooCommerce URL

What to check:

  • Your store URL
    Make sure that the store URL you used to set up the Deep Data integration does not include "/shop" at the end of the store URL. For example:

    Correct: https://my-store.com
    Incorrect: https://my-store.com/shop

    You can check this in your workspace by clicking "Settings"then "Integrations." Once there, click the WooCommerce integration. From here, you'll need to disconnect your store, then reconnect it using the correct URL.

Unexpected Error

In rare cases, this error may appear. If you see this error, please contact our Support Team and we can help you resolve the connection issue.

Was this article helpful?