12 Urban CaféTwelve Rewards · program map

Twelve Rewards: how it works

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.

The guest journey

GuestJoins in 30 secondsQR on the table, link on the booking page, Instagram or WhatsApp. Name, WhatsApp, email, birthday, Bali stay. Gets an Explorer card at once; the program activates on the first paid visit.
FlowHubBecomes a contactMember number, tier, balance, visits, spend, joined and activated dates are contact fields; tags loyalty-member, loyalty-tier-explorer. A workflow sends the card link by email + WhatsApp.
TeamAsks every guest at the bill"Are you a Twelve Rewards member?" Not yet: show the join QR (free, Rp 100,000 welcome bonus). Member: scan the card, read the balance, ask "save it or use it today?".
TeamRecords the visitBill number + food & drinks subtotal. If the guest redeems: the amount goes into the POS as a NON CASH tender, the rest is paid as usual. The scanner shows exactly what to tell the guest.
EngineBalance and tier update5 / 10 / 15 % of what the guest paid lands in the balance, valid 2.5 years. First visit adds the Rp 100,000 bonus (usable 3 h later). 10 visits or Rp 3M in a year: Friend. 40 visits or Rp 10M: Family.
FlowHubMessages go outWorkflows on tags and fields: welcome + card, "Rp 85,000 waiting for you", tier upgrade, birthday treat, balance about to expire, win-back after 45 days without a visit. Email + WhatsApp (SMS channel).

Everything lives in FlowHub

  • Contact fields: Member NoTierBalance (IDR)VisitsVisits this yearSpend this yearLifetime spendJoinedActivatedLast visitBali stay
  • Tags drive the automations and segments: members, active, tier, stay type.
  • Each visit is a note on the contact and a Loyalty Transaction record (Earn, Redeem, Bonus, Expire, Adjust): the ledger is the source of truth and feeds the dashboard.
  • Smart lists: Friends and Family, balances about to expire, members without a visit in 30 days, birthdays this month.

Connected to the booking page

  • Reservation form: "Join Twelve Rewards" tick box creates the member with the booking (server-to-server, signed).
  • A member who books is recognised: the confirmation shows tier, cashback and balance.
  • Same contact, so the reservation reminder and the loyalty messages never clash.
  • Later: visits reconciled against the POS sales export, so a missed scan is caught the next morning.

Program rules (12 Kitchen & Wine model, applied to the whole 12 Team)

Explorer (from the first paid visit)5% back
Friend (10 visits or Rp 3M in a year)10% back
Family (40 visits or Rp 10M in a year)15% back
Welcome bonus, after the first visitRp 100,000
Balance paysup to 50% of a bill
Balance valid2.5 years
Tier kept forthe year + the next
Member numbersTW-1001…

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.

Till procedure (same as the 12 Kitchen SOP)

  1. Before printing the bill, ask every guest: "May I ask if you are a member of Twelve Rewards?"
  2. Not a member: show the join QR. "Registration is free and includes a Rp 100,000 welcome bonus for your next visit."
  3. Member: open the Staff scanner (your PIN), scan the QR on the guest's phone or search by WhatsApp number.
  4. Read the balance out loud. Ask: "Would you like to save it, or use it today? You can use up to half of the bill."
  5. Type the bill number and the food & drinks subtotal. If the guest redeems, type the amount (or tap Max).
  6. In the POS: tender the redeemed amount as NON CASH, then take the rest by cash, card or QRIS. Never close the bill before recording the visit.
  7. Tap Record visit and read the green box to the guest: what was redeemed, what was earned, the new balance.
  8. Hand over the receipt and thank them as a member. The card on their phone already shows the new balance.

Wallet cards: what is free and what costs

OptionCostWorks today?Notes
Card page saved to the home screen (PWA)FreeYes, builtWorks on iPhone and Android. Live balance and tier, offline QR. One tap more than a wallet card. This is what we pilot.
Google WalletFreeDemo mode now, public after reviewIssuer 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 WalletUS$ 99 / yearNeeds Apple Developer ProgramNo 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.

POS (ESB) tie-in

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.

Status

PieceState
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 visitsBuilt and tested
Booking page: join tick box + member recognitionBuilt (local)
Daily expiry job and yearly tier reviewScripts ready, to schedule after deploy
Workflows: welcome + card link, balance reminders, tier upgrade, birthday, expiry warning, win-backTo 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 accessOwner decisions

Local prototype · nothing deployed · test members only (+1 555 555 01xx).