Skip to main content

Integration overview

How to connect your store to ReferralCandy — the Shopify app, platform guides, and the Email, JavaScript, and API connection types.

Written by Adam

An integration connects your store to ReferralCandy: it sends your store's purchases to ReferralCandy, so ReferralCandy can detect which ones were referred and reward the right advocates. How you connect depends on your eCommerce platform — most major platforms use a dedicated app or setup guide, and everything else connects through one of three connection types.

Looking to connect a marketing tool instead — Klaviyo, Mailchimp, Google Analytics, ad retargeting, or Tremendous? Those live on the same Integrations page in your dashboard, but they aren't store connections. See the Third-Party Integrations collection.

Find your platform

To integrate your store with ReferralCandy, find your eCommerce platform below and follow its path:

Not sure whether ReferralCandy works with your platform? See Can I use ReferralCandy if I'm not using a supported eCommerce platform?


The three connection types

If your platform doesn't have a dedicated app or guide, your store connects to ReferralCandy through one of three connection types — Email, JavaScript, or API. You'll find them in your ReferralCandy dashboard under Integrations → Standalone.

Important: use exactly one connection type at a time. Selecting a different type in the dashboard doesn't disable a method you've already set up on your store — remove the old method's setup when you switch, or you risk duplicate purchases and tracking issues.

Email integration

Email integration is the simplest connection type, and it's the one the dashboard recommends if you don't have coding experience. There are two basic steps:

  1. BCC ReferralCandy on the invoice email your store sends customers once a purchase is completed.

  2. Add a referral tracking code to the purchase completed page your customers see after checkout.

JavaScript integration

For JavaScript integration, you paste a purchase and referral tracking code just before the closing </body> tag of your store's purchase completed page, then add your platform's dynamic checkout variables to the code so each purchase reaches ReferralCandy. The availability of dynamic checkout variables varies from platform to platform. As part of this setup, you can also tick "Show post-purchase widget after checkout" to show the post-purchase popup once customers complete a purchase.

API integration

API integration lets your platform exchange purchase and referral data with ReferralCandy directly. It's the most customizable connection type and requires programming experience. There are two basic steps:

  1. Use the purchase method of the ReferralCandy API to send the transaction information once a purchase is completed. Learn more

  2. Add a referral tracking code to the purchase completed page your customers see after checkout.

Choosing and switching your connection type

Your ReferralCandy dashboard shows the setup instructions and tracking code for one connection type at a time. Go to Integrations → Standalone — the page shows the type you have selected (for example, "Your connection type is JavaScript"). Click Change, pick Email, API, or JavaScript, and click Save to display that type's setup instructions and tracking code instead.

This selector only controls which setup the page displays — it doesn't connect or disconnect anything on your store. To switch methods, set up the new connection type on your store and remove the old one (take the old tracking code off your purchase completed page, or stop BCC'ing ReferralCandy on your invoice emails). Running two connection types at once can send the same purchase to ReferralCandy twice and cause duplicate purchases or tracking issues.

Other integrations

Beyond the store connection, the Integrations page in your dashboard also carries ReferralCandy's third-party marketing integrations: Klaviyo, Mailchimp, Google Analytics, ads & retargeting (Google Ads, Meta Pixel, AdRoll), and Tremendous. Browse the Third-Party Integrations collection for their guides, and the Store Integrations collection for more platform-specific guides (PayWhirl, Sticky.io, LearnWorlds, Acuity Scheduling, and more). You can also use Zapier to connect ReferralCandy with other tools your store runs on.


Store integrations FAQ

I'm a Shopify merchant — do I need to set up an integration?

No — if you're on Shopify, installing the ReferralCandy app from the Shopify App Store is the whole integration. The app connects your store automatically, and you manage your campaigns inside Shopify admin (Apps → ReferralCandy).

The Email, JavaScript, and API connection types are only for stores that aren't on a platform with a dedicated ReferralCandy app.

Can I use ReferralCandy for my store's mobile app?

ReferralCandy doesn't support referral programs from mobile apps on any platform (iOS, Android, Windows, etc.).

Customers need to use a web or mobile browser to make their purchases, so their purchases reach ReferralCandy and referrals can be detected accurately.

Did this answer your question?