The Loyalty Wallet

Overview

The loyalty wallet is where a logged-in member sees everything they've earned with you — their membership card, vouchers, store credit, points, and stamp cards. It's the heart of the member app, and it mirrors the programs you build in the admin console.

The wallet only shows what the member actually has. Each section appears as a chip, and a chip is hidden if the member has nothing of that type. A brand-new member who's only just joined may see almost nothing; the wallet fills in as they earn.

This is the customer's view

Everything on this page is what your customers see and do — it's the other side of the programs you configure. Each section links to the admin page where you set it up. For the staff-facing equivalent at the till, see What Members See.

The wallet chips

A logged-in, non-guest member sees up to five chips, each opening that part of their wallet:

Chip	Shows	Hidden when
Membership	The member's membership card and tier benefits.	The member holds no membership.
Voucher	The member's vouchers, plus a Redeem Voucher button.	The member holds no vouchers.
Store Credit	Credit balance with Buy / Gift / Transaction actions.	The member has no credit, or store credit is closed.
Point	Loyalty balance with Point detail / Gift / Transaction actions.	The member has no points.
Stamp	The member's stamp cards.	The member holds no stamp cards.

The wallet uses your brand colour throughout. Store Credit is also hidden whenever you've closed store credit for the merchant (the IsClosedStoreCredit setting).

Membership card

The Membership chip shows the member's membership card — their tier name, image, and an Active badge. The card is flippable: tap it to turn it over.

Tapping into the membership opens a benefits drawer showing what the tier is worth:

• Discount / cashback tiles — the perks attached to the tier, shown as plain values like 10% or $5.
• How it works — a rich-text description you write for the tier, explaining the benefit in the member's own language.

Members are shown their tiers in order, sorted by the tier level, so a sequential climb (Silver → Gold → Platinum) reads top to bottom. Only tiers with Show on Member App enabled appear here.

Add to Apple / Google Wallet

If you've enabled the wallet pass feature for the merchant, the membership card carries an Add to Apple Wallet or Add to Google Wallet button — whichever matches the member's device. The member taps it to save a pass to their phone's native wallet.

Wallet pass is opt-in

The Apple / Google Wallet button only appears when wallet passes are enabled for your merchant (isWalletPassEnabled). If you haven't turned it on, members just see the in-app card.

Points

The Point chip shows the member's loyalty balance using your program's unit name and format — for Bean & Brew that's Beans, not "points". Whether the balance shows decimals or is floored to a whole number depends on your loyalty program unit (isDecimal).

Point detail

Tapping Point detail opens the point modal, which splits the balance in two:

• Active — points the member can spend now.
• Inactive (pending) — points earned but not yet released, shown with a next-available date ("will be available on …").

This split comes from your program's portion settings — see Loyalty Points for how earned points are released over time.

Earning points

Members earn points through POS and loyalty transactions. Earning happens on Rewardly's server after payment — never on the POS screen — and the new balance appears in the wallet in real time. Amounts can be decimal or floored depending on the program unit.

Redeeming points

A member can spend points three ways:

1. At checkout — paying part or all of an online order with points, when your loyalty redeem channels include the member app and the outlet allows point redemption.
2. Buying vouchers — a voucher can carry a price in points.
3. The merchant Redeem scan — if you allow members to redeem loyalty themselves, the merchant detail screen shows a Redeem button that produces a code for your POS staff to scan and apply at the till.

Redeem needs a balance and a joined member

The self-service Redeem scan only works for a member who has joined the merchant and has a loyalty balance above zero. A guest, or a member with no points, gets an info prompt instead.

Gift point

Gift point lets a member transfer points to another member. It opens a gift sheet seeded with their current balance and the program unit name. A successful gift refreshes both members' wallets.

Point transactions

Transaction opens the member's point history, split into three tabs:

Tab	Shows
Collect	Points earned or reloaded.
Gift	Points gifted, with the recipient.
Spends	Points redeemed.

Each row shows the signed amount in your program-unit name, an optional expiry date, and the available date.

Vouchers

The Voucher chip is an infinite-scrolling list of the member's vouchers. Tapping a voucher opens its detail; a Redeem Voucher button opens a modal listing the vouchers the member can buy.

Voucher detail

A voucher's detail page shows its image, name, type and value, and the fine print:

