Troubleshooting the WooCommerce iOS App

Due to the nature of WordPress sites and the fact that they run in a variety of hosting environments, there can sometimes be issues in connecting the WooCommerce app to your store.

What happens is the app requests that the server your WooCommerce site is running on to use REST API to verify you have permission to access the store data.

  • If the server says your credentials are good, you get access to your store information.
  • If the server does not recognize credentials for some reason, errors can arise. It’s not possible for us to test the REST API in every hosting environment, but we fix issues as we discover them.

Common errors ↑ Back to top

Here are common errors and their solutions:

Issue Solution
Error says “No WooCommerce API found at this URL” Please confirm:

  1. Are you running WooCommerce 3.0+ on your site with REST API enabled?
    Verify this at WooCommerce > Settings > General. This is what connects your shop to the app. (Under requirements here.)
  2. Go to Settings > Permalinks and ensure that you have pretty permalinks enabled.
  3. Ensure that your hosting provider or caching plugin excludes the API endpoint from caching (which we know is a problem with WP Super Cache). The API endpoint is:
    http://www.YOURSTORE.com/wc-api/v2
    More detailed instructions below.
  4. Ensure that your site is not in maintenance mode or hidden from users. If the site is not visible, the app cannot find it.
 Message saying “invalid key” when entering credentials For some servers, this error is returned because your key was not generated before authenticating your shop. Generate API keys, quit the app*, and retry.
“Consumer key / secret is invalid” We released a fix for this in v1.0.1 that provides better fallback for servers that mishandle HTTP authentication. Upgrade the app, and re-enter your credentials.
Error when trying to setup site View the known conflicts below to understand how to handle the error.

*You can quit by double-tapping the home button, scrolling to the app if needed, and swiping upwards over the app page to remove it from active apps.

If these solutions do not work or you continue to receive an error, go to Questions and Feedback and open a ticket. We’re happy to help.

Known conflicts ↑ Back to top

Shopifiq Theme (incompatible) ↑ Back to top

The Shopifiq theme causes an “invalid signature” error when you try to connect to your store, which means it breaks the REST API and cannot be used with the WooCommerce app.

Until it fixes the way it improperly filters the get_home_url() function, you will be unable to use the app with your store. We recommend using a different, properly-coded WooCommerce theme, such as Storefront.

InfiniteWP (incompatible) ↑ Back to top

InfiniteWP: The InfiniteWP client plugin causes a conflict with the WooCommerce REST API by improperly reading php://input without setting the global. This means you cannot update order statuses via the app or do anything else that uses the REST API.

WPML ↑ Back to top

WPML will break the REST API calls needed for the app to function, if you enabled the “Use directory for default language setting.” Change this setting or force WMPL to properly include the REST API endpoint.

wpml-setting

When this setting is enabled, WPML breaks the REST API endpoint so the API cannot be found on your site, regardless of whether you have it enabled or not. Until WPML properly accounts for this API (and the upcoming WordPress core API), you need to fix this issue manually using one of the following options:

  1. Disable this setting (or switch plugins).
  2. Use this code snippet on your site (in a custom plugin / child theme) to force WPML to properly include this endpoint:

iThemes Security ↑ Back to top

iThemes Security is not incompatible, but it does sometimes blindly apply rules that conflict with the WooCommerce REST API.

If your site meets all requirements and you cannot connect your store, check your iThemes Security settings.

Go to: Security > Settings > System Tweaks and disable “Filter suspicious query strings in the URL.”

ithemes-security-wc-ios

WP Super Cache ↑ Back to top

With WP Super Cache or other caching plugins, ensure that API endpoints are not cached.

There are sometimes issues when using the WooCommerce API (which the iOS app uses) if WP Super Cache is enabled on your site. You may see an error message such as “Cannot find API URL.” Here are some steps to fix this issue:

  1. Go to Settings > WP Super Cache.
  2. Select the Advanced tab.
  3. Scroll down to “Accepted filenames & Rejected URLs”. Add /wc-api/v2 to the text box:
    wpml-setting
  4.  Save Strings.

Questions and Feedback ↑ Back to top

Already tried troubleshooting and need assistance? Get in touch with a Happiness Engineer via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top