Vue d'ensemble
Passinstance est une plateforme d'infrastructure pour cartes de portefeuille numérique (Wallet) de qualité opérateur, conçue pour les entreprises, les développeurs et les systèmes d'entreprise. Elle fournit des outils complets pour concevoir, signer cryptographiquement, distribuer, mettre à jour dynamiquement et valider des passes numériques natifs dans Apple Wallet (iOS & watchOS) et Google Wallet (Android) sans demander à vos clients de télécharger ni de maintenir une application mobile dédiée.
Chaque carte vit nativement dans le portefeuille du système d'exploitation. Les utilisateurs ajoutent leur carte d'un simple appui depuis un lien web, un e-mail, un SMS ou un QR code. Une fois installés, les passes affichent des codes-barres en temps réel ou des identifiants NFC sans contact, reçoivent des notifications push instantanées lorsque les soldes ou statuts évoluent, et affichent automatiquement des informations pertinentes sur l'écran verrouillé à proximité de vos points de vente.
Architecture de la plateforme & pile technique
La plateforme Passinstance repose sur une architecture backend modulaire NestJS à haute concurrence, dotée de files de tâches asynchrones et de connecteurs vers les réseaux Wallet cloud :
Composants backend principaux
-
1
Passerelle API & modules dédiés : développée avec NestJS, structurant les fonctionnalités en modules métier tels que
Template subsystem,Pass subsystem,Pass mechanics subsystem,Scanner subsystem,Onboarding subsystemetCertificate subsystem. -
2
Passinstance data layer & database : applique une isolation stricte par clés étrangères ainsi que des attributs structured JSON indexés via des index GIN database pour des requêtes rapides sur les champs dynamiques.
-
3
Pipelines background job queue & in-memory cache : orchestre les opérations asynchrones à haut débit, notamment les tâches de génération de passes depuis CSV, les campagnes d'e-mails en masse via managed email delivery et les diffusions planifiées de notifications push.
-
4
Moteur de signature cryptographique : assemble les paquets Apple
.pkpassavec des signatures détachées PKCS#7 conformes aux certificats officiels Apple WWDR G4/G6 et génère les jetons JWT signés pour les objets Google Wallet.
Important : Toutes les données clients, les modèles et les clés de signature cryptographiques sont hébergés dans AWS Europe (Francfort,
eu-central-1) en totale conformité avec le RGPD et des politiques strictes d'isolation multi-locataire.
Deux façons d'utiliser Passinstance
Selon vos besoins techniques, Passinstance propose à la fois une suite opérationnelle complète sans code et une plateforme développeur conforme à OpenAPI :
| Mode opérationnel | Public cible | Capacités principales & endpoints associés |
|---|---|---|
| Tableau de bord sans code | Équipes marketing, enseignes retail, clubs d'adhérents, organisateurs d'événements | Concepteur visuel de modèles par glisser-déposer, émission en masse CSV (POST /api/v1/batch-processing), campagnes du Centre d'envoi, appairage de scanners Web et mobiles. |
| API REST développeur | Ingénieurs logiciels, systèmes de caisse (POS), plateformes CRM et e-commerce | Cycle de vie complet des passes par programmation (/api/v1/passes), vérification des scans en temps réel (/api/v1/scans), webhooks double mode HMAC-SHA256 push/pull, clés API cloisonnées (pi_live_, pi_test_). |
Programmes de passes & types du catalogue pris en charge
Passinstance prend nativement en charge tous les principaux formats de passes Wallet définis par Apple et Google via l'énumération backend pass type :
-
Cartes de fidélité et à tampons (
storeCard) : cartes à poinçons visuelles (STAMP_CARD_ADD,STAMP_CARD_DEDUCT) et programmes de récompenses à cumul continu de points selon les dépenses (LOYALTY_PROGRAM). -
Cartes de membre et d'abonnement (
membership/generic/posterGeneric) : cartes numériques avec prolongation automatique d'expiration (RENEW_EXPIRATION), vignettes photo, mise en page poster WWDC (posterGeneric) et restrictions de partage AirDrop. -
Coupons et bons d'achat (
coupon) : passes promotionnels à usage unique régis parVOIDED_AFTER_SCAN scan modeouINVALIDATE_AFTER_SCANpour empêcher la réutilisation par capture d'écran. -
Cartes cadeaux et cartes prépayées (
storeCard) : comptes à valeur stockée (PREPAID_CARD) adossés à un grand livre comptable en partie double exprimé en sous-unités monétaires. -
Billets d'événements et cartes d'embarquement (
eventTicket/boardingPass) : billets en direct avec champs de porte et de siège, mises en page poster WWDC25 (theme preference), plans de site MapKit et règles de contrôle aux portiques, ou titres de transport (transit type : Air, Boat, Bus, Train, Generic). -
Badges employés, cartes étudiant et cartes de visite numériques (
studentId/businessCard/generic) : badges d'identité et cartes de contact interactives avec transmission NFC sans contact (Apple VAS & Google Smart Tap) et révocation instantanée.
Capacités clés de la plateforme entre backend et frontend
| Capacité | Implémentation backend (Passinstance API) | Expérience frontend (Passinstance Dashboard / scanner) | |
|---|---|---|---|
Corrélation système externe (externalId) | Clé optionnelle unique par locataire (externalId, max. 255 caractères) indexée par passe actif (archivedAt IS NULL), alimentant la synchronisation CRM idempotente via POST /api/v1/passes/upsert-by-external-id. | Recherchable dans les filtres de la liste /passes, le mapping CSV en lot (Bulk Pass Wizard) et Pass Details panel. | |
Émission idempotente (idempotencyKey) | En-tête HTTP Idempotency-Key (<=128 caractères [A-Za-z0-9._:-]+) stocké avec vérification SHA-256 du corps de requête pour éviter les doublons en cas de nouvelle tentative réseau. | Généré automatiquement par les assistants et SDK tolérants aux relances ; consultable dans les journaux API des passes. | |
Regroupement multi-cartes (bundleId) | Pass.bundleId (bundleId) associe jusqu'à 10 passes complémentaires dans une archive Apple Wallet .pkpasses via pass bundle (bundle grouping mode : AUTO \ | MANUAL). | Géré depuis PassProject (Wallet Experiences → onglet Bundle) ou par sélection groupée dans /bundles/:id. |
| Mécaniques de passe & Scanners | mechanic type, ScanMode, StoredValueOperation et jetons anti-rejeu (nonces) sur POST /api/v1/scans. | Validation opérateur via le scanner Web (/scanner), l'application mobile Passinstance Scanner (iOS/Android/Expo avec file hors ligne) ou un POS externe (/v1/pos/redeem). |
Mesure de capacité & principes d'hébergement
Passinstance mesure la capacité d'abonnement selon les passes Wallet actifs (le nombre de passes actuellement installés sur les appareils des clients et connectés aux endpoints push APNs ou Google Wallet). Les brouillons, les passes supprimés et les liens de téléchargement non installés ne consomment pas votre quota d'abonnement actif.
Explorez notre Présentation de la plateforme et découvrez en détail les Mécaniques de passes & fonctionnalités.