Field	What the member sees
Type & value	Cash ($), discount (%), free item, fixed-price item, free modifier, lowest-priced combo item free, and more.
Purchase cost	Free, a price in points, or a price in store credit.
Limits	Per-member purchase limits (the personal margin).
Outlets	The outlets where it can be used — an expandable list.
Terms	Terms and conditions you've written.
Eligible products	The products the voucher applies to.

Buy, Use now, Gift

The actions a member sees depend on the voucher's state:

• Buy — purchase the voucher with points or store credit, gated by sufficient balance, the right redeem channels, and any margin limit.
• Use now — for an owned free-item, fixed-price, or item-discount voucher: it saves the product selection and carries the member straight into the order flow, auto-skipping outlet selection if there's only one outlet.
• Gift — transfer the voucher to another member, available only while it's unused and unexpired and the voucher allows gifting.

Use now needs an order-enabled outlet

Use now requires at least one outlet that accepts online orders. If none do, the voucher shows "Redeem voucher in store" instead.

Event vouchers can't be bought

Birthday and First-time-shopper event vouchers are issued by the program, never purchased — there's no Buy button on them. (If the member hasn't set a birthday, birthday vouchers are filtered out of their wallet entirely.)

Shopify discount code

If your merchant is connected to Shopify, a cash voucher's detail can generate a Shopify discount code — the member creates, copies, or voids a code to use on your Shopify storefront.

Expired, used, and claimed states

• Expired / used vouchers are greyed out and labelled Used or Voucher Expired <date>.
• Barcode vouchers (scanned) and URL-claimed vouchers (from a gift link) auto-claim into the member's wallet, then open the voucher detail.

Store credit

The Store Credit chip shows the member's store credit balance in your currency, with three actions:

• Buy credit — opens a top-up popup listing your store-value products (e.g. $50 for $45 tiles). The member picks one or more and taps BUY to add the top-up to a cart for payment.
• Gift credit — transfer credit to another member.
• Transaction — opens the credit history.

Store credit transactions

The history is split the same way as points:

Tab	Shows
Collect	Credit added — top-ups, cashback, rewards (shown in green).
Gift	Credit gifted to or from other members.
Spends	Credit spent (shown in pink).

Each entry shows the signed amount, an optional expiry date, and the available date.

Store credit can be switched off

If you've closed store credit for the merchant, the Store Credit chip and its top-up products don't appear in the wallet at all.

Stamp cards

The Stamp chip shows the member's stamp cards. Each card displays its progress as X / N stamps collected.

Tapping a card opens its detail: the program image and name, a How it works description, the current progress, an expiry date for the card, and a grid of challenge cells (stamped vs not). Tapping a cell opens its detail. Milestones with gifts are tracked per challenge level, so the member can see what they unlock as they fill the card.

Cashback and discount programs

Cashback and discount programs aren't wallet chips — a member opens them from the merchant's program list.

A cashback detail page shows the program image and name, a link to the merchant, a How it works description, and:

Field	What the member sees
Amount / percent	The cashback as a fixed $ amount or a %.
Condition	When it applies — e.g. $min – $max, "buy product × N pcs", or "applicable to all transactions".
Membership	The tier the cashback applies to.
Expiry	The program's expiry date.
History	A sortable list of the member's cashback earnings.

My Rewards

My Rewards is the member's list of every merchant they've joined — their memberships across all of Rewardly, not just yours. It can be filtered by With purchases, No purchases, or All. Tapping a merchant opens that merchant's activity. (In single-merchant mode — your own subdomain — the member mostly stays on your screens, but the cross-merchant view is still there in the aggregator app.)

The membership QR

Every member has a personal membership QR code they can show at your counter so staff can pull up their account. The QR carries a short-lived token and runs a live countdown — once it expires it shows "QR code is expired" with a refresh button. The screen also shows your logo, the merchant name, and the member's phone number.

The QR refreshes itself

Because the token is short-lived, a member who leaves the QR screen open may need to tap refresh before showing it. This is by design — it stops an old screenshot being reused.

Related

• Customer App Overview — the whole member app at a glance.
• Online Ordering — where members spend points, credit, and vouchers at checkout.
• Profile & Referrals — account settings and refer-a-friend.
• What Members See — the staff-side view of the same wallet at the till.
• Membership · Loyalty Points · Vouchers · Store Credit · Stamp Cards — the programs behind each chip.