Overview
Passinstance is a carrier-grade digital wallet pass infrastructure platform designed for businesses, developers, and enterprise systems. It provides end-to-end tooling to design, cryptographically sign, distribute, dynamically update, and validate native digital passes in Apple Wallet (iOS & watchOS) and Google Wallet (Android) without requiring customers to download or maintain a custom mobile app.
Every pass lives natively inside the operating system's wallet stack. End users add their card with a single tap from a web link, email, SMS, or QR code. Once installed, passes display real-time barcode or contactless NFC credentials, receive instant push notifications when balances or statuses change, and automatically surface relevant lock-screen information when near physical store locations.
Platform Architecture & Technical Stack
The Passinstance platform is built on a high-concurrency NestJS modular backend architecture with asynchronous job queues and cloud wallet provider connectors:
Core Backend Components
-
1
API Gateway & Modular Modules: Built with NestJS, organizing functionality into domain modules including
Template subsystem,Pass subsystem,Pass mechanics subsystem,Scanner subsystem,Onboarding subsystem, andCertificate subsystem. -
2
Passinstance data layer & database: Implements strict foreign key isolation and structured JSON attributes indexed via database GIN indexes for dynamic field queries.
-
3
background job queue & in-memory cache Pipelines: Manages asynchronous high-throughput batch operations, including CSV pass generation jobs, mass email sendouts via managed email delivery, and scheduled push notification broadcasts.
-
4
Cryptographic Signing Engine: Packages Apple
.pkpassbundles with detached PKCS#7 signatures against official Apple WWDR G4/G6 certificates and generates signed JWT tokens for Google Wallet objects.
Important: All customer data, templates, and cryptographic signing keys are hosted in AWS Europe (Frankfurt,
eu-central-1) in full compliance with GDPR and strict multi-tenant isolation policies.
Two Ways Teams Use Passinstance
Depending on your technical requirements, Passinstance offers both a complete no-code operational suite and an OpenAPI-compliant developer platform:
| Operational Mode | Target Audience | Primary Capabilities & Backing Endpoints |
|---|---|---|
| No-Code Dashboard | Marketing teams, retail operators, membership clubs, event organizers | Visual drag-and-drop template designer, CSV bulk issuance (POST /api/v1/batch-processing), Delivery Center campaigns, Web & mobile scanner pairing. |
| Developer REST API | Software engineers, POS systems, CRM & e-commerce platforms | Full programmatic pass lifecycle (/api/v1/passes), real-time scan verification (/api/v1/scans), dual-mode HMAC-SHA256 push/pull webhooks, scoped API keys (pi_live_, pi_test_). |
Supported Pass Programs & Catalog Types
Passinstance natively supports all major digital wallet pass formats defined by Apple and Google through the backend pass type:
-
Loyalty & Stamp Cards (
storeCard): Visual stamp punch cards (STAMP_CARD_ADD,STAMP_CARD_DEDUCT) and continuous spend-to-points reward programs (LOYALTY_PROGRAM). -
Membership & Subscription Cards (
membership/generic/posterGeneric): Digital credentials with automated expiry extension (RENEW_EXPIRATION), photo thumbnails, WWDC poster styling (posterGeneric), and AirDrop sharing restrictions. -
Coupons & Vouchers (
coupon): Single-use promotional passes enforced byVOIDED_AFTER_SCAN scan modeorINVALIDATE_AFTER_SCANto prevent screenshot replay. -
Gift & Prepaid Cards (
storeCard): Stored value accounts (PREPAID_CARD) backed by double-entry ledger tracking in minor currency units. -
Event Tickets & Boarding Passes (
eventTicket/boardingPass): Live event credentials with gate/seat fields, WWDC25 poster layouts (theme preference), MapKit venue guides, and turnstile check-in rules, or transit passes (transit type: Air, Boat, Bus, Train, Generic). -
Employee, Student & Digital Business Cards (
studentId/businessCard/generic): Identity badges and interactive contact cards with contactless NFC transmission (Apple VAS & Google Smart Tap) and instant revocation.
Key Platform Capabilities Across Backend & Frontend
| Capability | Backend Capabilities | Dashboard & Scanner Experience | |
|---|---|---|---|
External System Correlation (externalId) | Tenant-unique optional key (externalId, max 255 chars) indexed per live pass (archivedAt IS NULL), powering idempotent CRM sync via POST /api/v1/passes/upsert-by-external-id. | Searchable in /passes list filters, bulk CSV mapping (Bulk Pass Wizard), and Pass Details panel. | |
Idempotent Issuance (idempotencyKey) | HTTP Idempotency-Key header (<=128 chars [A-Za-z0-9._:-]+) stored with SHA-256 request payload verification to prevent duplicate card creation on network retries. | Automatically generated by retry-safe wizards and SDKs; inspectable in pass API logs. | |
Multi-Card Bundling (bundleId) | Pass.bundleId (bundleId) links up to 10 companion passes into an Apple Wallet .pkpasses archive via pass bundle (bundle grouping mode: AUTO \ | MANUAL). | Managed via PassProject (Wallet Experiences -> Bundle tab) or batch selection in /bundles/:id. |
| Pass Mechanics & Scanners | mechanic type, ScanMode, StoredValueOperation, and replay-protected nonces on POST /api/v1/scans. | Operator validation via web scanner (/scanner), Passinstance Scanner mobile app (iOS/Android/Expo with offline queue), or external POS (/v1/pos/redeem). |
Capacity Metering & Hosting Invariants
Passinstance measures subscription capacity by Active Wallet Passes (the count of passes currently installed on customer devices and connected to APNs or Google Wallet push endpoints). Draft records, deleted passes, and uninstalled download links do not consume active subscription quota.
Explore our Platform Overview and learn more about Pass Mechanics & Features.
