How to use the Loyalty Playground

  1. Step 1 – Scan a QR code

    Decide which role you want to test:

    • Merchant: Scan the Join as merchant QR code.
    • Client: Scan the Join as client QR code, or toggle Simulate a client to add a demo user instantly.
  2. Step 2 – Watch the client appear (look for the code)

    • Every client entry shows an avatar, handle and a 3-digit code (e.g. 680).
    • If more than one customer scans in, ask the customer for their code and click the matching row so you reward the right person.
  3. Step 3 – Give a reward

    • Select the client row that matches the 3-digit code.
    • Click +50 / +100 / +200 to award sandbox points.
  4. Step 4 – Vouchers (optional)

    • A client taps Activate voucher in their wallet; the voucher line turns orange.
    • The merchant taps the same voucher once to redeem it.
    • Tap again before redeeming to cancel (undo) the activation.

FAQ

Do I need two phones to try both roles?

No. Use one device as the merchant and enable Simulate a client for a dummy customer.

What does “Simulate a client” do?

It instantly spawns a fake client so you can practice awarding points without a second device.

How do I pick the right client when several are on‑screen?

Ask the customer for the 3-digit code displayed on their phone and select that code in the list.

Can I undo a bonus once it’s sent?

Not in this demo. Refresh your browser to reset the state.

Can I cancel a voucher activation?

Yes. Tap the orange voucher again before redeeming and it returns to idle.

Where can I see the client’s point balance?

The public playground doesn’t show balances yet. The full mobile wallet will display them for the customer.

Are the +50/+100/+200 buttons the only reward options?

No. They’re placeholders for the sandbox. In production you can define percentage‑based rewards, fixed points per visit, or any custom rule.

Is the playground connected to real data?

No. It’s a safe, self‑contained demo — refresh to erase everything.