Fidel.ukFidel - Home


After creating an account and getting access to the dashboard, the next step is to create a test Brand (Merchant). This lets you create locations and add them to a Program so you can start tracking transactions.

The Brand object is used to aggregate locations and keep track of the Brand consent. To track real-time transactions at a Brand's locations, you need to obtain consent from authorised personnel (Brand Contact), and provide the Brand with access to view transactional data. You can do this when creating the Brand (see below).

Once you create a Brand, it cannot be deleted.

Create Brand

Create brand

To create a new Brand, go to the Brands page on the dashboard, click the + icon and enter a name. Optionally, you can add a link to the brand logo (Note: the logo cannot be added later). You can also create a Brand with the API:

curl -X POST \ \
  -H 'content-type: application/json' \
  -H 'fidel-key: {your Secret key}' \
  -d '{
    "name": "Brand B",
    "logoURL": ""

Brand Consent

All brands must be approved by the authorised Brand Contact. To automatically request Brand consent in the dashboard, enter the name and email of the Brand Contact and Fidel will send an email inviting them to create a Brand account at To request Brand Consent with the API, use the Brand Consent Endpoint. By creating an account the Brand User provides consent and will have access to transactions made by cardholders at participating locations.

Brand Consent is only required in the Live environment. Test Brands are automatically given Brand consent.

You can monitor consent status on the dashboard and also set up a brand.consent webhook to be notified when the status changes.

Auto-Approve Consent

If you're funding your own offers, or you've received direct authorisation from a brand, you can auto-approve the brand's consent:

Auto approve Brand

Using the Brand Consent API, you can auto-approve your Brand by adding skipInvite: true to the JSON request with the brand owner information.