The remote server returned an error: (504) Gateway Timeout
If you are receiving the following error message (The remote server returned an error: (504) Gateway Timeout. - Endpoint: xxx) from Woo Commerce, it could mean a couple of things:
The incorrect URL has been entered.
The end of the URL doesn't have /wp-json/wc/v2/.
The Consumer Key/ Consumer Secret is incorrect.
The IP Addresses haven't been whitelisted.
Unable to connect to the remote server
The error (The operation has timed out—Endpoint: https://{customerdomain}.co.uk/wp-json/wc/v2/ or Unable to connect to the remote server - Endpoint: https://{customerdomain}.co.uk/wp-json/wc/v2/) from WooCommerce typically occurs when a request from Mintsoft to WooCommerce's API takes too long to receive a response.
To resolve this issue please review the steps below:
Check WordPress plugins
Access your WooCommerce WordPress admin panel.
Temporarily disable non-essential plugins to identify conflicts.
Test the connection after each plugin is disabled.
Re-enable plugins once testing is complete.
Verify network and security settings
Check your firewall settings to ensure they're not blocking Mintsoft requests.
Review proxy configurations that might delay connections.
Confirm there are no DNS issues affecting the connection.
Validate API credentials
Verify the Consumer Key and Consumer Secret entered on the WooCommerce connection in Mintsoft:
Ensure they match your WooCommerce API credentials exactly.
Check these haven't been changed or regenerated in WooCommerce.
Check the connection URL
Review the URL field in your WooCommerce connection settings.
Ensure there are no leading or trailing spaces in the URL field.
Confirm the URL matches your WooCommerce site address exactly.
Review webhook configuration
If you're using webhooks:
Verify they're configured correctly in both Mintsoft and WooCommerce.
See our WooCommerce Integration help guide for detailed webhook setup instructions.
By following these steps, you should be able to resolve the error. If all checks have been completed and the error persists, please raise a new case online and reference this article title.
IP Whitelisting
Due to several new security plugins being used for Woo Commerce, we advise that if you experience issues connecting a WooCommerce account, then it may solve the issue if our range of IP addresses is whitelisted on the hosting server for the WordPress or WooCommerce installation to ensure that despatch updates can be carried out. To learn more about our IP Addresses, please review our Help Article.
Stock Sync
You must be on Woo Commerce version 3.0 or higher and using the V2 endpoint above to support variation stock sync.
Variable Product
If you have a Variable Product within Woo Commerce, you need to make sure Manage Stock? is enabled on each level of the variation. Inventory for variable products can be managed on product and variation levels. Сhoose how to manage stock by toggling Enable stock management at product level on the Inventory tab
The following settings are available if you choose to manage stock on a product level:
SKU: If you use SKUs, set them or leave them blank to use the product’s SKU.
Manage Stock: Tick the box to manage stock at the variation level.
Stock Quantity: This shows if Manage Stock is selected. Input the quantity. Stock for the specific variation or left blank to use the product’s stock settings.
Allow Backorders: Choose how to handle backorders.
Low stock threshold – When the stock for the variation reaches this level you will get a notification email.
Sold Individually: Allow only one to be sold in one order. (This setting is used for the product itself. You cannot set a specific variation to only be sold once per order).
Case Sensitive
Woo Commerce API is case sensitive for stock sync. Please make sure all your SKUs in Mintsoft match the case in Woo Commerce either upper or lower case.
SSL
The connection only works with an SSL certificate (HTTPS) installed on the Woo Commerce store. This needs to be site wide. To use the latest version of the Woo REST API you must be using:
Minimum Woo Commerce version 2.6. You can check this by navigating to Woo Commerce, System Status, WC Version field.
Minimum WordPress version 4.4+. (WP Version field).