# Pass Scanner

Pass Scanner is a mobile application designed to allow staff to scan a pass, view all associated privileges, and consume them. It works on both iOS and Android devices, and while NFC scanning is planned for the future, the current version relies on camera-based barcode and QR code scanning. Pass Scanner is not intended for a public use, it was designed for controlled access environments such as events, lounges, or internal company facilities.

\
The application is strictly online. Every scan requires a network connection to ensure that pass verification and privilege consumption are always performed in real time. Offline operation is not supported, which eliminates the risk of duplicate usage and ensures that all privilege consumption is immediately visible to the backend system.

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

## Passes and Privileges

Pass Scanner works with wallet passes stored in Apple Wallet or Google Wallet. Each pass contains a unique identifier linked to one or more privileges. These privileges can be one-time use, multi-use with counters, time-bound, or conditional. Pass Scanner itself does not define privileges but displays them and allows operators to consume them according to the rules set in the backend. For a detailed explanation of privilege types, administrators can refer to [Privilege](https://docs.thewalletcrew.io/engage-and-animate/privilege-and-activation/privilege).

\
Once a pass is scanned, the app sends its identifier to the backend for verification. The backend validates the pass, checks its status, and returns the list of privileges.\
\
Operators can then consume privileges:

* One-time privileges are disabled after redemption.
* Multi-use privileges are decremented after each redemption.

{% hint style="warning" %}
Consuming a privilege is irreversible.

Pass Scanner does not show a confirmation prompt.

Pass Scanner does not use PINs or extra approvals.
{% endhint %}

<details>

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

* **Events**: staff scan a VIP ticket to check lounge access, drink vouchers, or fast-lane privileges.
* **Hospitality**: lounge teams verify room-linked benefits such as breakfast access or welcome drinks.
* **Corporate access**: reception staff scan employee or guest passes to validate site access rights.
* **Membership clubs**: front-desk staff check remaining entries, guest passes, or time-limited perks.

</details>

## Install Pass Scanner

Pass Scanner runs on **iOS** and **Android**.

The app is published on the Apple App Store and Google Play.

TestFlight (iOS) and APK distribution (Android) can still be used for internal testing, staged rollouts, or managed devices.

<details>

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

**Requirements**

* Active internet connection

**Install**

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** / **Install**.
4. Open Pass Scanner from the home screen.

</details>

<details>

<summary><strong>Android (APK)</strong></summary>

**Requirements**

* Active internet connection

**Install**

1. Get the APK download link from your administrator.
2. Tap the link to download the APK.
3. Open the downloaded file from Notifications or Downloads.
4. If prompted, allow your browser or file manager to **Install unknown apps**.
5. Open the APK again.
6. Tap **Install**.
7. Tap **Open**.

{% hint style="warning" %}
Only install Pass Scanner from an official store listing, or from a link provided by The Wallet Crew.

Never download the APK from third-party websites.
{% endhint %}

</details>

#### After installation

1. Open the app. You will see the scanner screen.
2. Scan the login QR code provided by your administrator. This QR code is created and managed from [Manage devices](https://docs.thewalletcrew.io/scan/crew-check/manage-devices).
3. Start scanning passes.

## Authentication and Operation

Pass Scanner uses **QR-code-based authentication**. An operator scans a login QR code, which the backend validates before issuing a session token. Once authenticated, the operator can scan passes and manage privileges. All operators have the same access level, with no roles or additional permissions required.

Because the app is online-only, reliable network connectivity is essential. Devices should be managed, monitored, and secured to maintain system integrity. Backend logs provide visibility into scan results, burn operations, and any errors, allowing administrators to track usage and troubleshoot issues efficiently.

## White-Label and Security

Pass Scanner is designed to support white-label deployment. Organizations can customize app names, icons, colors, logos, and splash screens without altering the app’s secure behavior or functionality. This makes it simple to integrate the app into an organization’s existing branding and operational workflows.

\
From a security perspective, Pass Scanner minimizes risk by keeping all sensitive logic on the backend. Burn operations are verified server-side to prevent fraud, and authentication tokens are short-lived. Devices should be treated as managed and controlled, ensuring that only authorized staff can scan passes and consume privileges.

## FAQ

<details>

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

No. Pass Scanner is **online-only**.

Every scan requires a network connection.

</details>

<details>

<summary>How is Pass Scanner installed?</summary>

Install Pass Scanner on staff devices (iOS and Android).

Pass Scanner is not intended for public distribution.

Most teams install it from the Apple App Store and Google Play.

If an alternative install channel is needed (TestFlight or APK), contact The Wallet Crew.

</details>

<details>

<summary>What is the login protocol?</summary>

Pass Scanner uses **QR-code-based authentication**.

An operator scans a login QR code.

The backend validates it and issues a **session token**.

</details>

<details>

<summary>Does Pass Scanner support white-labeling?</summary>

Yes. You can customize the app name, icon, colors, logos, and splash screen.

Branding does not change the security model.

</details>

<details>

<summary>Is scanning a pass reversible?</summary>

Scanning a pass is **read-only**.

It fetches pass status and the current list of privileges.

What is **not reversible** is consuming a privilege.

Once consumed, it is recorded server-side immediately.

It cannot be undone from Pass Scanner.

</details>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thewalletcrew.io/scan/crew-check.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
