Skip to content
Hilfecenter-Anleitung · Schnellstart
4 Min. LesezeitGeprüft 2026-11-16

Konto einrichten

Erstellen Sie Ihren Workspace, richten Sie Ihre Unternehmensdaten ein und bereiten Sie die Signiervoraussetzungen vor.

In dieser Anleitung

Ü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:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
ONBOARDING-ZUSTANDSAUTOMAT
STUFE 01 WALLET_SETUP
Bedingungen akzep- tieren & Google
Wallet einrichten
STUFE 02 PERSONALIZE
Volumen & Use-Case-
Katalog auswählen
STUFE 03 GENERATING_DEMOS
Asynchroner background jo baut 17 Vorlagen auf
STUFE 02A DONE
Produktivbereit;
Vorlagen starten
STUFE 02B TRY_PASS
Beispielpass auf iOS/Android scannen
STUFE 02C GENERATING_DEMOS
Hintergrundgenerierung schließt Demo-Katalog ab

Onboarding-Schritte & Enums

Die Sitzung durchläuft nacheinander die exakten Werte des Enums OnboardingStep:

  1. 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. 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.

  1. 3
    GENERATING_DEMOS: Das Backend reiht Hintergrundjobs ein, die Demo-Vorlagen über die Kategorien von OnboardingUseCase bereitstellen (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).
  2. 4
    TRY_PASS: Erzeugt einen kurzlebigen Beispielpass mit scanbarem QR-Code zur sofortigen Installation auf Ihrem Smartphone.
  3. 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-PfadMethodeAuthPayload / ParameterBeschreibung
/api/v1/onboardingGETBearerKeineRuft aktuellen Onboarding-Status, aktiven Schritt und erzeugte Demos ab.
/api/v1/onboarding/wallet-setupPUTBearer{ "googleWalletAccepted": true }Akzeptiert die Bedingungen der Wallet-Ausgabe und richtet die Standard-Google-Wallet-Konfiguration ein.
/api/v1/onboarding/personalizePUTBearer{ expectedPassVolume, useCases: [] }Speichert die Volumenstufe und ausgewählte OnboardingUseCase-Einträge.
/api/v1/onboarding/demosPOSTBearerKeineStartet die asynchrone Erzeugung der Demo-Vorlagen (QUEUED -> READY).
/api/v1/onboarding/demosGETBearerKeineFragt den Fortschritt der Demo-Generierung für die gewählten Anwendungsfälle ab.
/api/v1/onboarding/demos/:type/retryPOSTBearerURL-Parameter :typeWiederholt die Demo-Erzeugung für einen fehlgeschlagenen Katalogtyp.
/api/v1/onboarding/sample-passPOSTBearer{ templateId? }Erzeugt einen Live-Testpass zur sofortigen Wallet-Installation.
/api/v1/onboarding/sample-pass/public/:sessionIdGETKeineURL-Parameter :sessionIdÖffentlicher Endpunkt ohne Authentifizierung zum Anzeigen/Installieren des Testpasses auf Mobilgeräten.
/api/v1/onboarding/completePOSTBearer{ 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. 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. 2
    Regionale Einstellungen konfigurieren: Öffnen Sie Einstellungen -> Allgemein (/settings/workspace/general) oder rufen Sie PUT /api/v1/customer/:customerId/regional-settings auf, 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.

  1. 3
    Apple-Wallet-Zertifikat einrichten (Produktion): Erzeugen Sie unter Einstellungen -> Wallet -> Apple-Zertifikate (/settings/workspace/wallet) einen Certificate Signing Request über POST /api/v1/certificates/generate-csr, laden Sie diesen im Apple Developer Portal unter Pass Type IDs hoch und importieren Sie die signierte .cer-Datei über POST /api/v1/certificates.
  2. 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-collectorId einzusehen.
  3. 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.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.