Introduction

The Referral Program API allows you to create and manage a referral program for a site. With this API, you can incentivize a business's existing customers to bring in new ones, helping to grow a business through word-of-mouth marketing.

With the Referral Program API, you can:

See Wix Referral Program: Adding and Setting Up Your Referral Program for more information on setting up and managing referral program on a Wix site.

Types of referral rewards

The Referral Rewards API supports the following types of rewards:

  • Coupon: A discount or promotional offer that can be applied to a purchase.
  • Loyalty Points: Points awarded to a customer's loyalty account.

Before you begin

It's important to note the following points before starting to code:

  • The Referral Program API requires a Business or higher plan for Wix Editor, or a Plus or higher plan for Wix Studio.
  • A site must have at least one of these apps installed: Wix Stores, Wix Bookings, Wix Events, Wix Pricing Plans, or Wix Restaurants Orders.
  • There can only be 1 referral program per site.

Terminology

  • Referral program: A feature that allows a site's members to refer friends to a business by sharing referral URLs. There is an option to reward both the customer doing the referring and the friend being referred.
  • Referring customer: A site member who shares a referral URL with potential new customers.
  • Referred friend: A person who clicks on a referral URL shared by a referring customer.
  • Reward: An incentive given to both the referring customer and the referred friend for participating in the program.
  • Successful referral action: An action taken by the referred friend that triggers a reward for the referring customer. For example, placing an order or booking a session.
  • Referral URL: A unique link generated for each site member that can be shared with potential new customers. The member copies and shares this link with potential customers. When clicked, it brings the referred friend to the site, where they can sign up and redeem their reward.
Did this help?

Setup

@wix/referral

To use the Programs API, install the @wix/referral package using npm or Yarn:

Copy
npm install @wix/referral

or

Copy
yarn add @wix/referral

Then import { programs } from @wix/referral:

Copy
import { programs } from "@wix/referral";
Did this help?