Skip to content
Hilfecenter-Anleitung · Einführung in Passinstance
4 Min. LesezeitGeprüft 2026-11-16

Was ist Passinstance?

Erfahren Sie, wie Passinstance Apple-Wallet- und Google-Wallet-Karten ohne eigene Kunden-App bereitstellt.

In dieser Anleitung

Überblick

Passinstance ist eine hochverfügbare Infrastrukturplattform für digitale Wallet-Karten, entwickelt für Unternehmen, Entwickler und Enterprise-Systeme. Sie bietet durchgängige Werkzeuge zum Gestalten, kryptografischen Signieren, Verteilen, dynamischen Aktualisieren und Validieren nativer digitaler Pässe in Apple Wallet (iOS & watchOS) und Google Wallet (Android) — ganz ohne dass Kundinnen und Kunden eine eigene mobile App herunterladen oder aktuell halten müssen.

Jeder Pass lebt nativ im Wallet-Stack des jeweiligen Betriebssystems. Endkundinnen und Endkunden fügen ihre Karte mit einem einzigen Tippen über einen Weblink, per E-Mail, SMS oder QR-Code hinzu. Nach der Installation zeigen die Pässe Echtzeit-Barcodes oder kontaktlose NFC-Zugangsdaten an, erhalten sofortige Push-Benachrichtigungen bei Kontostands- oder Statusänderungen und blenden automatisch relevante Sperrbildschirm-Informationen ein, sobald sich das Gerät in der Nähe physischer Standorte befindet.

Plattformarchitektur & Technologie-Stack

