Handling 404 error when connecting WooCommerce store

If you get the 404 error when you try to connect your WooCommerce storeit URL suggests that the WooCommerce authentication endpoint is eithermisconfigured or not available on your site.

eyeris.io application expects to find theauthentication endpoint in the following format:

https://<your store>/wc-auth/v1/authorize

Below is a list of potential reasons and corresponding solutions to address this issue. Please be careful in implementing them. It's better to ask the store technical expert to manage it.

‍

1. Custom REST Route Configuration

• Cause: Customizations in WooCommerce or a plugin may modify the REST API routes.
• Solution:some text
   
  1. Check your functions.php or any custom plugins for filters modifying REST API routes.
   
  2. Look for code using hooks like rest_pre_dispatch or rest_endpoints.
   
  3. Or there might be a different solution that you use to customize your routes.
   
  4. Enabling for a short period of time the default WooCommerce authentication endpoint. It is required only once when you connect your shop to the eyeris.io application. Once the connection is established you can disable the default authentication endpoint.

2. WooCommerce API Not Enabled

• Cause: The WooCommerce REST API might not be enabled or properly configured.
• Solution:some text
   
  1. Go to your WordPress Admin Panel.
   
  2. Navigate to WooCommerce > Settings > Advanced > REST API.
   
  3. Ensure the API is enabled and configured correctly.

3. WooCommerce Authentication API Disabled

• Cause: The WooCommerce Authentication API might have been intentionally disabled.
• Solution:some text
   
  1. Verify if the WooCommerce Authentication API is enabled. Older WooCommerce installations might require manual enabling.

4. Missing Endpoint

• Cause: The /wc-auth/v1/authorize endpoint is not registered or is missing.
• Solution:some text
   
  1. Ensure WooCommerce is installed and updated to the latest version.
   
  2. Check your .htaccess file (if using Apache) to confirm it supports pretty permalinks. Go to Settings > Permalinks in WordPress, re-save the settings, and test again.

5. Permalinks Issue

• Cause: Permalink settings might not be correctly configured.
• Solution:some text
   
  1. Go to Settings >  Permalinks.
   
  2. Ensure the permalink structure is not set to Plain. Use a structure like Post Name instead.
   
  3. Save changes even if no modifications are made.

6. Server-Side Issue

• Cause: Server settings or restrictions might block the API.
• Solution:some text
   
  1. Check your web server logs for errors related to this URL.
   
  2. Ensure mod_rewrite (for Apache) or the equivalent for your web server (e.g., NGINX) is enabled.

7. Plugin or Theme Conflict

• Cause: A plugin or theme conflict might disable or override the endpoint.
• Solution:some text
   
  1. Deactivate all plugins except WooCommerce and test the endpoint again.
  2. Switch to a default WordPress theme and test.

If you still encounter issues, it mayrequire further debugging of your server or WooCommerce setup.