Documentation

API Status: Affected

ProgramsImprove this page

A Program is a set of locations that uniquely represent an offline or online store where transactions from linked cards will be monitored. The Program is the parent object of your card linked structure. Other objects such as Cards, Locations, Webhooks and Transactions will always be linked to a Program. Brands are shared across Programs. They are unique and independent of each other allowing you to have several independent loyalty or rewards schemes inside your account.

Hierarchy diagram of the Fidel API object structure.

Programs structure diagram

Create Program

To create a new program on the Fidel Dashboard, go to the Programs page, click the New program button and enter a name. The Program will be created with the name provided without any initial locations.

Go to the Programs page on the dashboard to create a new program.

Create program

The same can be done with the API. Using curl, we can add 'Program X' as follows:

1234567891011
curl -X POST https://api.fidel.uk/v1/programs \
  -H 'Content-Type: application/json' \
  -H 'Fidel-Key: <KEY>' \
  -d '{
    "name": "Program X",
    "metadata": {
      "customKey1": "customValue1",
      "customKey2": "customValue2"
    }
  }'

A programId will be generated and is used as a data property when using the SDKs to link Cards to this Program. Cards are linked to Programs and consequently are able to track all purchases at locations in the program.