This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Scanner de Carte

Le Scanner de Carte permet au personnel de scanner les cartes Apple Wallet et Google Wallet afin de consulter et gérer les privilèges en temps réel dans des environnements à accès contrôlé.

Carte 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 les appareils iOS et Android, et bien que la prise en charge du scan NFC soit prévue pour l'avenir, la version actuelle repose sur la lecture de codes-barres et de codes QR par caméra. Carte Scanner n'est pas destiné à un usage public ; il a été conçu pour des environnements à accès contrôlé tels que des événements, des lounges ou des installations internes d'entreprise.

L'application est strictement en ligne. Chaque scan nécessite une connexion réseau pour garantir que la vérification des cartes 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'utilisation en double et garantit que toute consommation de privilèges est immédiatement visible pour le système backend.

Cartes et privilèges

Carte Scanner fonctionne avec des 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, à usages multiples avec compteur, limités dans le temps ou conditionnels. Carte 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.

Une fois la Carte scannée, l'application envoie son identifiant au backend pour vérification. Le backend valide la Carte, vérifie son état 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 utilisation.

  • Les privilèges à usages multiples sont décrémentés après chaque utilisation.

Exemples concrets
  • Événements: le personnel scanne un billet VIP pour vérifier l'accès au lounge, les bons pour boissons ou les privilèges de voie rapide.

  • Hôtellerie: les équipes du lounge vérifient les avantages liés à la chambre, comme l'accès au petit-déjeuner ou les boissons de bienvenue.

  • Accès d'entreprise: le personnel d'accueil scanne les cartes employés ou visiteurs afin de valider les droits d'accès au site.

  • Clubs d'adhésion: le personnel de l'accueil vérifie les entrées restantes, les cartes invité ou les avantages à durée limitée.

Installer Carte Scanner

Carte Scanner fonctionne sur iOS et Android.

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

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

iOS (App Store)

Prérequis

  • Connexion Internet active

Installer

  1. Ouvrez l' App Store.

  2. Recherchez The Wallet Crew - Scanner (Lien vers l'App Store).

  3. Touchez Obtenir / Installer.

  4. Ouvrez Carte Scanner depuis l'écran d'accueil.

Android (APK)

Prérequis

  • Connexion Internet active

Installer

  1. Obtenez le lien de téléchargement de l'APK auprès de votre administrateur.

  2. Touchez le lien pour télécharger l'APK.

  3. Ouvrez le fichier téléchargé depuis les Notifications ou les Téléchargements.

  4. Si demandé, autorisez votre navigateur ou votre gestionnaire de fichiers à Installer des applications inconnues.

  5. Ouvrez à nouveau l'APK.

  6. Touchez Installer.

  7. Touchez Ouvrir.

Après l'installation

  1. Ouvrez l'application. Vous verrez l'écran du scanner.

  2. Scannez le code QR de connexion fourni par votre administrateur. Ce code QR est créé et géré depuis Gérer les appareils.

  3. Commencez à scanner des cartes.

Authentification et fonctionnement

Carte Scanner utilise une authentification basée sur un code QR. Un opérateur scanne un code QR 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 permissions supplémentaires requis.

Comme l'application fonctionne uniquement en ligne, une connectivité réseau fiable est essentielle. Les appareils doivent être gérés, surveillés et sécurisés afin de préserver l'intégrité du système. Les journaux du backend offrent une visibilité sur les résultats des scans, les opérations de consommation et toute erreur, permettant aux administrateurs de suivre l'utilisation et de résoudre efficacement les problèmes.

Marque blanche et sécurité

Carte Scanner est conçu pour prendre en charge un déploiement en marque blanche. Les organisations peuvent personnaliser le nom de l'application, les icônes, les couleurs, les logos et les écrans de démarrage sans modifier le comportement sécurisé ni 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é, Carte Scanner réduit les risques en conservant toute la logique sensible côté backend. Les opérations de consommation sont vérifiées côté serveur pour éviter toute fraude, et les jetons d'authentification ont une courte durée de vie. Les appareils doivent être considérés comme gérés et contrôlés, afin de garantir que seul le personnel autorisé puisse scanner des cartes et consommer des privilèges.

FAQ

Carte Scanner peut-il être utilisé hors ligne ?

Non. Carte Scanner est uniquement en ligne.

Chaque scan nécessite une connexion réseau.

Comment Carte Scanner est-il installé ?

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

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

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

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

Quel est le protocole de connexion ?

Carte Scanner utilise une authentification basée sur un code QR.

Un opérateur scanne un code QR de connexion.

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

Carte Scanner prend-il en charge la marque blanche ?

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

L'image de marque ne modifie pas le modèle de sécurité.

Le scan d'une carte est-il réversible ?

Le scan d'une carte est en lecture seule.

Il récupère l'état de la carte et la liste actuelle des privilèges.

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

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

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