# Pass Scanner

Pass Scanner est une application mobile conçue pour permettre au personnel de scanner une Carte, de voir tous les privilèges associés et de les consommer. Elle fonctionne sur appareils iOS et Android, et bien que la lecture NFC soit prévue pour le futur, la version actuelle repose sur la lecture par caméra des codes-barres et des QR codes. Pass Scanner n'est pas destinée à un usage public ; elle a été conçue pour des environnements d'accès contrôlé tels que des événements, des salons ou des installations internes d'entreprise.

\
L'application est strictement en ligne. Chaque scan nécessite une connexion réseau afin de garantir que la vérification de la Carte et la consommation des privilèges sont toujours effectuées en temps réel. Le fonctionnement hors ligne n'est pas pris en charge, ce qui élimine le risque d'utilisations en double et garantit que toute consommation de privilège est immédiatement visible par le système backend.

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

## Cartes et privilèges

Pass Scanner fonctionne avec les cartes Wallet stockées dans Apple Wallet ou Google Wallet. Chaque Carte contient un identifiant unique lié à un ou plusieurs privilèges. Ces privilèges peuvent être à usage unique, multi-usage avec compteurs, limités dans le temps ou conditionnels. Pass Scanner lui-même ne définit pas les privilèges mais les affiche et permet aux opérateurs de les consommer selon les règles définies dans le backend. Pour une explication détaillée des types de privilèges, les administrateurs peuvent se référer à [Privilège](https://docs.thewalletcrew.io/fr/engager-et-animer/privilege-and-activation/privilege).

\
Une fois qu'une Carte est scannée, l'application envoie son identifiant au backend pour vérification. Le backend valide la Carte, vérifie son statut et renvoie la liste des privilèges.\
\
Les opérateurs peuvent ensuite consommer des privilèges :

* Les privilèges à usage unique sont désactivés après leur rédemption.
* Les privilèges multi-usage sont décrémentés après chaque rédemption.

{% hint style="warning" %}
La consommation d'un privilège est irréversible.

Pass Scanner n'affiche pas d'invite de confirmation.

Pass Scanner n'utilise pas de PIN ni d'approbations supplémentaires.
{% endhint %}

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Événements**: le personnel scanne un billet VIP pour vérifier l'accès au salon, les bons de boisson ou les privilèges de file rapide.
* **Hôtellerie**: les équipes du salon vérifient les avantages liés à la chambre tels que l'accès au petit-déjeuner ou les boissons de bienvenue.
* **Accès d'entreprise**: le personnel d'accueil scanne les Cartes des employés ou des invités pour valider les droits d'accès au site.
* **Clubs de membres**: le personnel de la réception vérifie les entrées restantes, les Cartes invitées ou les avantages limités dans le temps.

</details>

## Installer Pass Scanner

Pass Scanner fonctionne sur **iOS** et **Android**.

L'application est publiée sur l'Apple App Store et Google Play.

TestFlight (iOS) et la distribution d'APK (Android) peuvent toujours être utilisés pour les tests internes, les déploiements progressifs ou les appareils gérés.

<details>

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

**Exigences**

* Connexion Internet active

**Installer**

1. Ouvrez l' **App Store**.
2. Recherchez **The Wallet Crew - Scanner (**[**Lien App Store**](https://apps.apple.com/app/the-wallet-crew-scanner/id6758636841)**)**.
3. Appuyez sur **Obtenir** / **Installer**.
4. Ouvrez Pass Scanner depuis l'écran d'accueil.

</details>

<details>

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

**Exigences**

* Connexion Internet active

**Installer**

1. Obtenez le lien de téléchargement de l'APK auprès de votre administrateur.
2. Appuyez sur le lien pour télécharger l'APK.
3. Ouvrez le fichier téléchargé depuis les Notifications ou le dossier Téléchargements.
4. Si demandé, autorisez votre navigateur ou gestionnaire de fichiers à **Installer des applications inconnues**.
5. Ouvrez à nouveau l'APK.
6. Appuyez sur **Installer**.
7. Appuyez sur **Ouvrir**.

{% hint style="warning" %}
Installez Pass Scanner uniquement depuis une fiche officielle du magasin, ou depuis un lien fourni par The Wallet Crew.

Ne téléchargez jamais l'APK à partir de sites Web tiers.
{% endhint %}

</details>

#### Après l'installation

1. Ouvrez l'application. Vous verrez l'écran du scanner.
2. Scannez le QR code de connexion fourni par votre administrateur. Ce QR code est créé et géré depuis [Gérer les appareils](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/scan/crew-check/manage-devices).
3. Commencez à scanner les Cartes.

## Authentification et fonctionnement

Pass Scanner utilise **authentification par QR-code**. Un opérateur scanne un QR code de connexion, que le backend valide avant d'émettre un jeton de session. Une fois authentifié, l'opérateur peut scanner des Cartes et gérer les privilèges. Tous les opérateurs ont le même niveau d'accès, sans rôles ni autorisations supplémentaires requis.

Parce que l'application est uniquement en ligne, une connectivité réseau fiable est essentielle. Les appareils doivent être gérés, surveillés et sécurisés pour maintenir l'intégrité du système. Les journaux du backend fournissent une visibilité sur les résultats des scans, les opérations de consommation et les erreurs éventuelles, permettant aux administrateurs de suivre l'utilisation et de dépanner efficacement.

## Marquage blanc et sécurité

Pass Scanner est conçu pour prendre en charge le déploiement en marque blanche. Les organisations peuvent personnaliser les noms d'application, icônes, couleurs, logos et écrans de démarrage sans altérer le comportement sécurisé ou les fonctionnalités de l'application. Cela facilite l'intégration de l'application dans l'identité visuelle et les workflows opérationnels existants d'une organisation.

\
Du point de vue de la sécurité, Pass Scanner minimise les risques en conservant toute la logique sensible côté backend. Les opérations de consommation sont vérifiées côté serveur pour prévenir la fraude, et les jetons d'authentification sont de courte durée. Les appareils doivent être traités comme gérés et contrôlés, garantissant que seul le personnel autorisé peut scanner les Cartes et consommer les privilèges.

## FAQ

<details>

<summary>Pass Scanner peut-il être utilisé hors ligne ?</summary>

Non. Pass Scanner est **uniquement en ligne**.

Chaque scan nécessite une connexion réseau.

</details>

<details>

<summary>Comment Pass Scanner est-il installé ?</summary>

Installez Pass Scanner sur les appareils du personnel (iOS et Android).

Pass Scanner n'est pas destiné à une distribution publique.

La plupart des équipes l'installent depuis l'Apple App Store et Google Play.

Si un canal d'installation alternatif est nécessaire (TestFlight ou APK), contactez The Wallet Crew.

</details>

<details>

<summary>Quel est le protocole de connexion ?</summary>

Pass Scanner utilise **authentification par QR-code**.

Un opérateur scanne un QR code de connexion.

Le backend le valide et émet un **jeton de session**.

</details>

<details>

<summary>Pass Scanner prend-il en charge le marquage blanc ?</summary>

Oui. Vous pouvez personnaliser le nom de l'application, l'icône, les couleurs, les logos et l'écran de démarrage.

Le branding ne change pas le modèle de sécurité.

</details>

<details>

<summary>Le scan d'une Carte est-il réversible ?</summary>

Le scan d'une Carte est **en lecture seule**.

Il récupère le statut de la Carte et la liste actuelle des privilèges.

Ce qui **n'est pas réversible** est la consommation d'un privilège.

Une fois consommé, il est enregistré immédiatement côté serveur.

Cela ne peut pas être annulé depuis Pass Scanner.

</details>