> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-scan/scan/pass-scanner.md).

# Pass Scanner

Pass Scanner lets staff scan Apple Wallet and Google Wallet passes, check them, use their benefits and add stamps, from iOS and Android phones.

Pass Scanner is The Wallet Crew's mobile application for staff. It scans a wallet pass, shows who holds it and what it carries, and lets staff use a benefit or add a stamp in one tap. It runs on iOS and Android phones and reads the pass with the phone camera, a rugged scanner's trigger, NFC on compatible Android devices, or a code typed by hand. The app is available in English and French and follows the language of the phone.

Pass Scanner is built for controlled environments run by the brand: shop counters, bars, lounges, cloakrooms, event entrances, front desks. It is not meant for public distribution. Each phone is registered in the admin console as a **device**, and each device runs one of the **profiles** configured for the tenant.

{% embed url="<https://www.youtube.com/watch?v=bzlGOpzjKfI>" %}

<details>

<summary><strong>Real-world examples</strong></summary>

* **Coffee shop:** the counter phone scans a stamp card, adds a stamp, and uses the "Free drink" reward when the card is full.
* **Events:** bar staff run a "Bar" profile that only lists drink tokens, while the entrance team runs a "Gate" profile for VIP lounge access.
* **Hospitality:** a breakfast profile opens every morning from 7:00 to 10:30 and accepts only the "Breakfast included" benefit.
* **Retail:** sales associates check a member's "10% off every order" benefit before applying the discount at the till.
* **Membership clubs:** front-desk staff count one use of a "10 entries" pack at each visit.

</details>

## How Pass Scanner works

When a pass is scanned, the app sends its identifier to The Wallet Crew, which checks the pass and returns the benefits it carries. Staff see the benefits that the running profile accepts and use one with a tap. The use is recorded immediately on the pass, which is then updated in the holder's wallet.

```mermaid
sequenceDiagram
    participant Staff as Staff (Pass Scanner)
    participant TWC as The Wallet Crew
    participant Wallet as Holder's wallet
    Staff->>TWC: Scan the pass barcode or QR code
    TWC-->>Staff: Pass status and benefits accepted by the profile
    Staff->>TWC: Use a benefit / add a stamp
    TWC-->>Staff: Updated balance
    TWC->>Wallet: Pass update pushed to Apple Wallet or Google Wallet
```

Pass Scanner is online only: every scan needs a network connection, so that a benefit can never be used twice on two phones and every use is visible in the admin console straight away. Only the profile schedule is checked on the phone itself, in its local time.

### Ways to read a pass

