Partner setup and pass design.

Enabling Google Wallet on a card

Google Wallet is available to your account when your plan includes it (Gold and Platinum by default) or your admin grants it to you. Then you enable it on individual cards.

1. Go to Loyalty cards, Stamp cards, or Vouchers
2. Click Edit on the card you want to enable
3. Go to the Details tab
4. Find the Google Wallet toggle and switch it on
5. Save

If you do not see the Google Wallet toggle, Google Wallet may not be part of your plan, your admin may not have granted it to your account, or the app's Google Wallet credentials may not be configured yet. Contact your administrator.

Members who are enrolled in this card will now see an "Add to Google Wallet" button on their card view.

How your card appears in Google Wallet

Google Wallet passes reuse the visual elements you already configured on your cards. You need no extra design work. Here is which field each pass type uses.

Loyalty cards

┌─────────────────────────────────────┐
│  [Logo]  Partner Name               │  ← Logo image + partner name
│                                     │
│  Card Title                         │  ← Card title
│                                     │
│  points                             │
│  2,000                              │  ← Current point balance
│                                     │
│       ┌───────────┐                 │
│       │  QR Code  │                 │  ← Staff earn-points URL
│       └───────────┘                 │
│    Member Identifier                │  ← Member code
│─────────────────────────────────────│
│   Background Image                  │  ← Background image (hero)
│                                     │
└─────────────────────────────────────┘

Logo and background image are the images you upload on the card's Media tab. See Creating Cards for image requirements.

Stamp cards

┌─────────────────────────────────────┐
│  [Logo]  Partner Name               │  ← Logo image + partner name
│                                     │
│  Partner Name                       │  ← Subheader
│  Stamp Card Title                   │  ← Card title (large)
│                                     │
│       ┌───────────┐                 │
│       │  QR Code  │                 │  ← Staff add-stamps URL
│       └───────────┘                 │
│                                     │
└─────────────────────────────────────┘

  Progress: 3 / 10                     ← Current stamps / required
  Reward: Free Coffee                  ← Reward title

Stamp cards use Google's Generic pass type, which does not support a hero image. Only the background color and logo appear. See Designing Your Cards for logo specifications.

Prepaid passes

┌─────────────────────────────────────┐
│  [Logo]  Partner Name               │  ← Logo image + partner name
│                                     │
│  Partner Name                       │  ← Subheader
│  Pass Name                          │  ← e.g. "10-Visit Wash Pass"
│                                     │
│       ┌───────────┐                 │
│       │  QR Code  │                 │  ← Staff use-pass URL
│       └───────────┘                 │
│                                     │
└─────────────────────────────────────┘

  Visits left: 6 / 10                  ← Remaining / total (or Unlimited)
  Expires: Jul 10, 2026                ← Valid until date (if set)

Prepaid passes use Google's Generic pass type, like stamp cards, so no hero image appears. Each sold pass is its own Google Wallet object: a member holding two passes of the same product can save both. Enable the toggle per pass product on its Details tab.

Vouchers

┌─────────────────────────────────────┐
│  [Logo]  Partner Name               │  ← Logo + partner name
│                                     │
│  Voucher Title                      │  ← e.g. "Free Pastry"
│                                     │
│       ┌───────────┐                 │
│       │  QR Code  │                 │  ← Staff redemption URL
│       └───────────┘                 │
│    Voucher Code                     │  ← e.g. CAFDCBAB6
│─────────────────────────────────────│
│   Background Image                  │  ← Background image (hero)
│                                     │
└─────────────────────────────────────┘

  Expires: Feb 1, 2027                 ← Valid until date
  From: The Daily Grind                ← Partner name

Logo and background image are the images you upload on the voucher's Media tab. See Voucher Card Design for image requirements.

Design tips for Google Wallet

• Upload a logo. Passes without a logo show a generic icon or the first letter of your business name. A proper logo makes your pass recognizable.
• Choose a good background color. This is the most visible element. It fills the top half (or full card for stamp cards). Use your brand color.
• Add a background image. For loyalty cards and vouchers, the background image appears as a large hero below the QR code. Use a high-quality, relevant photo (product shots, your storefront, lifestyle imagery).
• Images must be publicly accessible. Google fetches your images from your server. Images served from localhost or private networks will not load. See Local Development below.

What members see

• A localized "Add to Google Wallet" button on every card, stamp card, voucher, or prepaid pass that has Google Wallet enabled
• The button is always visible, even before the member has followed or enrolled in the card
• Tapping the button auto-enrolls the member (if not already enrolled) and opens Google Wallet
• The pass shows the card name, current points, stamp progress, or visits left, and a QR code
• Pass data updates when points are earned, stamps are collected, or a voucher is redeemed

No enrollment or transactions are required to see the button. The member does not need to follow the card first. Clicking the button handles enrollment.

When the button does not appear

The "Add to Google Wallet" button has three conditions, all of which must be met:

1. Platform credentials configured: the issuer ID and service-account credentials are set in Settings → Integrations or .env
2. Plan entitlement: the partner's plan includes Google Wallet (has_google_wallet, Gold and Platinum by default), or an admin granted it per-partner
3. Card toggle: partner has enabled Google Wallet on the specific card

If the button is missing, check these three conditions in order.

Button behavior by member state

Disabling Google Wallet

Toggle the switch off and save. All issued passes for that card will be revoked. Members' saved passes will show as inactive.