Incentives

Configure the discount or benefit a reward provides by adding one or more incentives. Incentives communicate reward value to external systems like POS.

An incentive defines the benefit a reward provides—such as a discount or price override—and is primarily used to communicate that logic to external systems, like point-of-sale (POS) platforms, when a voucher code is validated.

Incentives can be added and managed after a reward is created. You can add one or more incentives per reward to define what the voucher entitles the user to—such as “£5 off your next order” or “20% off a specific product.”

Using incentives

Incentives are primarily used when integrating your point-of-sale (POS) system or e-commerce store with the Loyalty Engine to validate Vouchers.

The properties listed below (such as type, value, sku, and venues) are recommended interpretations designed to support common use cases. However, the Loyalty Engine does not enforce how these fields are used—your integration must handle and interpret them appropriately as you dictate.

For example, the sku field can technically support a list of SKUs if your POS system is built to recognize a specific delimiter of your choosing. The same flexibility applies to other fields. It’s your responsibility to ensure the integration interprets the incentive data correctly.

---

Adding incentives

Each incentive has a few key settings:

Incentive types

This defines the kind of discount the incentive provides. Three types exist:

Incentive type	Description	Example
Absolute	An absolute discount, entered in the lowest currency denomination	'Get a $5 discount on your next dessert!' Entered as '500' in the value field
Percentage	A percentage discount, enter as a percentage amount	'Get a a 50% discount on your next dessert!' Entered as '50' in the value field
Fixed Price	A fixed price override, entered in the lowest currency denomination	'Get your next dessert for just $5!' Entered as 500 in the value field

SKU (optional)

Some POS systems use discount SKUs to apply incentives. This field allows you to specify a SKU in your POS system that represents the discount itself. This is useful when:

• You’ve already configured the discount logic in your POS

• You need more complex behaviour (e.g. buy one get one free)

Product SKU (optional)

This field allows you to limit the incentive to one or more specific products.

• Enter one or more SKUs, comma-separated.

• Leave blank to apply the incentive to the entire transaction.

Venues (optional)

Defines which venues the incentive is applicable at.

• This setting is different from venue availability in reward configuration, which controls where a reward can be redeemed.

• Use venue-specific incentives when the same reward should apply different benefits depending on where it’s redeemed. For example, a voucher might give £5 off in one store but 10% off in another. This allows for fine-tuned control over how a reward behaves at different locations.

Example

Imagine a reward offering '$5 off your next purchase'.

You want this to apply at all venues and to the whole basket:

• Incentive type: Absolute

• Value: 500

• SKU: (leave blank)

• Product SKU: (leave blank)

• Venues: (leave blank)

---

Editing incentives

Incentives can be edited at any time after they have been created, by visiting the Redemption tab of the reward edit screen.

Editing an incentive is immediate and applies to all unredeemed vouchers

The incentive configuration is stored in the reward's configuration, not in the associated benefit that is created whenever a user purchases the reward.

As such, the Validate voucher code endpoint will always return the current, live incentive(s) specified in the reward configuration—not the incentive that was applicable at the time a benefit was issued.

This means when you edit an incentive in a reward, any benefits created by that reward which have not yet been redeemed or validated, will receive the new incentive.

As such, the general recommendation is that if you want to change an incentive you should archive the existing reward and create a new one with the new incentive on offer.