Troubleshooting failed WooCommerce store connection

While connecting Checkout X to your WooCommerce store, you may encounter the following error:

This is happening because the Checkout X application can't open the permissions screen and ask for access to your WooCommerce store.

(here's how the permissions screen looks like)

Since the permissions screen is part of your WooCommerce store, we have no idea of the exact reason why Checkout X can't open it. Often, the problem is related to the store's configuration.

Here's a list of the most common issues our merchants face while trying to connect their WooCommerce stores. As we don't know the exact reason in your case, you'll have to check them one by one.

And of course, you can always contact the customer support team as well!

We'll be happy to help you!

Most common issues

1. Store doesn't meet the WooCommerce REST API requirements.

   Here's a screenshot of the requirements as of July 22, 2021

   

2. Store uses HTTP instead of HTTPS.

   Make sure your store uses an encrypted connection. Using http won't allow you to connect with Checkout X.

   

3. Store uses default permalinks.

   This is part of the the WooCommerce REST API requirements, but is often neglected.

   If you use "plain" permalinks in Settings > Permalinks -> Common Settings , then the REST API won't work and the store connection will fail.

   

   You must use pretty permalinks so that the custom endpoints are supported.

4. Store is not on the root domain.

   Checkout X supports only stores installed on the domain's root.

   For example:

   1. Store installed on www.example.com can be connected.

   2. Store installed on www.example.com/store can't be connected.

   We are working on removing this restriction, though.