Die Passinstance-Plattform basiert auf einer hochgradig nebenläufigen, modularen NestJS-Backend-Architektur mit asynchronen Job-Warteschlangen und Cloud-Wallet-Provider-Konnektoren:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
PLATTFORMARCHITEKTUR
STUFE 01 CLIENT- & EINGABE-EBENE
Admin-Dashboard
(React / Vite SPA)
Kassensystem & POS
(Mobil / Web / API)
Öffentlicher PassFlow
(Self-Service-Erfassung)
STUFE 02 PASSINSTANCE CORE BACKEND (API)
Modulare NestJS-Engine (apps/api)
Globales Präfix: /api/v1 und Apple Web Service: /v1
RBAC Guard & Mandantentrennung (Organization / Customer)
Mechanik-Engine (Pass Mechanics Engine, Tier Progression Engine)
Kryptografischer Signer (Apple Wallet Packager PKCS#7 & Google JWT Genera
database DB
Passinstance data l
Mandanten-Scoping
in-memory cache &
Job Q
Worker-Pipeline
kground job queue
es & APNs| | Retin
Grafiken (Assets)
STUFE 01 WALLET-CLOUD-NETZWERKE
Apple APNs HTTP/2
Gateway-Protokoll
Google Wallet
REST Cloud API
STUFE 02 KUNDENGERÄTE
Apple Wallet
(iOS/watchOS)
Google Wallet
(Android)

Zentrale Backend-Komponenten

  1. 1
    API-Gateway & modulare Fachmodule: Entwickelt mit NestJS und gegliedert in Domänenmodule wie Template subsystem, Pass subsystem, Pass mechanics subsystem, Scanner subsystem, Onboarding subsystem und Certificate subsystem.
  2. 2
    Passinstance data layer & database: Setzt strikte Fremdschlüssel-Isolation sowie structured JSON-Attribute um, die über database-GIN-Indizes für dynamische Feldabfragen indiziert werden.
  3. 3
    background job queue- & in-memory cache-Pipelines: Steuert asynchrone Massenoperationen mit hohem Durchsatz, darunter CSV-Pass-Generierungsjobs, Massen-E-Mail-Versand über managed email delivery und geplante Push-Benachrichtigungen.
  4. 4
    Kryptografische Signatur-Engine: Verpackt Apple .pkpass-Pakete mit abgetrennten PKCS#7-Signaturen gegen offizielle Apple-WWDR-G4/G6-Zertifikate und erzeugt signierte JWT-Tokens für Google-Wallet-Objekte.

Wichtig: Alle Kundendaten, Vorlagen und kryptografischen Signaturschlüssel werden vollständig DSGVO-konform und nach strengen Richtlinien zur Mandantentrennung in AWS Europa (Frankfurt, eu-central-1) gehostet.

Zwei Nutzungsarten für Teams

Je nach Ihren technischen Anforderungen bietet Passinstance sowohl eine vollständige No-Code-Betriebsoberfläche als auch eine OpenAPI-konforme Entwicklerplattform:

BetriebsmodusZielgruppeZentrale Funktionen & zugrunde liegende Endpunkte
No-Code-DashboardMarketing-Teams, Einzelhandel, Mitgliederclubs, Event-VeranstalterVisueller Drag-and-Drop-Vorlageneditor, CSV-Massenausgabe (POST /api/v1/batch-processing), Delivery-Center-Kampagnen, Web- & Mobile-Scanner-Kopplung.
Entwickler-REST-APISoftware-Engineers, Kassensysteme (POS), CRM- & E-Commerce-PlattformenVollständiger programmatischer Pass-Lebenszyklus (/api/v1/passes), Echtzeit-Scan-Prüfung (/api/v1/scans), duale HMAC-SHA256-Push-/Pull-Webhooks, berechtigungsbegrenzte API-Schlüssel (pi_live_, pi_test_).

Unterstützte Pass-Programme & Katalogtypen

Passinstance unterstützt nativ alle gängigen digitalen Wallet-Pass-Formate von Apple und Google über das Backend-Enum pass type:

  • Treue- & Stempelkarten (storeCard): Visuelle Stempelkarten (STAMP_CARD_ADD, STAMP_CARD_DEDUCT) sowie fortlaufende Umsatz-zu-Punkte-Prämienprogramme (LOYALTY_PROGRAM).
  • Mitglieds- & Abo-Karten (membership / generic / posterGeneric): Digitale Ausweise mit automatischer Laufzeitverlängerung (RENEW_EXPIRATION), Profilfotos, WWDC-Poster-Styling (posterGeneric) und AirDrop-Freigabebeschränkungen.
  • Coupons & Gutscheine (coupon): Einmalig einlösbare Aktionspässe, geschützt durch VOIDED_AFTER_SCAN scan mode oder INVALIDATE_AFTER_SCAN, um Screenshot-Missbrauch zu verhindern.
  • Geschenk- & Prepaid-Karten (storeCard): Guthabenkonten (PREPAID_CARD) auf Basis einer doppelten Buchführung in kleinsten Währungseinheiten.
  • Event-Tickets & Bordkarten (eventTicket / boardingPass): Live-Veranstaltungstickets mit Gate-/Sitzplatzfeldern, WWDC25-Poster-Layouts (theme preference), MapKit-Veranstaltungsort-Hinweisen und Drehkreuz-Check-in-Regeln sowie Transit-Pässen (transit type: Air, Boat, Bus, Train, Generic).
  • Mitarbeiter-, Studierenden- & digitale Visitenkarten (studentId / businessCard / generic): Identitätsausweise und interaktive Kontaktkarten mit kontaktloser NFC-Übertragung (Apple VAS & Google Smart Tap) und sofortigem Widerruf.

Zentrale Plattformfunktionen in Backend & Frontend

FunktionBackend-Implementierung (Passinstance API)Frontend-Oberfläche (Passinstance Dashboard / scanner)
Korrelation mit externen Systemen (externalId)Mandantenweit eindeutiger optionaler Schlüssel (externalId, max. 255 Zeichen), indiziert pro aktivem Pass (archivedAt IS NULL), ermöglicht idempotenten CRM-Sync über POST /api/v1/passes/upsert-by-external-id.Durchsuchbar in den /passes-Listenfiltern, in der CSV-Spaltenzuordnung (Bulk Pass Wizard) und im Pass Details panel.
Idempotente Ausgabe (idempotencyKey)HTTP-Header Idempotency-Key (<=128 Zeichen [A-Za-z0-9._:-]+), gespeichert mit SHA-256-Payload-Prüfung, um doppelte Kartenerstellung bei Netzwerk-Retries zu verhindern.Wird automatisch von retry-sicheren Assistenten und SDKs erzeugt und ist in den Pass-API-Logs einsehbar.
Multi-Karten-Bündelung (bundleId)Pass.bundleId (bundleId) verknüpft bis zu 10 zusammengehörige Pässe in einem Apple-Wallet-.pkpasses-Archiv über pass bundle (bundle grouping mode: AUTO \MANUAL).Verwaltet über PassProject (Wallet Experiences -> Tab Bundle) oder per Mehrfachauswahl in /bundles/:id.
Pass-Mechaniken & Scannermechanic type, ScanMode, StoredValueOperation und Replay-geschützte Nonces auf POST /api/v1/scans.Validierung durch Mitarbeitende über den Web-Scanner (/scanner), die mobile App Passinstance Scanner (iOS/Android/Expo mit Offline-Warteschlange) oder externe Kassensysteme (/v1/pos/redeem).

Kapazitätsmessung & Hosting-Garantien

Passinstance bemisst die Abonnement-Kapazität anhand der aktiven Wallet-Pässe (der Anzahl der aktuell auf Kundengeräten installierten und mit APNs- oder Google-Wallet-Push-Endpunkten verbundenen Pässe). Entwürfe, gelöschte Pässe und nicht installierte Download-Links verbrauchen kein aktives Abonnement-Kontingent.

Entdecken Sie unsere Plattformübersicht und erfahren Sie mehr über Pass-Mechaniken & Funktionen.

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.