WooCommerce Integration

Install ReferralCandy to your WooCommerce store

Caye Arahan avatar
Written by Caye Arahan
Updated over a week ago

This guide will walk you through how to integrate ReferralCandy with your WooCommerce store, and provide a better understanding of options within the plugin.

The ReferralCandy plugin is available for WooCommerce 2.3.3 or higher. If you use an older version of WooCommerce, you may want to use Email Integration, JavaScript integration or API integration instead.

Note: Only version v2.4.0 or higher of this plugin is compatible with stores that have HPOS enabled. If you recently transitioned to HPOS, the plugin will auto-detect this change and update accordingly. No additional action is required from you at this time.

Installing ReferralCandy on WooCommerce

To install ReferralCandy on your WooCommerce store, please follow steps below:

From your WordPress dashboard (Recommended)

  1. Go to Plugins > Add New.

  2. Search for: ReferralCandy.

  3. Click on Install Now to install and activate the plugin.

From WordPress.org

  1. Download the latest version zip file.

  2. Go to Plugins > Add New.

  3. Click on Upload Plugin to upload the zip file.

  4. Activate the plugin after the installation.


  1. Go to WooCommerce > Settings > Integration > ReferralCandy.

  2. Input your App ID and Secret Key. You can get them from your My Profile page under the "API Tokens" section.

  3. Click Save changes.

And you're done! Your store is now connected with ReferralCandy.

Configuration options

Process orders with status

At which state of the order should the orders be sent to ReferralCandy? We recommend using the Completed status to reduce referrals being attributed from fraudulent purchases. If your orders do not reach a Completed state, you can use other states as well like Processing.

Render tracking code on

At which page of your store should we render or trigger the tracking code? We require the tracking code to be triggered on your store's Thank You Page for the best accuracy when detecting referrals. If you do not use the default checkout page as your store's Thank You Page, please update this page. If you are having issues with a custom Thank You Page, please feel free to contact us.

Accepts marketing checkbox label

On the checkout page, we render an additional opt-in checkbox to let us know if your customers would like to receive referral emails or not. You can customize the checkbox's label using this text input.

Post-purchase Popup

This option enables/disables the Post-Purchase Popup widget on your checkout page without having to write a single piece of code.

Post-purchase Popup Quickfix

Sometimes when the post-purchase popup widget is rendered, it isn't rendered properly due to personal customizations on the store's themes and CSS files. We provided this option to quickly fix that issue for you without having to write additional code. If your issue is not resolved with this option, please feel free to contact us.

๐Ÿ’ฌ Need help? Click the chat widget on the right to start a conversation. Learn more

Did this answer your question?