| Method              | How it works                                                                                                                                                                                                                                                   |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Camera**          | The default. The phone camera reads the barcode or QR code shown on the holder's screen.                                                                                                                                                                       |
| **Scanner trigger** | On Zebra Android devices, the hardware trigger reads the code through Zebra DataWedge, which is faster at busy counters. For separate barcode scanner hardware, see [Third-party barcode scanners](https://docs.thewalletcrew.io/guides-scan/scan/scanner.md). |
| **NFC**             | On Zebra Android devices with NFC keys configured, the holder taps the phone or watch on the device. Apple Wallet passes are read with Apple VAS and Google Wallet passes with Google Smart Tap.                                                               |
| **Manual input**    | Staff type the code printed under the barcode when the screen cannot be read, for example with a cracked screen or low brightness.                                                                                                                             |

When the pass uses a rotating barcode, Pass Scanner checks that the code shown is the current one. An old screenshot or a code shown too late is refused with **Expired code, ask for the pass to be shown again**.

### What staff see after a scan

The result screen shows the pass title and subtitle, the wallet it is installed on, its benefits and its recent history.

### Benefits

Pass Scanner lists the benefits of the scanned pass that have **Show in Pass Scanner** switched on in their [benefit template](https://docs.thewalletcrew.io/guides-animation/engage-and-animate/benefit-templates.md). Benefits that the running profile does not accept are shown grayed out under **Not accepted on this device**, so staff can tell the holder where to use them. Benefits behave according to their [behavior](https://docs.thewalletcrew.io/guides-animation/engage-and-animate/benefit-templates.md#behavior-one-time-unlimited-or-multi-use): a one-time benefit is spent once used, a multi-use benefit loses one use each time, and an unlimited benefit stays available, with each use counted for reporting.

When the benefit template has **Use automatically on scan** switched on, the scan itself uses each matching benefit, with no second tap. This is the fastest mode for queues, such as a bar or a cloakroom. If the same pass is scanned again within the profile's repeat-scan block, Pass Scanner shows **Already redeemed moments ago, no use taken** instead of using the benefit twice.

{% hint style="warning" %}
Using a benefit is final at the counter. Pass Scanner does not ask for a confirmation, a PIN or an approval. To correct a mistake, open the pass in the admin console and use **Give back 1 use** on the benefit.
{% endhint %}

### Stamp cards

When the running profile has **Staff can add stamps** switched on, scanning a [stamp card](https://docs.thewalletcrew.io/guides-design/design/stamp-card.md) shows the board with **Add a stamp** and **Remove a stamp**. Each tap applies one stamp. When the goal is reached, the app shows **Card complete**, and the reward benefit, when the template has one, appears in the benefits list and can be used straight away. Without the option, the stamp card is only shown.

### Profiles and sessions

When a device has several profiles, Pass Scanner opens on **Choose a profile**. Staff can **Change the profile** or **Close the session** from the app menu, after a confirmation. See [Pass Scanner profiles](https://docs.thewalletcrew.io/guides-scan/scan/pass-scanner/pass-scanner-profiles.md) for how profiles work and [Manage devices](https://docs.thewalletcrew.io/guides-scan/scan/pass-scanner/manage-devices.md#follow-sessions-and-logs) for sessions.

## Install Pass Scanner

Pass Scanner runs on **iOS** and **Android** and needs an active internet connection. The simplest way to install it is the connection QR code of a device: scanning it with the phone camera opens the store to install the app, and the same code then connects the app to the tenant (see [Connect the phone to the tenant](#connect-the-phone-to-the-tenant)).

On iOS, the app is also available directly from the App Store.

<details>

<summary><strong>iOS (App Store)</strong></summary>

1. Open the **App Store**.
2. Search for **The Wallet Crew - Scanner** ([App Store link](https://apps.apple.com/app/the-wallet-crew-scanner/id6758636841)).
3. Tap **Get**.
4. Open Pass Scanner from the home screen.

</details>

{% hint style="warning" %}
Install Pass Scanner only from an official store listing, or from the connection QR code of a device.
{% endhint %}

### Connect the phone to the tenant

A phone connects to the tenant with the **connection QR code** of its device, created by an administrator in [Manage devices](https://docs.thewalletcrew.io/guides-scan/scan/pass-scanner/manage-devices.md).

1. Scan the connection QR code with the phone camera. If Pass Scanner is not installed yet, the link opens the store to install it.
2. Open Pass Scanner, tap **Scan the QR code**, and scan the connection QR code again.
3. When the device has several profiles, choose the profile to run.
4. Start scanning passes.

Scanning the QR code of another device on a phone that is already connected asks **Replace the connection?** first, so that a phone is never moved to another device by mistake.

When the device is switched off in the admin console, the app shows **This device is disabled**. Once it is enabled again, **Check again** resumes without reconnecting.

## Authentication and security

Each phone signs in with the credential of its own device. Pass Scanner also asks for the phone's own lock, with biometrics or the passcode (**Authentication required**), before it can be used, so a lost phone cannot be used by someone who does not know how to unlock it. All staff using a phone share the same access level: there are no per-operator accounts in the app. Access is controlled per device: see [Manage devices](https://docs.thewalletcrew.io/guides-scan/scan/pass-scanner/manage-devices.md).

The credential carried by the connection QR code is limited to what scanning needs: connecting the device, recording scans, and reading and updating passes for benefits and stamps. It only works for its own device. Sensitive logic stays on The Wallet Crew's servers, which verify every use before recording it.

## Branding

Pass Scanner is a single app published by The Wallet Crew for every tenant. The logo shown in the app is set per device, from the tenant's branding when the device is created. Later branding changes are not applied to existing devices. The app name, icon and colors are not customized per brand.

The app settings screen shows the connection details for support, read-only: staff cannot change the tenant or the device from the phone.

## FAQ

<details>

<summary><strong>Can Pass Scanner be used offline?</strong></summary>

No. Pass Scanner is online only, see [How Pass Scanner works](#how-pass-scanner-works).

</details>

<details>

<summary><strong>Why does a benefit not appear when the pass is scanned?</strong></summary>

Check that the benefit template has **Show in Pass Scanner** switched on, that the benefit is **Available** on the pass page (not scheduled, used, expired or removed), and that the running profile accepts it (the benefit carries one of its tags or comes from one of its templates) and is open at this time on the phone.

</details>

<details>

<summary><strong>Why can't staff add a stamp?</strong></summary>

The profile running on the device must have **Staff can add stamps** switched on. Also check that the card is not full with the **Stay full** behavior.

</details>

<details>

<summary><strong>How is a phone connected?</strong></summary>

With the connection QR code of its device, which installs the app and connects it: see [Manage devices](https://docs.thewalletcrew.io/guides-scan/scan/pass-scanner/manage-devices.md#add-a-new-device).

</details>

<details>

<summary><strong>A scan says "Expired code". What does it mean?</strong></summary>

The pass uses a rotating barcode and the code shown is no longer current, for example on a screenshot. Ask the holder to show the pass again from the wallet.

</details>

<details>

<summary><strong>A scan says "Unknown Pass". What does it mean?</strong></summary>

No pass carries the scanned value. Pass Scanner finds a pass only from its stored barcode values: turn on **Persist scannable data** in the General tab of the pass template (**Advanced configuration → Scannable data**), then update the passes so their barcode values are stored.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/guides-scan/scan/pass-scanner.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
