{"id":436,"date":"2024-05-08T20:43:30","date_gmt":"2024-05-08T20:43:30","guid":{"rendered":"https:\/\/help.kosmosesync.com\/?post_type=ht_kb&#038;p=436"},"modified":"2025-08-11T16:07:56","modified_gmt":"2025-08-11T16:07:56","slug":"troubleshooting-woocommerce-connection-problems","status":"publish","type":"ht_kb","link":"https:\/\/help.kosmosesync.com\/index.php\/knowledge-base\/troubleshooting-woocommerce-connection-problems\/","title":{"rendered":"Troubleshooting WooCommerce Connection Problems"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">Troubleshooting WooCommerce Connection Problems<\/h1>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"woocommerce-rest-api-connection-problems---unable-to-connect-woocommerce\"><a href=\"https:\/\/helpdev.kosmosesync.com\/kb\/troubleshooting-woocommerce-connection-problems#woocommerce-rest-api-connection-problems---unable-to-connect-woocommerce\">#<\/a>&nbsp;WooCommerce REST API Connection problems &#8211; Unable to Connect to WooCommerce<\/h4>\n\n\n\n<p>If you\u2019re having difficulty connecting your WooCommerce web store or syncing products\/orders, please review the suggestions below.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Make sure you have enabled permalinks under the custom structure area. See the example below.\n<ul class=\"wp-block-list\">\n<li><img loading=\"lazy\" decoding=\"async\" width=\"750\" height=\"337\" class=\"wp-image-678\" style=\"width: 750px;\" src=\"https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1.png\" alt=\"\" srcset=\"https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1.png 1161w, https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1-300x135.png 300w, https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1-1024x460.png 1024w, https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1-768x345.png 768w, https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1-50x22.png 50w, https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1-60x27.png 60w, https:\/\/help.kosmosesync.com\/wp-content\/uploads\/2024\/05\/PermaLinks-1-100x45.png 100w\" sizes=\"auto, (max-width: 750px) 100vw, 750px\" \/><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Wordfence Firewall: <\/strong>Contact Kosmos support and add the eSync assigned IP under Firewall -&gt; Manage Firewall -&gt; Allowlisted IP addresses that bypass all rules.&nbsp;<\/li>\n\n\n\n<li>Does your hosting company think our user agent is a bot? If so, please have them whitelist this software user agent: Jersey\/2.21 (HttpUrlConnection 1.8.0_452).<\/li>\n\n\n\n<li>Deactivate all of your security plug-ins and test. There are also known connection problems with iThemes Security. Deactivate this plug-in&#8217;s whitelist of our Kosmos IPs and then test a product sync. If it fails, I suggest using a different plug-in like WordFence and whitelisting our IP addresses.<\/li>\n\n\n\n<li>Redirects: if you&#8217;re redirecting the URL, this is not supported, and you will need to use the original non-redirected URL for your domain.  Test with a <a href=\"https:\/\/www.redirect-checker.org\/index.php\" target=\"_blank\" rel=\"noopener nofollow\" title=\"\">redirect tool<\/a> for a successful 200 OK response.<\/li>\n\n\n\n<li>Try deactivating all plug-ins except for WooCommerce. Next, test your connection to ensure it&#8217;s successful, and then add one plug-in at a time to identify the culprit.<\/li>\n\n\n\n<li>Apache Servers &#8211; See the discussion board and&nbsp;<a href=\"https:\/\/github.com\/WP-API\/OAuth1\/issues\/81\" target=\"_blank\" rel=\"noreferrer noopener\">check your WooCommerce .htaccess file<\/a>.<\/li>\n\n\n\n<li>NGNIX Servers &#8211; See the discussion board and&nbsp;<a href=\"https:\/\/stackoverflow.com\/questions\/42419267\/woocommerce-rest-authentication-error-401\" target=\"_blank\" rel=\"noreferrer noopener\">review Nginx server blocks<\/a>.<\/li>\n\n\n\n<li>Do you have Wordfence? <span style=\"box-sizing: border-box; margin: 0px; padding: 0px;\">Contact Kosmos Support (ask for your server IP addresses) and see the&nbsp;<a href=\"https:\/\/silicondales.com\/tutorials\/wordpress\/whitelist-ip-wordfence\/\" target=\"_blank\">Wordfence tutorial on how to whitelist your eSync server IP addresses.<\/a><\/span><\/li>\n\n\n\n<li><strong>GoDaddy Hosted WordPress<\/strong>&nbsp;is not supported. You will need to upgrade to GoDaddy Linux cPanel Hosting.<\/li>\n\n\n\n<li><strong>Returning HTML instead of JSON<\/strong>&nbsp;when testing with Postman? Make sure permalinks are enabled.<\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/woocommerce\/woocommerce\/wiki\/Getting-started-with-the-REST-API\" target=\"_blank\" rel=\"noreferrer noopener\">Getting started with WooCommerce REST API<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/robotninja.com\/blog\/fix-common-woocommerce-rest-api-issues\/\" target=\"_blank\" rel=\"noreferrer noopener\">Fix common WooCommerce REST API Issues<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.digicert.com\/help\/\" target=\"_blank\" rel=\"noreferrer noopener\">SSL Test Tool<\/a>:\u00a0a. Compare your SSL to\u00a0<a href=\"https:\/\/letsencrypt.kosmoscentral.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/letsencrypt.kosmoscentral.com<\/a><\/li>\n\n\n\n<li>If you still have problems, please post a ticket under SUPPORT at the top of the page, and our team will assist you. Provide your domain URL and a test key and secret, and we\u2019ll test with Postman, as mentioned below.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"test-with-postman\"><a href=\"https:\/\/helpdev.kosmosesync.com\/kb\/troubleshooting-woocommerce-connection-problems#test-with-postman\">#<\/a>&nbsp;Test with PostMan<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You can also&nbsp;<a href=\"https:\/\/github.com\/woocommerce\/woocommerce\/blob\/trunk\/docs\/rest-api\/getting-started.md\" target=\"_blank\" rel=\"noreferrer noopener\">test your WooCommerce API Key and Secret using Postman<\/a>. Postman is a Free utility that will assist you in troubleshooting your WooCommerce environment.<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>If you\u2019re getting a \u2018401 Unauthorized\u2019 message with Postman then check your .htaccess file as mentioned above in step 5.<\/p>\n<\/blockquote>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>If you\u2019re seeing html in your response instead of clean JSON then send to your hosting provider. Also post a&nbsp;<a href=\"https:\/\/supportcenter.kosmoscentral.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">Support ticket<\/a>&nbsp;with your API Key and Secret and we can assist with verifying your findings.<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"hosting-recomendations\"><a href=\"https:\/\/helpdev.kosmosesync.com\/kb\/troubleshooting-woocommerce-connection-problems#hosting-recomendations\">#<\/a>&nbsp;Hosting Recommendations<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Were we still having problems? We recommended these top-rated Hosting providers: Blue Host or HostGator.<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Troubleshooting WooCommerce Connection Problems #&nbsp;WooCommerce REST API Connection problems &#8211; Unable to Connect to WooCommerce If you\u2019re having difficulty connecting your WooCommerce web store or syncing products\/orders, please review the suggestions below. #&nbsp;Test with PostMan If you\u2019re getting a \u2018401 Unauthorized\u2019 message with Postman then check your .htaccess file as&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"ht-kb-category":[],"ht-kb-tag":[],"class_list":["post-436","ht_kb","type-ht_kb","status-publish","format-standard","hentry"],"aioseo_notices":[],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/ht-kb\/436","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/comments?post=436"}],"version-history":[{"count":14,"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/ht-kb\/436\/revisions"}],"predecessor-version":[{"id":784,"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/ht-kb\/436\/revisions\/784"}],"wp:attachment":[{"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/media?parent=436"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=436"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.kosmosesync.com\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=436"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}