The customer's loyalty provider earned and spent at the till
The customer asks: Our loyalty provider's members earn on every sale and spend their balance at the till
- Verdict: Ready, with limits (4)
- Door: Outside app · area: Customers and loyalty › Loyalty, gift cards and wallets
- Recipe: A loyalty provider connected to the till
- Sample: S22 — Customer-owned loyalty (pp_lyl): your logic outside, the records inside the shop
- Checked: read 2026-10-22 in the event feed, wallet and capture recipes and contracts · the three together not run (no sample calls a provider)
What you build
Your outside app between the shop and the provider: earning from the event feed, spending through the wallet, and a one-time code where the provider asks for one. The provider's account and keys stay on your server.
Limits
- The combination is not run: no sample calls a provider.
- A sale earns seconds after it books, not inside it.
- The wallet is online only: an offline till does not offer it.
- Going live needs a CERTIFIED conformance report: ask CitiXsys first (the wallet recipe, Certification).
Tell the customer
Every booked sale of a member earns in your provider's programme, and members spend their balance at any till that is online.
What next
- Tell the customer the 4 limits above, and write them into the proposal.
- Follow the recipe: A loyalty provider connected to the till.
- Copy the sample: S22 — Customer-owned loyalty (pp_lyl): your logic outside, the records inside the shop, and change it.
- Build and test it on your sandbox (request one if you have none; what is on it).
- Run the checks: your own tests, the kit's checks and the money kit's release gate (testing and release).
- Release through the customer's own release gate (14. Testing and release); an app other shops install goes through the App library.
Stop your service for a while and start it again: it must catch up from the event feed, missing nothing.
Related needs
- Change the limits and who is told in one settings page, not in each rule — Ready, with limits (3)
- Customers spend their cash back, store credit or loyalty points balance at the till — Ready, with limits (2)
- Every booked sale earns loyalty points in our own programme — Ready, with limits (2)
- A report of each member's cash balance for any dates, with the opening and the closing figure — Ready, with limits (3)
Start a project shortlist with this need · Put it in your blueprint · Every need