> ## Documentation Index
> Fetch the complete documentation index at: https://vexioncards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# The customer's wallet pass

> What a customer actually sees: the card in Apple Wallet or Google Wallet, and the notifications they receive.

When a customer adds one of your cards, it lives in **Apple Wallet** (iPhone) or **Google Wallet** (Android) as a pass, with no app to download and no plastic to lose. This is the card your customer carries, and it updates itself every time you scan them. This page explains exactly what they see, so you know what you are designing when you [create a card](https://vexioncards.mintlify.site/knowledge-base/creating-a-card.md).

> [!NOTE]
>
> While you build a card, the panel on the right is a **live preview** of this pass. Everything below is what that preview becomes on the customer's phone.

## What every pass has

Whatever the card type, the pass always shows:

* **Front**: your **background** (image or colour) and **logo** as you designed them, the customer's **name**, and the **QR code** staff scan at the till. (A redeemed coupon without a linked card and an expired gift card show no scannable code, since there is nothing left to scan.)
* **Back** (the "..." on Apple Wallet, the card details on Google Wallet): the information from the card's **Card Information** step and the customer's own record:
  * **View profile** (Apple Wallet: the first line on the back; Google Wallet: a button on the card). It opens [the customer's own profile](https://vexioncards.mintlify.site/knowledge-base/customer-wallet-profile.md). Cards issued through Bookio, BooqMe, Omega or Medlin do not have it.
  * **Company Name.**
  * A **[review link](https://vexioncards.mintlify.site/knowledge-base/google-review.md)** (shown as "⭐️ Rating ⭐️" on Apple Wallet; on Google Wallet it is a button on the card). It appears after the customer's **first in-store visit**, only while the **Feedback** automatic message is on, and on **Automatic** it points at the review page of the store *they* joined at. Plus any **business links** you added (website, Instagram, Facebook).
  * **Customer Name**, **Customer Email**, **Date of Birth**, and **Card ID**.
  * If **referrals** are on: "How referrals work", plus "Referred friends" and "Bonus earned".
  * **Terms**, if you added them.
  * **Last message**: the most recent note or campaign message sent to this customer.

> [!TIP]
>
> The back of the pass is prime space most businesses forget. Filling in your links, your review link, and clear terms turns the loyalty card into a permanent shortcut to your business on the customer's phone.

## What each card type shows

On top of the shared fields above, each card type fills the front and back with its own numbers. Here is exactly what appears, by type.

> [accordion] Stamp
>
> **Front:** Name, and **Stamps of 10** (the current count). The number is your card's own goal: a 5-stamp card says "Stamps of 5".
> **Back:** **To reward** (for example "7 stamps to go", or "Reward is ready") and **Available rewards** (completed cards not yet redeemed).

> [accordion] Stamp, paid in advance
>
> **Front:** Name, and **Remaining stamps** (how many the customer can still use).
> **Back:** **Valid for** (the card text you wrote, for example "10 coffees"), when you wrote one.

> [accordion] Reward (products)
>
> **Front:** Name, **Points**, and a line at the top that says what the customer can do now: **Next reward** (how many points are still missing) or **To choose** (how many rewards are ready, for example "2 rewards"). A card with a single reward shows **Reward: 🎁 Ready** instead.
> **Back:** **Next reward** (for example "Breakfast: 250 points to go"), **Rewards** (every reward with its point cost: 🎁 means the customer can take it now, ⏳ means not yet), and **How it works**.

> [accordion] Reward (products) with levels
>
> **Front:** **Points** in the top corner, Name, and **Level** with the points multiplier (for example "Silver • 1.67×").
> **Back:** **Next reward**, **Rewards**, **To level Gold (2.33×)** (for example "€1,400 more in purchases"), the full **Reward tiers** list with the spend each level needs, and **How it works**. The customer at the highest level does not see the "To level" line. With [level retention](https://vexioncards.mintlify.site/knowledge-base/level-retention.md) on, also **Level valid until** with a date (not on the lowest level).

> [accordion] Cashback
>
> **Front:** **Credit** in the top corner (the balance in euros, for example €5.01), Name, and **Cashback** (your rate, for example "3 %").
> **Back:** **How it works** (for example "You get 3 % of every purchase as credit. Use it as a discount on your next purchase."). The credit and the rate are on the front, so the back does not repeat them.

> [accordion] Cashback with levels
>
> **Front:** **Credit** in the top corner, Name, and **Cashback level** with the current level (for example "5 % • Silver").
> **Back:** **To level Gold (7 %)** (for example "€1,400 more in purchases"), the full **Cashback levels** list with the spend each level needs, and **How it works**. The customer at the highest level does not see the "To level" line. With [level retention](https://vexioncards.mintlify.site/knowledge-base/level-retention.md) on, also **Level valid until** with a date (not on the lowest level).

> [accordion] Discount
>
> **Front:** Name, the current **Discount** (the % and the level name, for example "10 % • Gold"), and, in the top corner, **Total spend**: everything the customer has bought so far, in euros, once they have bought something.
> **Back:** **To 15 % discount (Platinum)** (for example "€180 more in purchases") and the full **Discounts** list. Before the first purchase, also **Total spend** (€0). With [level retention](https://vexioncards.mintlify.site/knowledge-base/level-retention.md) on, also **Level valid until** with a date (not on the lowest level).

> [accordion] Employee card
>
> **Front:** Name, the **Discount** (the %, with the level name only when you set more than one level), and, in the top corner, **Remaining** (how much of the monthly budget is left), unless you hid the budget.
> **Back:** **Used this month**, **Monthly budget** and **Renews on**, and the **Discounts** list when you set more than one level.

> [accordion] Gift card
>
> **Front:** **Balance** in the top corner, Name, and **Valid until** (the expiry date, if the card has one). An expired card shows **Status: Expired** instead of a balance.
> **Back:** a **Personal message** and **Gift from** (the buyer's name), when the gift card was bought as a present, plus the shared fields. An employee credit card shows **Monthly credit** and **Renews on** instead, unless you hid the balance.

> [accordion] Coupon
>
> **Front:** Name, and **Get** (the reward the coupon grants).
> **Back:** the shared fields. Once the coupon is used, the front shows "REDEEMED" instead of the reward.

> [accordion] Membership
>
> **Front:** Name, **Valid until • Days remaining**, and, in the top corner, **Used TODAY** (entries used out of the daily limit) if you set a daily limit.
> **Back:** **Membership status**, **Membership type**, **Daily entries** ("Unlimited", only on a card without a daily limit), **Total usage**, and **Activated on**. An inactive membership shows **Status: Inactive** on the front, and **Valid until** (the end date) on the back.

Apple Wallet and Google Wallet show the same fields on the front and the same rows on the back, in the same order. The back never repeats what the front already shows.

## It updates automatically

You never reissue a card. After every scan, the pass on the customer's phone updates on its own: the new stamp count, points balance, or gift balance appears within moments. Apple Wallet refreshes it in the background; Google Wallet shows the fresh data. Any design change you make later reaches existing cardholders too. See [editing a card](https://vexioncards.mintlify.site/knowledge-base/editing-a-card.md).

## Notifications the customer receives

Most scans also send a short **push notification** to the customer's phone (as well as updating the pass). Every message is **automatic**, you do not write any of them, and each is translated into the customer's language, from "⭐ +40 points • To choose: 2 rewards • Total: 490 points" to "Transaction reversed. You have 5 stamps."

See **[Automatic messages](https://vexioncards.mintlify.site/knowledge-base/automatic-messages.md)** for the full list of what a customer sees for every action and card type, including reversals.

> [!NOTE]
>
> Notifications appear only if the customer has notifications enabled for Wallet on their phone. The pass itself always updates regardless.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.