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.



Testing the Connection Between WooCommerce and Traderunner (Existing Accounts) 


To verify the connection between WooCommerce and Omnivore, follow these steps:


Navigate to Settings > Feeds > General

Click the "Test Connection" button

If the connection is successful, you will see the confirmation message: "Connection to WooCommerce API is successful."


If you encounter any errors, review your API settings and ensure your WooCommerce store is accessible. 


Reconnecting Your Traderunner Account to WooCommerce (Existing Accounts)


If your Traderunner account can no longer connect to WooCommerce, please follow these steps before contacting Support. These steps will reset the plugin and manually reconnect your existing account, allowing you to get beyond the step where you have to "Create a New Account". 


Step-by-Step Guide to Reset the Connection


  1. Deactivate and Uninstall the Traderunner Plugin. Do not proceed until the plugin is fully deleted.
  2. Reinstall the Traderunner Plugin.
  3. Go to the Traderunner page in WooCommerce.
  4. Activate the plugin.
  5. Click Traderunner to open the plugin settings.
  6. Click Save, then click the Go to Omnivore button.
  7. This will take you to the Traderunner Registration Page. Stop here - do not proceed further.
  8. Copy the URL of the registration page and take a screenshot of it.
  9. Important: Do not click the link after pasting it—once clicked, it will no longer be valid.
  10. Send both the copied URL and the screenshot to Support.


With the URL and screenshot, our team should be able to repair the connection and manually link your account for you.


If you accidentally proceed beyond Step 7, you will need to restart the process and provide the correct URL after clicking Save and Go to Traderunner.