LoyaltySurf Docs
Help CenterSystem StatusContact SupportYour Dashboard →
  • Welcome
  • Tutorials
  • Developer Tools
    • REST API
      • Tutorials
      • Objects
      • API Reference
      • API Guidelines
      • API Response Codes
    • Webhooks
      • Securing Your Webhooks (optional)
      • Examples
      • Events Reference
    • Metadata
  • Integrations
    • Chargebee
    • HubSpot
    • PayPal
    • Recurly
    • Slack
    • Stripe
    • Tango Card
    • Zapier
      • Tutorials
      • Troubleshooting
Powered by GitBook
On this page
  • Tutorial 1: How to set up a points-based loyalty program
  • How to set up this loyalty program:

Was this helpful?

Tutorials

Tutorials for common types of loyalty and reward programs

PreviousWelcomeNextREST API

Last updated 2 years ago

Was this helpful?

Tutorial 1: How to set up a points-based loyalty program

Let's say you want to give rewards to your customers in the form of points. And if a customer earns 100 points, they can unlock a reward, which can be a custom coupon or discount.

LoyaltySurf supports , which makes this loyalty program possible to implement.

Let's imagine you will give your users 10 points each time they do something, and that it will take 100 points to unlock a reward.

How to set up this loyalty program:

  1. Create your first LoyaltySurf campaign and at the first step in the campaign editor, create a new reward. In the advanced reward settings, make sure the loyalty actions required is 1 (this is the default).

  2. Next, we need to add your users into your LoyaltySurf campaign:

    1. For your existing users, you'll need to import them by clicking Add > Import Participants from your .

    2. For new users, you'll need to call every time someone new signs up

  3. Whenever your user performs an action, call /POST Update participant to update their value. For example:Participant.metadata.points = Participant.metadata.points + 10.

    1. On the API response, check if (Participant.metadata.points > 100) then call , which will unlock the reward for the participant.

  4. Then after the reward is unlocked, implement the following:

    1. Set up to automate reward fulfillment (so that the user gets their reward).

    2. Call /POST Update participant and decrement Participant.metadata.points by 100 to make sure the participant's points are reset.

participant metadata
admin dashboard
/POST Add participant
metadata
/POST trigger loyalty action by email
webhooks