Skip to content
Helpcentrum-gids · Introductie tot Passinstance
4 min leestijdGecontroleerd 2026-11-16

Wat is Passinstance?

Ontdek hoe Passinstance Apple Wallet- en Google Wallet-kaarten mogelijk maakt zonder eigen klantenapp.

In deze gids

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:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
PLATFORMARCHITECTUUR
FASE 01 CLIENT- & INVOERLAAG
Admin Dashboard
(React / Vite SPA)
Kassasysteem & POS
(Mobiel / Web / API)
Openbare PassFlow
(Selfservice-intake)
FASE 02 PASSINSTANCE CORE BACKEND (API)
NestJS Modulaire Engine (apps/api)
Global Prefix: /api/v1 en Apple Web Service: /v1
RBAC Guard & Multi-Tenant Scoping (Organization / Customer)
Mechanics Engine (Pass Mechanics Engine, Tier Progression Engine)
Cryptografische ondertekenaar (Apple Wallet Packager PKCS#7 & Google JWT)
database DB
Passinstance data l
Afgeschermde multi-tenancy
in-memory cache &
Taakw
& APNs Worker
Pipeline
kground job queue
trijen | | Retin visuele pas- assets
FASE 01 WALLET-CLOUDNETWERKEN
Apple APNs HTTP/2
Gateway Protocol
Google Wallet
REST Cloud API
FASE 02 KLANTAPPARATEN
Apple Wallet
(iOS/watchOS)
Google Wallet
(Android)

Belangrijkste backendcomponenten

  1. 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 subsystem en Certificate subsystem.
  2. 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. 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. 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:

GebruiksvormDoelgroepBelangrijkste mogelijkheden & onderliggende endpoints
No-code dashboardMarketingteams, retailmedewerkers, ledenclubs, evenementorganisatorenVisuele drag-and-drop sjablooneditor, CSV-bulkuitgifte (POST /api/v1/batch-processing), Bezorgingscentrum-campagnes, koppeling met web- en mobiele scanners.
Developer REST APISoftware-engineers, kassasystemen (POS), CRM- & e-commerceplatformenVolledige 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 door VOIDED_AFTER_SCAN scan mode of INVALIDATE_AFTER_SCAN om 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

MogelijkheidBackendimplementatie (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 & scannersmechanic 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.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.