Überblick
Beim Einrichten eines Passinstance-Kontos wird Ihr isolierter Mandanten-Workspace initialisiert, Ihre regionalen Einstellungen werden festgelegt und eine automatisierte Onboarding-Pipeline führt Sie direkt zur Erstellung testbereiter Demo-Pässe für Apple Wallet und Google Wallet.
Onboarding-Pipeline & Zustandsautomat
Passinstance steuert die Kontoinitialisierung über den automatisierten Zustandsautomaten OnboardingSession, der im Backend vom Onboarding API bereitgestellt wird:
Onboarding-Schritte & Enums
Die Sitzung durchläuft nacheinander die exakten Werte des Enums OnboardingStep:
-
1
WALLET_SETUP: Prüfen und akzeptieren Sie die Plattformbedingungen für die Wallet-Ausgabe (googleWalletAccepted) und bereiten Sie die Standard-Demo-Zugangsdaten vor. -
2
PERSONALIZE: Wählen Sie Ihr Geschäftsmodell sowie die erwartete monatliche Volumenstufe:
- EVALUATING: Funktionstests und Sandbox-Erkundung. - UP_TO_500: Boutiquen, lokale Vereine, spezialisierte Veranstaltungsorte. - RANGE_500_5000: Wachsende Einzelhändler, regionale Fitnessstudios, mittlere Events. - RANGE_5000_25000: Filialketten mit mehreren Standorten und größere Mitgliederverbände. - RANGE_25000_PLUS / ENTERPRISE: Hochvolumiges Ticketing, landesweite Handels-Treueprogramme, Airline-/ÖPNV-Pässe.
-
3
GENERATING_DEMOS: Das Backend reiht Hintergrundjobs ein, die Demo-Vorlagen über die Kategorien vonOnboardingUseCasebereitstellen (LOYALTY_AND_CUSTOMER_CARDS,MEMBERSHIP_CARDS,TICKETING,VOUCHERS_OR_COUPONS,GIFT_CARDS_OR_PREPAID_CARDS,BUSINESS_CARDS,EMPLOYEE_IDS,INSURANCE_WARRANTY_AND_SERVICE_CARDS,OTHER). -
4
TRY_PASS: Erzeugt einen kurzlebigen Beispielpass mit scanbarem QR-Code zur sofortigen Installation auf Ihrem Smartphone. -
5
DONE: Schließt das Onboarding ab und schaltet das vollständige Verwaltungs-Dashboard (/dashboard) frei.
Onboarding-Controller-API-Referenz
Entwickler und automatisierte Provisionierungs-Skripte können das Onboarding programmatisch über /api/v1/onboarding steuern:
| Endpunkt-Pfad | Methode | Auth | Payload / Parameter | Beschreibung |
|---|---|---|---|---|
/api/v1/onboarding | GET | Bearer | Keine | Ruft aktuellen Onboarding-Status, aktiven Schritt und erzeugte Demos ab. |
/api/v1/onboarding/wallet-setup | PUT | Bearer | { "googleWalletAccepted": true } | Akzeptiert die Bedingungen der Wallet-Ausgabe und richtet die Standard-Google-Wallet-Konfiguration ein. |
/api/v1/onboarding/personalize | PUT | Bearer | { expectedPassVolume, useCases: [] } | Speichert die Volumenstufe und ausgewählte OnboardingUseCase-Einträge. |
/api/v1/onboarding/demos | POST | Bearer | Keine | Startet die asynchrone Erzeugung der Demo-Vorlagen (QUEUED -> READY). |
/api/v1/onboarding/demos | GET | Bearer | Keine | Fragt den Fortschritt der Demo-Generierung für die gewählten Anwendungsfälle ab. |
/api/v1/onboarding/demos/:type/retry | POST | Bearer | URL-Parameter :type | Wiederholt die Demo-Erzeugung für einen fehlgeschlagenen Katalogtyp. |
/api/v1/onboarding/sample-pass | POST | Bearer | { templateId? } | Erzeugt einen Live-Testpass zur sofortigen Wallet-Installation. |
/api/v1/onboarding/sample-pass/public/:sessionId | GET | Keine | URL-Parameter :sessionId | Öffentlicher Endpunkt ohne Authentifizierung zum Anzeigen/Installieren des Testpasses auf Mobilgeräten. |
/api/v1/onboarding/complete | POST | Bearer | { skipSamplePass?: boolean } | Markiert die Onboarding-Sitzung als DONE. |
Checkliste für die Kontoeinrichtung
Folgen Sie diesen Meilensteinen in Passinstance Dashboard, um Ihren Workspace für den Produktivbetrieb vorzubereiten:
-
1
Workspace & E-Mail verifizieren: Bestätigen Sie nach der Registrierung Ihre E-Mail-Adresse (jede gültige E-Mail-Adresse funktioniert), um Ihre administrativen Mandanten-Zugangsdaten samt vorprovisioniertem Demo-Apple-Zertifikat und Managed Google Wallet Issuer zu aktivieren.
-
2
Regionale Einstellungen konfigurieren: Öffnen Sie Einstellungen -> Allgemein (
/settings/workspace/general) oder rufen SiePUT /api/v1/customer/:customerId/regional-settingsauf, um Folgendes festzulegen:
- Zeitzone: Steuert tägliche Scan-Limits und lokale Zeitstempel (z. B. Europe/Berlin, America/New_York). - Währung: Legt die Standardwährung gemäß ISO 4217 für Prepaid-Guthaben fest (z. B. EUR, USD, GBP). - Standardsprache: Definiert die Hauptsprache für lokalisierte Wallet-Felder.
-
3
Apple-Wallet-Zertifikat einrichten (Produktion): Erzeugen Sie unter Einstellungen -> Wallet -> Apple-Zertifikate (
/settings/workspace/wallet) einen Certificate Signing Request überPOST /api/v1/certificates/generate-csr, laden Sie diesen im Apple Developer Portal unter Pass Type IDs hoch und importieren Sie die signierte.cer-Datei überPOST /api/v1/certificates. -
4
Google Wallet Issuer einrichten (Produktion): Führen Sie unter Einstellungen -> Wallet -> Google Wallet die Einrichtung aus (
POST /api/v1/google-wallet/setup) und prüfen Sie den Status (GET /api/v1/google-wallet/status), um Ihre Google Issuer ID und Smart-Tap-collectorIdeinzusehen. -
5
Teamrollen & Zugriffskontrolle: Laden Sie unter Einstellungen -> Zugriff -> Mitglieder & Rollen (
/settings/workspace/access) Teammitglieder mit Organisationsrollen (OrganizationMemberRole:OWNER,ADMIN,MEMBER) sowie Workspace-RBAC-Rollen (DEFAULT_ROLES:super-admin,admin,editor,user,customer) ein und aktivieren Sie die Zwei-Faktor-Authentifizierung (enforceTwoFactorAuth).
Voraussetzungen: Um produktive Pässe mit eigenem Branding in Apple Wallet auszugeben, benötigen Sie eine aktive Mitgliedschaft im Apple Developer Program (99 USD/Jahr), um ein Apple-Pass-Type-ID-Zertifikat (
pass.com.ihrunternehmen.app) zu erstellen. Tests in der Onboarding-Sandbox nutzen Demo-Zertifikate von Passinstance.
Sehen Sie sich unsere verfügbaren Tarife & Kapazitätsstufen an oder starten Sie direkt mit Phase 2: Pass gestalten.
