Skip to content
Guía del Centro de ayuda · Ayuda para titulares de pasesFase de incorporación 4
3 min de lecturaVerificado 2026-11-16

Añadir un pase a tu Wallet

Guía para clientes finales sobre cómo guardar tarjetas en iPhone, Android o mediante código QR en ordenador.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado
Elementos clave de la interfaz

Vista previa en vivo de doble Wallet (Zoom)

Alterna entre Apple y Google en el panel de vista previa para confirmar el diseño, el formato del saldo, la legibilidad del código QR y la alineación de los campos.

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.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
ENRUTAMIENTO DE DESCARGA INTELIGENTE Y ENTREGA A BILLETERA
ETAPA 01 EL TITULAR ABRE EL ENLACE INTELIGENTE (GET/d/:slug, /download/:slug o /s/:token)
Public Download Page inspecciona User-Agent y controles de seguridad
ETAPA 02A TRANSMISIÓN APPLE
Transmite ZIP firmado application/vnd. apple.pkpass
Sincroniza Apple Watch
ETAPA 02B REDIRECCIÓN JWT GOOGLE
Firma JWT de Objeto RS256
Redirige a https:// pay.google.com/gp/v/save
Guarda en Cuenta Google
ETAPA 02C ENTREGA QR ESCRITORIO
Renderiza página de destino adaptable con código QR escaneable para cámara móvil

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 RutaMétodoPropósito
/d/:slugGETEnlace 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/:slugGETPá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/:tokenGETEnlace 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. 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. 2
    Toque Añadir a Apple Wallet: iOS reconoce inmediatamente el paquete application/vnd.apple.pkpass y despliega la hoja nativa de vista previa del pase.
  3. 3
    Toque Añadir en la esquina superior derecha de la pantalla de vista previa.
  4. 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. 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. 1
    Abra el enlace de su pase en Google Chrome o en su navegador predeterminado de Android.
  2. 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. 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. 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:

JSON
{
  "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.

¿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.