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.

Carte Scanner

Carte Scanner permet au personnel de scanner les Cartes Apple Wallet et Google Wallet afin d’afficher et de gérer les privilèges en temps réel dans les 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 numérisation NFC soit prévue à l'avenir, la version actuelle s'appuie sur la lecture de codes-barres et de codes QR via la caméra. Carte Scanner n'est pas destiné à un usage public ; elle a été conçue pour des environnements à accès contrôlé tels que des événements, des salons ou des installations internes d'entreprise.

L'application fonctionne exclusivement en ligne. Chaque scan nécessite une connexion réseau afin de garantir que la vérification des cartes et la consommation des privilèges soient 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 par 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 compteurs, limités dans le temps ou conditionnels. Carte Scanner ne définit pas lui-même les privilèges, mais les affiche et permet aux opérateurs de les consommer conformément aux 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 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 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 boisson ou les privilèges de file rapide.

  • Hôtellerie: les équipes de lounge 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 de l'accueil scanne les cartes d'employé ou d'invité pour 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 d'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 Google Play.

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

iOS (App Store)

Exigences

  • Connexion Internet active

Installer

  1. Ouvrez l' App Store.

  2. Recherchez The Wallet Crew - Scanner (Lien de la boutique d'applications).

  3. Appuyez sur Obtenir / Installer.

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

Android (APK)

Exigences

  • Connexion Internet active

Installer

  1. Obtenez le lien de téléchargement 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 les 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.

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 l'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 maintenir 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, ce qui permet 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 les noms 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'image de marque et les flux de travail opérationnels existants de l'organisation.

D'un point de vue sécurité, Carte 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 afin de prévenir la fraude, et les jetons d'authentification sont de courte durée. Les appareils doivent être considérés comme gérés et contrôlés, afin de garantir que seul le personnel autorisé peut 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 l'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 de l'application, l'icône, les couleurs, les logos et l'écran de démarrage.

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 le statut de la carte et la liste actuelle des privilèges.

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

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

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