Cómo Funciona la Instalación Inteligente de Pases
Añadir una tarjeta de fidelidad, entrada para eventos, pase de membresía o cupón a su smartphone toma menos de 10 segundos y no requiere descargar ninguna aplicación de terceros. Cuando abre un enlace inteligente de Passinstance, el backend detecta el sistema operativo de su dispositivo y lo dirige a un paquete .pkpass de Apple Wallet (firmado con el Pass Type ID bundleId del comercio) o a un JWT de guardado de Google Wallet firmado con RS256.
Endpoints de Distribución Inteligente
Passinstance ofrece flujos de instalación para titulares a través de tres patrones de rutas públicas gestionados por Download Page API y Public Download Page:
| Patrón de Ruta | Método | Propósito |
|---|---|---|
/d/:slug | GET | Enlace corto personalizado para SMS, carteles QR y campañas de correo electrónico. Realiza detección automática de SO y entrega a la billetera. |
/download/:slug | GET | Página PassFlow de descarga explícita que muestra la vista previa del pase, el tema de la marca y los botones Añadir a la Billetera específicos de la plataforma. |
/s/:token | GET | Enlace con token de acceso por titular firmado criptográficamente con expiración opcional (downloadUntil) y comprobaciones de PIN. |
Guía Paso a Paso para Titulares de Pases
1. En iPhone y Apple Watch (Apple Wallet)
-
1
Toque su enlace de pase personal para que se abra en Safari (si tocó el enlace dentro de Instagram, TikTok o LinkedIn, toque el icono del navegador en la esquina inferior derecha para abrirlo en Safari nativo).
-
2
Toque Añadir a Apple Wallet: iOS reconoce inmediatamente el paquete
application/vnd.apple.pkpassy despliega la hoja nativa de vista previa del pase. -
3
Toque Añadir en la esquina superior derecha de la pantalla de vista previa.
-
4
Sincronización con Apple Watch: Si lleva puesto un Apple Watch enlazado, iOS refleja automáticamente los pases elegibles en la aplicación Cartera de su muñeca.
-
5
Acceso Rápido: Haga doble clic en el botón lateral de su iPhone en cualquier momento para mostrar su pase guardado en la caja o en la entrada del recinto.
2. En Android (Google Wallet)
-
1
Abra el enlace de su pase en Google Chrome o en su navegador predeterminado de Android.
-
2
Toque Añadir a Google Wallet: esto abre la hoja de guardado autenticada de Google (
https://pay.google.com/gp/v/save/<jwt>). -
3
Verifique que la cuenta de Google que se muestra en la parte superior del aviso coincida con la cuenta con sesión iniciada en la aplicación Google Wallet de su teléfono y, a continuación, toque Añadir a Wallet.
-
4
Toque Ver en Wallet para mostrar su código de barras o pase NFC sin contacto de inmediato.
3. Abrir un Enlace de Pase en un Ordenador Portátil o de Escritorio
Los ordenadores de escritorio no ejecutan Apple Wallet ni Google Wallet de forma nativa. Cuando abre un enlace /d/:slug o /s/:token en macOS o Windows:
{
"detectedPlatform": "DESKTOP",
"handoffMode": "QR_CODE_LANDING_PAGE",
"qrTargetUrl": "https://wallet.yourbrand.com/s/eyJhbGciOiJIUzI1Ni...",
"instructions": "Scan this QR code with your iPhone or Android camera to add the pass directly to your phone."
}
Apunte la cámara de su iPhone o Android al código QR en pantalla y toque el aviso que aparece para completar la instalación en su teléfono.
Importante: Algunos emisores protegen las tarjetas VIP de alto valor o las credenciales de empleados mediante vinculación a un único dispositivo (
limitToOneActivePerPass: true) o un PIN de descarga. Si se le solicita, introduzca el PIN enviado a su correo electrónico o SMS antes de tocar Añadir a la Billetera.
¿Tiene problemas para instalar su tarjeta? Consulte Resolver Problemas de Billetera o descubra cómo localizar una tarjeta existente en Encontrar o Recuperar su Pase.
