Setting up a Loyalty Program

This guide shows you how to create a new loyalty program. Furthermore, we look at how you can use the FanPoints SDK to let your users participate in the loyalty program.

  1. Creating a New Loyalty Program
  2. Accepting Partners
  3. Setting up the FanPoints SDK
    1. Installing the SDK
    2. Getting Access Tokens
    3. Configuring a Client
  4. Using the FanPoints SDK
    1. Registering Users
    2. On User Ids
    3. Deleting Users

Creating a New Loyalty Program

Open the FanPoints dashboard and create a new account. Once logged in, use the Create New button to create a new loyalty program.

Accepting Partners

Open the newly created loyaly program and navigate to the Partners tab. When a partner requests to join your loyalty program, you can accept or decline the request. This will allow users to interact with the loyalty program at this partner.

You can always use the Example Partner to test your integration. This partner is open to everyone and can be used for testing purposes.

Setting up the FanPoints SDK

Now you’re ready to integrate the FanPoints SDK into your infrastructure. You can use the SDK to let users enter your loyalty program.

Currently, only a server-side typescript SDK is available. It needs to be used in your backend, as user-level authorization is not yet supported. We are working on a client-side SDK that will allow you to use the SDK in your client-side code.

Installing the SDK

You can install the SDK using npm:

npm install @fanpoints/server-js

Getting Access Tokens

To access the FanPoints API, you first need to generate access tokens. Go to the dashboard, navigate to your loyalty program, click on Settings and then on Tokens. You can generate a new token there. Each token consists of a client id and a secret.

Configuring a Client

All operations are performed on a FanPointsClient object. With the generated access tokens, you can create a client for your loyalty program:

import { createClient } from '@fanpoints/server-js';

const client = createClient({
    loyaltyProgramConfig: {
        loyaltyProgramId: 'the loyalty program id',  // can be found in the dashboard
        clientId: 'the client id',
        secret: 'the client secret',
    },
});

You can use the ping function to test if the client is working:

client.ping().then(() => {
    console.log("The client is working!");
});

Using the FanPoints SDK

Registering Users

You are now ready to register your users in the loyalty program. You could decide that all your existing users are automatically registered in the loyalty program. You can also let users manually opt-in into the loyalty program.

Either way, you can use the following code to register a user in the loyalty program:

await client.users.addUser('your user id', '<the users mail address>');

Now the user is registered in the loyalty program and can start collecting and spending fan points.

On User Ids

Note that you have to specify your own internal user id. The user will get its own FanPoints user id. You can use both your internal or the FanPoints user id to interact with the SDK, as translation happens automatically.

You can see this by using the following snippet:

const user = await client.users.getUser('your user id');

/**
 * user = {
 *   mailAddress: 'tobia.ochsner@gmail.com',
 *   fanPointsUserId: '<the fanpoints id>',
 *   userId: '<your id>'
 * }
 */

Deleting Users

In order to delete a user from the loyalty program, you can use the following snippet:

await client.users.deleteUser('your user id');