TABLE OF CONTENTS

Overview

Here are some guidelines for troubleshooting and correcting different scenarios when our system cannot connect to your WooCommerce Store or if you already have an existing Account in our System and cannot move beyond the 'Create An Account' step. 

If you have moved your WooCommerce Site to a new server or hosting platform you will need to restore the connection to the Trade Runner App. Please review this FAQ fully.


Scenario 1: A firewall is blocking access to the WooCommerce site


Your server might have configured a firewall or some other IP based filtering. If this the case you'll likely see an error stating any of the following:

java.lang.RuntimeException: Remote error: java.net.ConnectException: Connection timed out
java.lang.RuntimeException: Remote error: java.net.ConnectException: Connection refused (Connection refused)

To resolve, please white-list the IPs of our Production servers.

See here for a full list of  Omnivore IP Addresses  which includes Trade Runner.


The above errors might also occur if the protocol (http or https) is wrong, for instance your server can only do http but the endpoint is entered as https, or vice versa.


Scenario 2: Is your registered API endpoint correct and publicly visible?


 If you see the following message then we cannot connect to your WooCommerce site.


 'Can't connect to WooCommerce API at https://...'


There are a couple of options if the URL is wrong:


  1. If you already have an account and the URL has changed please contact support and we can update the value. Please see more details on this below.
  2. If you are a new user you will need to uninstall and reinstall the plugin, before your first connection you can enter the correct URL.

Scenario 3: Invalid SSL certificate


If the endpoint is secure, ie. uses https, make sure your SSL certificate is valid. A self-signed certificate is usually not enough.

An easy method to check the SSL certificate is to use the Qualys SSL Server Test

Pay attention to expiration date and chain issues.


Scenario 4: Changes to your WooCommerce Store or Hosting


Have you updated Wordpress, WooCommerce or your hosting then your connection broke? This can happen sometimes, the URL of your API endpoint could have changed, try the following patterns:


https://your-site.com/wp-json/wc/v3
https://your-site.com/wp-json/wc/v2
https://your-site.com/wp-json/wc/v1

https://your-site.com/index.php/wp-json/wc/v3
https://your-site.com/index.php/wp-json/wc/v2

https://your-site.com/index.php/wp-json/wc/v1

https://your-site.com/wc-api/v3
https://your-site.com/wc-api/v2

https://your-site.com/wc-api/v1

https://your-site.com/index.php/wc-api/v3

https://your-site.com/index.php/wc-api/v2
https://your-site.com/index.php/wc-api/v1

You need to replace "https://your-site.com" with the base URL of your site. 

To test each pattern:

  1. go to Settings > Feed > General
  2. record the original API Endpoint URL
  3. change your API Endpoint URL
  4. click "Update" at the bottom of the page
  5. click "Test Connection"
  6. If you see "Connection to WooCommerce API is successful" then that pattern worked and you are done, please try the above patterns in order.



Existing Account: How to test the connection between WooCommerce and Trade Runner


To test the connection between WooCommerce and our platform, go to 'Settings' - 'Feeds' - 'General' then click the 'Test Connection' button. If we can connect to your WooCommerce store, you should see a confirmation message: 'Connection to WooCommerce API is successful'.