WooCommerce Integration

Install and setup ReferralCandy on your WooCommerce store

Adam avatar
Written by Adam
Updated over a week ago

The ReferralCandy plugin is available for WooCommerce 2.3.3 or higher. If you use an older version, we recommend one of our manual integration methods.

We've broken down the setup process below into 4 parts:


Part #1. Signup up for ReferralCandy (14 day free trial)

  1. Select WooCommerce as your platform and complete the remaining steps until you reach the ReferralCandy Dashboard

  2. From the ReferralCandy dashboard side-menu, select Profile > My Profile

  3. Navigate to the API Tokens and Plugin Tokens section, like in the screenshot below

  4. You'll now want to either leave this tab open or take note of the 3 highlighted items

    1. API Access ID

    2. App ID

    3. Secret Key


Part #2. Installing ReferralCandy on WooCommerce

There are 2 methods to install the ReferralCandy plugin; you only need to accomplish one of these methods before proceeding to Part #3.

Method 1: From your WordPress dashboard (Recommended)

  1. Go to Plugins > Add New Plugin, then search for ReferralCandy

  2. Click on Install and activate, then proceed to Part #3

Method 2: From WordPress.org

  1. Download the latest version zip file here

  2. On your WordPress dashboard, go to Plugins > Add New Plugin

  3. Click on Upload to upload the zip file

  4. Once uploaded, the installation will begin automatically, Please proceed to Part #3


Part #3. Integrating ReferralCandy with WooCommerce

  1. Once installation is completed, you'll see the following page: click on Manage plugin

  2. You'll be brought directly to the plugin's Integration page

  3. Scrolling down, you'll find the 3 input boxes you can paste in the API/Plugin tokens you saved from Part #1

  4. Don't forget to click Save Changes at the bottom of the page


Part #4. Configuration

Below, we've highlighted the different configuration options available via the plugin:

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.

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.


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


Did this answer your question?