Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Learn wallet fundamentals

Learn how Apple Wallet and Google Wallet passes work and the six pass types The Wallet Crew supports, from loyalty cards to generic passes.

Overview of wallet fundamentals across Apple Wallet and Google Wallet.
Wallet fundamentals start with the same principle on both platforms: one pass stays easy to save, easy to find, and easy to present.

Customers add passes to their wallet because it keeps the most-used items (loyalty cards, tickets, offers, and more) at their fingertips without digging through emails, apps, or physical cards. Mobile wallets also securely store customers’ bank cards, which makes wallet apps a daily habit. Branded passes fit naturally into that routine and keep the brand visible each time customers open their wallet.

Instant access at checkout or entry

Most Apple Wallet passes and Google Wallet passes are redeemed with a barcode or QR code. Some use NFC when compatible scanning hardware is available. Customers open the pass and present it in seconds.

Always up to date

A pass is not a static PDF. An Apple Wallet pass and a Google Wallet pass can refresh over time. This matters when points change, balances decrease, or ticket details update.

Updates are part of the core lifecycle. For update mechanisms and delivery constraints, see Push notifications. For identifiers and data model basics, see Pass data and sync.

Pass types you can configure in The Wallet Crew

The Wallet Crew lets brands create templates for several Apple Wallet pass and Google Wallet pass types. Each pass type comes with Apple and Google constraints. The template then defines layout, fields, images, and barcode. Wallet apps also store payment cards (Apple Pay, Google Pay), which The Wallet Crew does not manage: see Understand the platform.

When the template choice is unclear, Pass types & templates helps narrow down the right starting point. The template is then configured in the pass template editor.

Pass type
Best for
Key fields
Typical redemption

Loyalty card (Customer card in the admin console)

Points, tiered membership, account identification at POS

Member ID, barcode/QR, points balance, tier/status, key links

Scan at checkout to identify the customer, then update points/tier

"Buy N, get one free" programs

Stamp count, stamp goal, reward

Scan at checkout, apply a stamp, grant the reward (if one is set) when the goal is reached

Events with controlled entry and a "scan at gate" workflow

Event name, date/time, venue, seat/section, gate, barcode/QR

Scan at the entrance to validate entry and prevent duplicates

Stored value that decreases over time (balance use, top-ups, refunds)

Card number, balance + currency, barcode/QR (or NFC), expiry date

Scan at checkout, apply a partial or full amount, then update the balance

Discounts, promo codes, and short campaigns with clear expiry rules

Offer title, expiry date, conditions, barcode/QR or promo code

Scan in-store or enter the code online, then mark as redeemed

Membership cards, staff badges, warranty cards, pickup credentials, and "other"

A stable identifier, barcode/QR, status, key facts, support links

Visual check or scan, depending on the workflow

Loyalty card

A loyalty card (Customer card in the admin console) is a loyalty program Apple Wallet pass / Google Wallet pass. It rewards customers for coming back and can be an entry point to a customer account, which helps centralize data and personalize experiences. Customers see their status and rewards in seconds, with no card number to remember and no plastic to bring.

Real-world examples
  • Retail: points balance and tier (Silver/Gold) updated after each purchase.

  • Beauty: member ID used at checkout, plus birthday reward shown as a field.

More details: Loyalty card.

Stamp card

A stamp card is a loyalty-style pass that counts stamps toward a goal. The pass shows the progress. When the template names a reward benefit template, the reward benefit is granted when the goal is reached.

Real-world examples
  • QSR: stamp card (buy 8, get 1 free) with progress displayed on the pass.

More details: Stamp card.

Event ticket

An event ticket is an access-control Apple Wallet pass / Google Wallet pass, built for fast scanning at the entrance. Dematerializing tickets reduces loss and fraud risks and speeds up entry, and the same installed ticket can be updated when the seat, the gate or the schedule changes. Attendees add the ticket from an email link, from a ticketing website, or by scanning a QR code on-site.

Real-world examples
  • Concert: seat info + QR scanned at the gate, with "doors open" time on the pass.

  • Museum: timed entry ticket, where the date/time changes after reschedule.

  • Festival: multi-day pass, with the same pass updated each day with new info.

More details: Event ticket.

Gift card

A gift card is a stored-value Apple Wallet pass / Google Wallet pass, redeemed over time. The key requirement is keeping the balance accurate after each redemption, top-up or refund. For brands, gift cards generate revenue upfront and are a strong acquisition channel, because they are often given to someone else. For customers, the pass shows the current balance and a scannable code, and cannot be lost like a plastic card.

Real-world examples
  • Retail: gift card issued with €100, then balance updated after each redemption.

  • Hospitality: voucher sold online, used in multiple partial payments on-site.

  • Customer care: goodwill credit added as a top-up, then spent over time.

More details: Gift card.

Offer

An offer is a coupon-style Apple Wallet pass / Google Wallet pass, used for discounts and time-bound incentives. Offers are often redeemed once, then become invalid. They can be issued to different audiences, and stopped or expired without a reinstall. The pass shows the expiry date and conditions, with a scannable code or a code to enter online.

Real-world examples
  • Retail: "-20% this weekend" coupon with an expiry date and single-use barcode.

  • E-commerce: promo code shown on the pass, redeemed in checkout.

  • CRM: win-back offer sent to inactive customers, then marked as redeemed in POS.

More details: Offer.

Generic

Generic is the most flexible Apple Wallet pass / Google Wallet pass type. It fits credentials that do not match a dedicated template and must be shown or scanned. Fields and display order are fully configurable. It works like any other pass: easy to add, easy to find, and updatable when details change.

Real-world examples
  • Staff badge: employee name + role + QR for door access.

  • Warranty card: product serial number + purchase date + support link.

  • Click & collect: pickup credential with order ID + barcode for retrieval.

More details: Generic.

FAQ

Can multiple pass types be used in one project?

Yes. Many brands start with one pass type (often loyalty) and add others later. Pass types can share the same distribution channels and operational setup.

Do passes work offline?

Usually yes for the moment of use. The barcode/QR and the visible fields are stored on the phone. Updates still require connectivity at some point to sync.

What’s the difference between an Offer and a Gift card?

Offers are for discounts and coupons. Gift cards are for stored value and balance updates. If the value can go down over time, it is almost always a Gift card.

For installing without a mobile app, updating an installed pass and storing personal data, see Understand the platform.

Last updated