Descripción general
Passinstance es una plataforma de infraestructura de nivel empresarial para pases digitales diseñada para empresas, desarrolladores y sistemas corporativos. Proporciona herramientas completas de principio a fin para diseñar, firmar criptográficamente, distribuir, actualizar dinámicamente y validar pases nativos en Apple Wallet (iOS y watchOS) y Google Wallet (Android) sin exigir que los clientes descarguen o mantengan una aplicación móvil personalizada.
Cada pase reside de forma nativa dentro de la pila del monedero del sistema operativo. Los usuarios finales añaden su tarjeta con un solo toque desde un enlace web, correo electrónico, SMS o código QR. Una vez instalado, el pase muestra códigos de barras en tiempo real o credenciales NFC sin contacto, recibe notificaciones push instantáneas cuando cambian los saldos o estados y muestra información relevante en la pantalla de bloqueo al acercarse a ubicaciones físicas.
Arquitectura de la plataforma y pila tecnológica
La plataforma Passinstance se basa en una arquitectura backend modular en NestJS de alta concurrencia con colas de trabajos asíncronas y conectores en la nube de los proveedores de monederos:
Componentes principales del backend
-
1
API Gateway y módulos de dominio: Construido con NestJS, organiza la funcionalidad en módulos especializados como
Template subsystem,Pass subsystem,Pass mechanics subsystem,Scanner subsystem,Onboarding subsystemyCertificate subsystem. -
2
Passinstance data layer y database: Implementa un estricto aislamiento mediante claves foráneas y atributos structured JSON indexados con índices GIN de database para consultas dinámicas sobre campos.
-
3
Tuberías background job queue y in-memory cache: Gestiona operaciones por lotes asíncronas de alto rendimiento, incluyendo trabajos de emisión masiva mediante CSV, envíos masivos de correo electrónico con managed email delivery y difusiones programadas de notificaciones push.
-
4
Motor de firma criptográfica: Empaqueta archivos
.pkpassde Apple con firmas PKCS#7 independientes frente a los certificados oficiales Apple WWDR G4/G6 y genera tokens JWT firmados para los objetos de Google Wallet.
Importante: Todos los datos de los clientes, las plantillas y las claves de firma criptográfica están alojados en AWS Europa (Fráncfort,
eu-central-1) en pleno cumplimiento del RGPD y con estrictas políticas de aislamiento multitenant.
Dos formas de usar Passinstance
Según sus requisitos técnicos, Passinstance ofrece tanto una suite operativa completa sin código como una plataforma para desarrolladores compatible con OpenAPI:
| Modo operativo | Público objetivo | Capacidades principales y endpoints de respaldo |
|---|---|---|
| Panel sin código | Equipos de marketing, operadores minoristas, clubes de socios, organizadores de eventos | Diseñador visual de plantillas mediante arrastrar y soltar, emisión masiva CSV (POST /api/v1/batch-processing), campañas en Delivery Center, emparejamiento de escáner web y móvil. |
| API REST para desarrolladores | Ingenieros de software, sistemas POS, plataformas CRM y de comercio electrónico | Ciclo de vida completo de pases por código (/api/v1/passes), verificación de escaneos en tiempo real (/api/v1/scans), webhooks push/pull con firma HMAC-SHA256, claves de API con ámbito específico (pi_live_, pi_test_). |
Programas de pases y tipos de catálogo compatibles
Passinstance admite de forma nativa todos los principales formatos de pases de monedero digital definidos por Apple y Google a través del enum de backend pass type:
-
Tarjetas de fidelidad y sellos (
storeCard): Tarjetas visuales de acumulación de sellos (STAMP_CARD_ADD,STAMP_CARD_DEDUCT) y programas continuos de recompensas por puntos según el gasto (LOYALTY_PROGRAM). -
Tarjetas de membresía y suscripción (
membership/generic/posterGeneric): Credenciales digitales con renovación automática de vencimiento (RENEW_EXPIRATION), miniaturas fotográficas, estilo póster de la WWDC (posterGeneric) y restricciones para compartir por AirDrop. -
Cupones y vales (
coupon): Pases promocionales de un solo uso aplicados medianteVOIDED_AFTER_SCAN scan modeoINVALIDATE_AFTER_SCANpara evitar la reutilización de capturas de pantalla. -
Tarjetas de regalo y prepago (
storeCard): Cuentas de valor almacenado (PREPAID_CARD) respaldadas por un libro mayor de partida doble registrado en unidades monetarias mínimas. -
Entradas de eventos y tarjetas de embarque (
eventTicket/boardingPass): Credenciales de eventos en vivo con campos de puerta/asiento, diseños póster WWDC25 (theme preference), guías de recinto con MapKit y reglas de control de acceso, o pases de tránsito (transit type: Air, Boat, Bus, Train, Generic). -
Identificaciones de empleados, estudiantes y tarjetas de visita digitales (
studentId/businessCard/generic): Credenciales de identidad y tarjetas de contacto interactivas con transmisión NFC sin contacto (Apple VAS y Google Smart Tap) y revocación instantánea.
Capacidades clave en backend y frontend
| Capacidad | Implementación en backend (Passinstance API) | Experiencia en frontend (Passinstance Dashboard / scanner) | |
|---|---|---|---|
Correlación con sistemas externos (externalId) | Clave opcional única por inquilino (externalId, máx. 255 caracteres) indexada por pase activo (archivedAt IS NULL), que permite sincronización idempotente con CRM mediante POST /api/v1/passes/upsert-by-external-id. | Buscable en los filtros de listado /passes, mapeo masivo en CSV (Bulk Pass Wizard) y Pass Details panel. | |
Emisión idempotente (idempotencyKey) | Cabecera HTTP Idempotency-Key (<=128 caracteres [A-Za-z0-9._:-]+) almacenada con verificación SHA-256 del cuerpo de la solicitud para evitar tarjetas duplicadas ante reintentos de red. | Generada automáticamente por los asistentes seguros ante reintentos y los SDK; inspeccionable en los registros de la API del pase. | |
Agrupación de múltiples tarjetas (bundleId) | Pass.bundleId (bundleId) vincula hasta 10 pases complementarios en un archivo .pkpasses de Apple Wallet a través de pass bundle (bundle grouping mode: AUTO \ | MANUAL). | Gestionado desde PassProject (Wallet Experiences -> pestaña Bundle) o mediante selección por lotes en /bundles/:id. |
| Mecánicas de pase y escáneres | mechanic type, ScanMode, StoredValueOperation y nonces con protección contra repetición en POST /api/v1/scans. | Validación operativa mediante el escáner web (/scanner), la aplicación móvil Passinstance Scanner (iOS/Android/Expo con cola sin conexión) o un POS externo (/v1/pos/redeem). |
Medición de capacidad e invariantes de alojamiento
Passinstance mide la capacidad de la suscripción mediante Pases de monedero activos (el número de pases actualmente instalados en dispositivos de clientes y conectados a endpoints push de APNs o Google Wallet). Los registros en borrador, los pases eliminados y los enlaces de descarga sin instalar no consumen cuota de suscripción activa.
Explore nuestra Descripción general de la plataforma y descubra más sobre las Mecánicas de pases y funcionalidades.
