L
LoyaltyDocs

Centres & Store Separation

Keeping points at the centre that issued them, the centre list, and what changes on every call once separation is on

A hospital group rarely wants points earned at one centre to be spent at another. Store separation keeps every point at the centre that issued it — and once it is on, every loyalty operation says which centre it comes from.

The Settings — Settings → Centres

Setting

Your options

Default

Keep points at the centre that issued them

Off — points are held in one wallet and can be spent anywhere, so centres only say where a purchase happened / On — every reward and redemption must name a centre, and points are only spendable where they were earned

Off

Centres

Any number of centres, each with a centre name and a code — the code is what your billing system sends; codes must be unique

Empty

Unit shown when a transaction has no centre

What app orders and other centre-less transactions show in the points logs — “Mobile app”, for example

Blank

What Changes When Separation Is On

  • Every call that touches a customer's points — look-up, points summary, calculate, confirm, redeem, validate, release, reverse, bonus, penalty, adjust — carries a store_code from your centre list. A call without one, or with a code that is not on the list, is refused. In the app, the Reward and Redeem dialogs ask for the centre.
  • The points summary and the usable balance are scoped to that centre: a customer with 500 points at Centre A and 200 at Centre B sees 500 when served at A.
  • A redemption at a centre can only spend points earned there, plus any points that carry no centre.
  • Points earned before separation was switched on carry no centre and stay spendable anywhere.
  • Upload sheets must name a centre per row; rows with an unknown code are rejected before anything is credited.

Editing the Centre List

  • The list is replaced as a whole on every save; codes stay unique.
  • Removing a centre only hides it from the pickers — points already earned there keep their code and stay attached to it.
  • The list is cached for five minutes and refreshed on every edit, so a new centre appears on the next call.
  • With separation on and no centres, points cannot be earned or spent anywhere — add at least one.

Decide it at launch

Turning separation on is a one-way decision for reporting: points issued while it was off never gain a centre. Decide it before the first bill, or accept a shared pool for the history before the switch.

Referrals and centres

A referee's capture records the centre where they were captured, and stage rewards carry the centre of the business event that fired them — so referral points follow the same rule as everything else.

For developers

[List centres](https://prod.freecustomer.in/api/v2/docs#tag/loyalty/GET/api/v2/loyalty/configuration/stores) and [update centres](https://prod.freecustomer.in/api/v2/docs#tag/loyalty/PATCH/api/v2/loyalty/configuration/stores) — `stores` replaces the whole list; `default_unit_label` null removes the label.

Was this page helpful?

Last updated on

On this page