Overzicht
Passinstance is een robuust infrastructuurplatform voor digitale wallet-passen, ontwikkeld voor bedrijven, ontwikkelaars en enterprise-systemen. Het biedt end-to-end tooling om native digitale passen te ontwerpen, cryptografisch te ondertekenen, te distribueren, dynamisch bij te werken en te valideren in Apple Wallet (iOS & watchOS) en Google Wallet (Android), zonder dat klanten een eigen mobiele app hoeven te downloaden of te onderhouden.
Elke pas draait volledig native binnen de wallet van het besturingssysteem. Eindgebruikers voegen hun pas met één tik toe via een weblink, e-mail, sms of QR-code. Na installatie toont de pas realtime barcodes of contactloze NFC-inloggegevens, ontvangt de pas directe pushmeldingen zodra saldi of statussen wijzigen en verschijnt relevante informatie automatisch op het toegangsscherm in de buurt van fysieke winkellocaties.
Platformarchitectuur & technische stack
Het Passinstance-platform is gebouwd op een modulaire NestJS-backendarchitectuur met hoge gelijktijdigheid, asynchrone taakwachtrijen en cloudconnectors voor wallet-aanbieders:
Belangrijkste backendcomponenten
-
1
API Gateway & modulaire modules: Gebouwd met NestJS, waarbij functionaliteit is georganiseerd in domeinmodules waaronder
Template subsystem,Pass subsystem,Pass mechanics subsystem,Scanner subsystem,Onboarding subsystemenCertificate subsystem. -
2
Passinstance data layer & database: Implementeert strikte foreign-key-isolatie en structured JSON-eigenschappen die via database GIN-indexen zijn geïndexeerd voor dynamische veldquery's.
-
3
background job queue & in-memory cache-pipelines: Beheert asynchrone batchbewerkingen met hoge doorvoersnelheid, waaronder CSV-pasgeneratietaken, grootschalige e-mailverzendingen via managed email delivery en geplande pushmeldingen.
-
4
Cryptografische ondertekeningsengine: Verpakt Apple
.pkpass-bundels met losse PKCS#7-handtekeningen tegen officiële Apple WWDR G4/G6-certificaten en genereert ondertekende JWT-tokens voor Google Wallet-objecten.
Belangrijk: Alle klantgegevens, sjablonen en cryptografische ondertekeningssleutels worden gehost in AWS Europa (Frankfurt,
eu-central-1) in volledige overeenstemming met de AVG en strikt multi-tenant isolatiebeleid.
Twee manieren waarop teams Passinstance gebruiken
Afhankelijk van uw technische vereisten biedt Passinstance zowel een complete no-code operationele suite als een OpenAPI-compatibel ontwikkelaarsplatform:
| Gebruiksvorm | Doelgroep | Belangrijkste mogelijkheden & onderliggende endpoints |
|---|---|---|
| No-code dashboard | Marketingteams, retailmedewerkers, ledenclubs, evenementorganisatoren | Visuele drag-and-drop sjablooneditor, CSV-bulkuitgifte (POST /api/v1/batch-processing), Bezorgingscentrum-campagnes, koppeling met web- en mobiele scanners. |
| Developer REST API | Software-engineers, kassasystemen (POS), CRM- & e-commerceplatformen | Volledige programmatische paslevenscyclus (/api/v1/passes), realtime scanverificatie (/api/v1/scans), dual-mode HMAC-SHA256 push/pull-webhooks, afgeschermde API-sleutels (pi_live_, pi_test_). |
Ondersteunde pasprogramma's & catalogustypen
Passinstance ondersteunt native alle belangrijke digitale wallet-pasformaten die door Apple en Google worden gedefinieerd via de backend pass type:
-
Loyaliteits- & stempelkaarten (
storeCard): Visuele stempelkaarten (STAMP_CARD_ADD,STAMP_CARD_DEDUCT) en doorlopende spaarprogramma's op basis van bestedingen en punten (LOYALTY_PROGRAM). -
Lidmaatschaps- & abonnementspassen (
membership/generic/posterGeneric): Digitale bewijzen met geautomatiseerde vervaldatumverlenging (RENEW_EXPIRATION), fotominiaturen, WWDC-posterstijl (posterGeneric) en AirDrop-deelbeperkingen. -
Kortingsbonnen & vouchers (
coupon): Eenmalige promotiepassen die worden afgedwongen doorVOIDED_AFTER_SCAN scan modeofINVALIDATE_AFTER_SCANom hergebruik via screenshots te voorkomen. -
Cadeau- & prepaidkaarten (
storeCard): Accounts met opgeslagen waarde (PREPAID_CARD), ondersteund door dubbelboekhoudkundige grootboekregistratie in kleinste valuta-eenheden. -
Evenementtickets & instapkaarten (
eventTicket/boardingPass): Live evenementtickets met poort-/stoelvelden, WWDC25-posterlay-outs (theme preference), MapKit-locatiegidsen en toegangsregels bij tourniquets, of vervoersbewijzen (transit type: Air, Boat, Bus, Train, Generic). -
Medewerkers-, studenten- & digitale visitekaartjes (
studentId/businessCard/generic): Identiteitspassen en interactieve contactkaarten met contactloze NFC-overdracht (Apple VAS & Google Smart Tap) en directe intrekking.
Belangrijkste platformmogelijkheden in backend & frontend
| Mogelijkheid | Backendimplementatie (Passinstance API) | Frontend-ervaring (Passinstance Dashboard / scanner) | |
|---|---|---|---|
Koppeling met externe systemen (externalId) | Optionele tenant-unieke sleutel (externalId, max. 255 tekens) geïndexeerd per actieve pas (archivedAt IS NULL), voor idempotente CRM-synchronisatie via POST /api/v1/passes/upsert-by-external-id. | Doorzoekbaar in /passes lijstfilters, bulk-CSV-koppeling (Bulk Pass Wizard) en Pass Details panel. | |
Idempotente uitgifte (idempotencyKey) | HTTP-header Idempotency-Key (<=128 tekens [A-Za-z0-9._:-]+) opgeslagen met SHA-256-verificatie van de request-payload om dubbele pasaanmaak bij netwerkherpogingen te voorkomen. | Automatisch gegenereerd door retry-veilige wizards en SDK's; inspecteerbaar in pas-API-logboeken. | |
Multi-card bundeling (bundleId) | Pass.bundleId (bundleId) koppelt maximaal 10 bijbehorende passen in een Apple Wallet .pkpasses-archief via pass bundle (bundle grouping mode: AUTO \ | MANUAL). | Beheerd via PassProject (Wallet Experiences -> tabblad Bundle) of batchselectie in /bundles/:id. |
| Pasmechanieken & scanners | mechanic type, ScanMode, StoredValueOperation en tegen replay beveiligde nonces op POST /api/v1/scans. | Validatie door medewerkers via de webscanner (/scanner), de mobiele app Passinstance Scanner (iOS/Android/Expo met offline wachtrij) of een extern kassasysteem (/v1/pos/redeem). |
Capaciteitsmeting & hostinggaranties
Passinstance meet abonnementcapaciteit op basis van Actieve Wallet-passen (het aantal passen dat momenteel op apparaten van klanten is geïnstalleerd en verbonden is met APNs- of Google Wallet-pushendpoints). Conceptrecords, verwijderde passen en niet-geïnstalleerde downloadlinks verbruiken geen actief abonnementsquotum.
Bekijk ons Platformoverzicht en lees meer over Pasmechanieken & functies.
