One loyalty program for the 12 Team, piloted at 12 Urban Café. Every member is a contact in FlowHub. The guest keeps a card with a QR code on their phone; the team scans it at the till; every bill adds cashback to the guest's balance; the balance pays up to half of a future bill; FlowHub sends the messages and shows everything in the 12 Urban dashboard.
Fine print. Cashback is calculated on the food and drinks subtotal, before service charge (the 12 Kitchen rule). The balance never converts to cash and is not combined with fixed-price promotions. One account per person. Each earned amount expires 30 months after the visit; when a whole balance expires, the member drops one tier. A tier earned this year is kept through next year; in January the year before that is reviewed. Fraud guard: maximum 2 scans per member per day.
Same rules as 12 Kitchen & Wine. Only the team PIN list is still needed.
| Option | Cost | Works today? | Notes |
|---|---|---|---|
| Card page saved to the home screen (PWA) | Free | Yes, built | Works on iPhone and Android. Live balance and tier, offline QR. One tap more than a wallet card. This is what we pilot. |
| Google Wallet | Free | Demo mode now, public after review | Issuer account in demo mode issues "[TEST ONLY]" passes at once. Public passes after Google reviews the business profile (days to 2 weeks). Balance and tier update on the pass. |
| Apple Wallet | US$ 99 / year | Needs Apple Developer Program | No free route: every pass must be signed with a certificate from a paid account in the restaurant's name. Library: passkit-generator (MIT). |
Migration is safe in every case: the member record is the FlowHub contact and the QR encodes our own signed member token, so a wallet card is just another way to show the same QR.
Now (no integration needed): redemption = NON CASH tender in ESB for the amount the scanner shows; the scanner is the record of truth for balances.
Next: nightly sales export or OMS API (bill number, subtotal, tenders, member code) matched against the ledger to catch missed scans and wrong amounts, and to credit visits automatically. Access requested from ESB care.
| Piece | State |
|---|---|
| FlowHub data model (16 fields, tags, member counter, ledger object with Earn / Redeem / Bonus / Expire) | Done, provisioned by script (reusable for 12 Kitchen) |
| Join page, member card with QR (PWA), staff scanner (PIN per person, camera, phone lookup, redeem) | Built, 27 unit + 45 end-to-end checks pass with fake members |
| Engine: cashback balance, 50 % redemption, welcome bonus, 3 annual tiers, 2.5-year expiry, idempotent visits | Built and tested |
| Booking page: join tick box + member recognition | Built (local) |
| Daily expiry job and yearly tier review | Scripts ready, to schedule after deploy |
| Workflows: welcome + card link, balance reminders, tier upgrade, birthday, expiry warning, win-back | To build in FlowHub (UI), draft until approved |
| Shared store (Upstash) for locks and rate limits, deploy (rewards.12urbancafe.com) | After approval |
| Google Wallet issuer, Apple Developer account, ESB export / API access | Owner decisions |
Local prototype · nothing deployed · test members only (+1 555 555 01xx).