Platform

Managing Rewards

The Rewards section lets you create and manage the items customers can redeem with their accumulated points: discounts, free products, and more.


Rewards list

Navigate to Rewards in the sidebar. The list supports two view modes:

  • Grid view: reward cards showing image, name, point cost, and availability
  • Table view: sortable columns for name, type, points cost, stock, status, and actions

Filters

  • Status: Active, Inactive, or All
  • Type: Discount, Free Product, or All

Creating a reward

Click Create to set up a new reward.

Reward type

Choose between two types:

TypeDescription
DiscountA monetary discount on a future purchase
Free ProductA complimentary product or service

Common fields

FieldRequiredDescription
NameYesReward name displayed to customers
DescriptionNoDetailed description
Point CostYesNumber of points required to redeem
ImageNoUpload a reward image (displayed in grid view and POS)
Total StockNoMaximum redemptions available (leave empty for unlimited)
Available FromNoStart of availability window
Available UntilNoEnd of availability window
Code Valid ForNoHours the confirmation code remains valid after redemption
BranchesNoWhere the reward can be redeemed. Empty means every branch
StatusYesActive or Inactive

Discount-specific fields

When the type is Discount, additional fields appear:

FieldDescription
Discount TypeFixed Amount (EUR off) or Percentage (% off)
Discount ValueThe discount amount or percentage

Free product-specific fields

When the type is Free Product:

FieldDescription
Product ReferenceInternal reference to the free product (used by POS integration)

Editing a reward

Click Edit to modify any reward. All fields can be updated. Changes take effect immediately for future redemptions.


Stock management

  • Total Stock: the total number of times this reward can be redeemed. Leave empty for unlimited.
  • Remaining Stock: displayed in the list, decrements with each redemption
  • When stock reaches zero, the reward is no longer available for redemption through the API or portal

Availability windows

Set Available From and Available Until to limit when a reward can be redeemed. Outside this window, the reward does not appear in the API's reward list and cannot be redeemed.


Where a reward can be redeemed

Pick nothing under Branches and the reward can be redeemed at all of them. Pick one or more and it can only be redeemed there. Everywhere else it is refused, whichever way the redemption arrives.

  • In the portal, the redeem dialog on the customer page asks where the redemption happened. For a restricted reward the question is required and only its own branches are offered.
  • Over the API, POST /api/v1/redemptions takes a branch key and refuses the call with BRANCH_REQUIRED (422) when none is given or the one given is not on the reward. See Rewards & Redemptions.

If you have no branches yet, the field is replaced by a link to Branches, where you add them.

Narrowing an existing reward's branches takes effect on the next redemption. Redemptions already recorded keep the branch they were filed under.


Deleting a reward

Click Delete and confirm. Past redemptions of this reward are preserved in customer history.