WooCommerce Troubleshooting

WP Fusion’s integration with WooCommerce is quite complex, and while it’s generally very reliable occasionally things can go wrong, especially with more complex configurations— for example combinations of subscriptions, deposits, variations, attributes, and auto-login sessions.

This guide will walk you through some troubleshooting steps to help solve the most common WooCommerce issues.

1. Turn on logging

If you haven’t already, enable WP Fusion’s activity logs from the Advanced settings menu:

The logs will show any API calls that are being made by WP Fusion, including any field updates, tags being removed or applied, and automated course and membership enrollments.

Here’s a typical WooCommerce order recorded in the WP Fusion logs:

If you’re using the Enhanced Ecommerce addon you’ll also see additional data related to the ecommerce data:

If there are any errors these will also be marked in the logs in orange:

If you can include the error details with your support ticket it will help us to diagnose the issue more quickly.

2. Test in an incognito window

If you’re testing your WooCommerce checkout with WP Fusion it’s best to test in an incognito window, or while you’re not logged into your site. This is the best way to simulate the experience of an actual customer.

If you’re logged into the site as an administrator then all checkouts will update your existing contact record in your CRM.

3. Check order notes

Even if you don’t have logging turned on, WP Fusion will still record some information to the order notes for each WooCommerce order.

These can be viewed in the sidebar when editing any single order:

Any API errors will also be added to the order as notes.

4. Process order actions again

If for some reason an order didn’t get sent to your CRM, or you’d like to process an order again with logging turned on, you can manually process an order again by choosing Process WP Fusion actions again from the Order Actions menu:

5. Disable asynchronous checkout

WP Fusion includes an option for WooCommerce called Asynchronous Checkout, which is enabled by default. When this setting is enabled WP Fusion processes all API calls in the background, which speeds up the checkout process.

While this works fine on 95% of sites, it can sometimes be blocked by security plugins or firewall rules. If your customers are checking out but no data is being sent to your CRM then turning off this setting is a good diagnostic step.

If turning off Asynchronous Checkout fixes the checkout process then it’s quite likely the background process is being blocked.

  • If you’re using WordFence: Putting the WordFence firewall into “learning mode” temporarily has been known to fix the issue
  • You can also contact support for additional assistance

6. Default settings

When you first install WP Fusion the settings are initialized with some default options. These defaults are sufficient for the majority of sites and don’t need to be changed.

Some things we’ve seen changed that have caused problems are:

Create Contacts:

If you un-check the setting for Create Contacts then WP Fusion will not create contact records in your CRM when someone makes a purchase in WooCommerce. It will only apply tags to existing contacts. It is recommended to leave this setting on.

Limit user roles:

WP Fusion includes a setting to limit contact record creation to certain user roles. In the screenshot above the “Subscriber” role has been specified. This will not work with WooCommerce, since WooCommerce creates users with the role Customer.

It is recommended to leave this setting blank so contact records are created for all new users.