Skip to content
Guía del Centro de ayuda · Introducción a Passinstance
5 min de lecturaVerificado 2026-11-16

¿Qué es Passinstance?

Descubre cómo Passinstance impulsa pases de Apple Wallet y Google Wallet sin requerir una app propia para clientes.

En esta guía

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:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
ARQUITECTURA DE LA PLATAFORMA
ETAPA 01 CAPA DE CLIENTE E INGESTA DE DATOS
Panel de control
(React / Vite SPA)
Punto de venta / POS
(Móvil / Web / API)
PassFlow público
(Registro autoservicio)
ETAPA 02 BACKEND CENTRAL DE PASSINSTANCE (API)
Motor modular NestJS (apps/api)
Prefijo global: /api/v1 y Servicio Web de Apple: /v1
Guardias RBAC y aislamiento multitenant (Organization / Customer)
Motor de mecánicas (Pass Mechanics Engine, Tier Progression Engine)
Firmante criptográfico (Apple Wallet Packager PKCS#7 y generador JWT Goog
Base database
Esquema Passinstanc
Tenencia aislada
in-memory cache y ba
Colas
APNs en 2.º plano
round job queue
workers | | Recur de los pases
ETAPA 01 REDES EN LA NUBE DE WALLETS
Apple APNs HTTP/2
Protocolo Gateway
Google Wallet
API REST Cloud
ETAPA 02 DISPOSITIVOS CLIENTE
Apple Wallet
(iOS/watchOS)
Google Wallet
(Android)

Componentes principales del backend

  1. 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 subsystem y Certificate subsystem.
  2. 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. 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. 4
    Motor de firma criptográfica: Empaqueta archivos .pkpass de 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 operativoPúblico objetivoCapacidades principales y endpoints de respaldo
Panel sin códigoEquipos de marketing, operadores minoristas, clubes de socios, organizadores de eventosDiseñ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 desarrolladoresIngenieros de software, sistemas POS, plataformas CRM y de comercio electrónicoCiclo 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 mediante VOIDED_AFTER_SCAN scan mode o INVALIDATE_AFTER_SCAN para 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

CapacidadImplementació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áneresmechanic 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.

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.