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

Your store connection sends purchases to ReferralCandy so it can identify referrals and reward advocates. This connection is needed for purchase and referral tracking; depending on your platform, a dedicated app may handle it for you.

The Integrations page groups connections by purpose. On Other Platforms, look for Store connection to set up purchase tracking. Other groups include Email marketing, Analytics and tracking, and Rewards and payouts. Shopify also has Subscriptions; its store connection is handled by the ReferralCandy app, so there is no separate Store connection group.

Follow the store setup below, or jump to Email marketing, Analytics and tracking, Subscriptions, or Rewards and payouts for the tool you want to connect. These tools work alongside your store connection.

Store connection

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?

For more platform-specific guides (PayWhirl, Sticky.io, LearnWorlds, Acuity Scheduling, and more), browse the Store Integrations collection.

Connecting through Zapier? Follow the Zapier guide for the workflow you want to set up.


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.

Email marketing

Connect your email marketing platform to use referral links and customer data in your marketing. Follow the guide for Klaviyo, Mailchimp, Customer.io, Omnisend, and Brevo. These connections work alongside your store connection; they do not replace purchase tracking.

Analytics and tracking

Measure referral traffic and retarget visitors. In the dashboard, this group contains Marketing analytics and Ads & retargeting. See the guides for Google Analytics, Google Ads, Meta Pixel, and AdRoll.

Subscriptions

On Shopify, this group contains Recurring payments for rewarding referrals on recurring Recharge orders. See the Recharge integration guide.

Rewards and payouts

Connect Tremendous if you choose it to deliver cash rewards. This connection is needed for Tremendous payouts, but is optional for purchase tracking.

Browse the Third-Party Integrations collection for more setup guides.


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?