Skip to content
Guide du centre d'aide · Vue d'ensemble du tableau de bordPhase d'intégration 6
3 min de lectureVérifié 2026-11-16

Comprendre votre espace de travail

Interprétez les KPI, la santé des passes, le ratio installés vs non installés et l'isolation multi-locataire.

Dans ce guide

Visites interactives de l'interface

Ouvrir dans le guide en 6 phases

Inspectez les écrans exacts du tableau de bord et les zooms annotés liés à ce guide.

Focus interface zoomé
Éléments clés de l'interface

Santé des cartes et actions recommandées (Zoom)

Suivez la répartition entre cartes actives et non installées et agissez sur les recommandations automatisées pour relancer les cartes en attente d'installation.

Santé de l'espace de travail & télémétrie en direct

Chaque compte Passinstance fonctionne au sein d'un espace de travail locataire strictement cloisonné. Tous les actifs créés dans un espace — modèles visuels, certificats cryptographiques de signature, propriétés personnalisées, fiches de passes clients, secrets d'API et historique des scans en point de vente — sont rattachés à votre identifiant d'espace (customerId) et totalement isolés des autres organisations.

Synthèse de la santé des passes et carte d'action recommandée
Synthèse de la santé des passes et carte d'action recommandée

Architecture multi-locataire & hiérarchie des espaces

Passinstance repose sur une hiérarchie organisationnelle à deux niveaux qui sépare la gouvernance de facturation du compte de la gestion quotidienne des passes :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : HIÉRARCHIE MULTI-LOCATAIRE
ÉTAPE 01 ORGANISATION (Niveau Compte)
Modèle Passinstance database : Organization
Rôles (OrganizationMemberRole) : OWNER, ADMIN, MEMBER
Quotas centralisés d'abonnement & facturation Stripe consolidée
ÉTAPE 02 Espaces de travail 1:N
ESPACE DE PRODUCTION
Fiche Customer : cust_prod_901
Type (kind) : production
.p12 Apple prod. & auth Google
Wallets & scanners clients en direct
Consomme le quota de passes actifs
ESPACE SANDBOX
Fiche Customer : cust_sbx_902
Type (kind) : sandbox
Signature démo & passes de test
Environnement de test isolé
Aucun impact sur les limites du plan

Gérer les espaces frères via l'API Organization

Les équipes qui gèrent plusieurs marques, comptes clients ou environnements sandbox peuvent interagir avec Organizations API :

Chemin d'endpointMéthodeAuthFonctionnalité
/api/v1/organizations/currentGETBearerRetourne l'organisation active, les rôles des membres et la liste des espaces frères accessibles.
/api/v1/organizations/current/billing-summaryGETBearerRécapitulatif des limites du forfait et du cumul de passes actifs sur tous les espaces.
/api/v1/organizations/current/workspacesPOSTBearerCrée un nouvel espace de travail frère (`kind: "production" \"sandbox"`).
/api/v1/organizations/current/workspaces/switchPOSTBearerBascule le contexte locataire actif et renouvelle les cookies de session.

Taxonomie des métriques de télémétrie principales

Pour piloter précisément votre programme de passes, Passinstance distingue la création d'un enregistrement côté serveur de son installation physique dans un portefeuille :

TEXT
Passe créé (POST /api/v1/passes) ================>  unclaimedPasses (Non installés)
                                                               |
                                                               | Client ajoute au Wallet
                                                               v
Appareil enregistré (POST /v1/devices/...) ======>  installedDevices (Installés)
                                                               |
                                                               | Client supprime du Wallet
                                                               v
Appareil désinscrit (DELETE /v1/devices/...) ====>  inactivePasses / inactiveDeviceRegistrations

Définitions issues de metric-definitions.ts

  • totalPasses (Total Passes Issued) : nombre cumulé de fiches de passes actives générées dans votre espace de travail et non supprimées au moment de la mesure.
  • activePasses (Active Passes) : instances de passes actives disposant actuellement d'au moins un enregistrement d'appareil joignable (hors passes expirés et annulés).
  • installedDevices (Active Device Registrations) : inscriptions de passes enregistrées et joignables sur Apple APNs et Google Wallet. Si un même passe est installé sur deux appareils, il compte pour deux inscriptions actives et est comptabilisé dans la capacité du forfait.
  • unclaimedPasses (Unclaimed Passes) : instances de passes émises dans Passinstance qui n'ont encore jamais été ajoutées à un portefeuille.
  • inactivePasses (Removed Passes) : instances de passes précédemment enregistrées dans un portefeuille mais qui n'ont plus aucun appareil joignable (y compris via Apple DELETE /v1/devices/... et les rappels Google del sur /api/v1/wallet/callback).
  • voidedPasses (Voided Passes) & expiredPasses (Expired Passes) : instances révoquées côté serveur ou ayant dépassé expirationDate.

Paramètres de l'espace de travail & configuration régionale

Chaque espace se configure indépendamment sous Settings -> Workspace (/settings/workspace/*) :

  • Paramètres généraux et régionaux (PUT /api/v1/customer/:customerId/regional-settings) : définit le fuseau horaire par défaut (resolveCustomerTimeZone), la devise ISO 4217 par défaut et la langue par défaut.
  • Quotas d'utilisation (GET /api/v1/customer/:customerId/usage-summary) : indique en temps réel le total des passes, les passes actifs face à maxActivePasses et le nombre de modèles.
  • Domaines personnalisés en marque blanche (/api/v1/white-labeling/vanity-urls) : connecte vos propres noms de domaine (domain surface type : PASS_DOWNLOAD, PASS_FLOW, BACKEND_UI, etc.) avec provisionnement SSL automatisé pour tous vos liens intelligents et pages de téléchargement.

Important : Les espaces de travail Sandbox offrent un environnement isolé pour tester des révisions de modèles, des webhooks API et des configurations scanner sans consommer de capacité de passes actifs sur votre forfait de production.

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.