TABLE OF CONTENTS
- 1) A firewall is blocking access to the WooCommerce site
- 2) Cannot correctly locate the WooCommerce REST API endpoint (API endpoint)
- 3) Invalid SSL certificate
- 4) Changes to your WooCommerce Store or Hosting
- 5) Existing Users: How to test we can connect to WooCommerce
- 6) If you already Have An Account in our system and you can no longer connect.
If our system cannot connect to your Woocommerce Store, please review the following guidelines. The information below also covers retailers who already have an existing Account in our System and cannot move beyond the Create An Account step.
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
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.
2) Cannot correctly locate the WooCommerce REST API endpoint (API endpoint)
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://...
We have a couple of options if the URL is wrong:
* 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.
* 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.
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.
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:
- go to Settings > Feed > General
- record the original API Endpoint URL
- change your API Endpoint URL
- click "Update" at the bottom of the page
- click "Test Connection"
- If you see "Connection to WooCommerce API is successful" then that pattern worked and you are done, please try the above patterns in order.
5) Existing Users: How to test we can connect to WooCommerce
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.
6) If you already Have An Account in our system and you can no longer connect.
Before you reach out to our Support Team, please follow these simple steps from inside your Woocommerce setup. This will get you beyond the step where you have to Create A New Account.
- Deactivate and Uninstall the Omnivore Plugin.
- Reinstall the Omnivore Plugin.
- Click to go to the Omnivore Page in Woocommerce.
- Click Save and then click the Go To Omnivore Button.
- This will take you to the Registration Page. Please Stop at this point. Do not continue, instead please copy the URL Address of that page, and also do a Screen Shot.
- Paste the copied URL and the screen shot and send them to Support.
- With the URL and screen capture we can find your renewed connection and link your account.
- If for some reason you do continue beyond point 4/5 you will need to repeat the process, we require the exact URL after you click Save and Go to Omnivore.