Skip to content
Guide du centre d'aide · Présentation de Passinstance
5 min de lectureVérifié 2026-11-16

Qu'est-ce que Passinstance ?

Découvrez comment Passinstance alimente Apple Wallet et Google Wallet sans nécessiter d'application mobile dédiée.

Dans ce guide

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 :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : ARCHITECTURE DE LA PLATEFORME
ÉTAPE 01 COUCHE CLIENT & INGESTION
Tableau de bord
(React / Vite SPA)
Point de vente & POS
(Mobile / Web / API)
PassFlow public
(Inscription libre-serv.)
ÉTAPE 02 BACKEND CENTRAL PASSINSTANCE (API)
Moteur modulaire NestJS (apps/api)
Préfixe global : /api/v1 et Apple Web Service : /v1
Garde RBAC & isolation multi-locataire (Organization / Customer)
Moteur de mécaniques (Pass Mechanics Engine, Tier Progression Engine)
Signataire cryptographique (Apple Wallet Packager PKCS#7 & générateur JWT
Base database
Schéma Passinstance
Isolation locataire
in-memory cache & ba
Files
Workers & APNs
round job queue
tâches | | Visue des cartes
ÉTAPE 01 RÉSEAUX WALLET CLOUD
Apple APNs HTTP/2
Gateway Protocol
Google Wallet
REST Cloud API
ÉTAPE 02 APPAREILS CLIENTS
Apple Wallet
(iOS/watchOS)
Google Wallet
(Android)

Composants backend principaux

  1. 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 subsystem et Certificate subsystem.
  2. 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. 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. 4
    Moteur de signature cryptographique : assemble les paquets Apple .pkpass avec 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érationnelPublic cibleCapacités principales & endpoints associés
Tableau de bord sans codeÉquipes marketing, enseignes retail, clubs d'adhérents, organisateurs d'événementsConcepteur 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éveloppeurIngénieurs logiciels, systèmes de caisse (POS), plateformes CRM et e-commerceCycle 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 par VOIDED_AFTER_SCAN scan mode ou INVALIDATE_AFTER_SCAN pour 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 & Scannersmechanic 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.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.