Ü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:
Zentrale Backend-Komponenten
-
1
API-Gateway & modulare Fachmodule: Entwickelt mit NestJS und gegliedert in Domänenmodule wie
Template subsystem,Pass subsystem,Pass mechanics subsystem,Scanner subsystem,Onboarding subsystemundCertificate subsystem. -
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
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
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:
| Betriebsmodus | Zielgruppe | Zentrale Funktionen & zugrunde liegende Endpunkte |
|---|---|---|
| No-Code-Dashboard | Marketing-Teams, Einzelhandel, Mitgliederclubs, Event-Veranstalter | Visueller Drag-and-Drop-Vorlageneditor, CSV-Massenausgabe (POST /api/v1/batch-processing), Delivery-Center-Kampagnen, Web- & Mobile-Scanner-Kopplung. |
| Entwickler-REST-API | Software-Engineers, Kassensysteme (POS), CRM- & E-Commerce-Plattformen | Vollstä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 durchVOIDED_AFTER_SCAN scan modeoderINVALIDATE_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
| Funktion | Backend-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 & Scanner | mechanic 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.
