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

Enlaces de descarga y PassFlow

Personaliza páginas PassFlow con detección de OS, guías PassTour, bloqueo PIN, límite de descargas y pausa de emergencia.

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 ampliado1 / 2
Elementos clave de la interfaz

Límites de emisión y controles de acceso (Zoom)

Configura emisión ilimitada o limitada, canales de acceso, enrutamiento de Wallet y protecciones como bloquear la redescarga tras la activación y deduplicar destinatarios.

Descripción general y arquitectura inteligente de endpoints

Cada pase emitido y cada enlace de distribución de plantilla en Passinstance se resuelve mediante un Motor inteligente de descarga consciente de la plataforma (modelo DownloadPage y Download Page API). En lugar de repartir enlaces distintos para Apple y Android, usted distribuye una única URL canónica (passAccessUrl, /d/:slug o /s/:token) que inspecciona dinámicamente la cabecera HTTP User-Agent del cliente, el contexto del navegador y el estado de seguridad antes de entregar el paquete de monedero correspondiente.

Interruptores de acceso a distribución y salvaguardas de enlaces
Interruptores de acceso a distribución y salvaguardas de enlaces
FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
ENRUTAMIENTO DE DESCARGA INTELIGENTE Y ENTREGA POR SO
ETAPA 01 SOLICITUD HTTP GET ENTRANTE DEL CLIENTE
GET/d/:slug | GET/download/:slug | GET/s/:token
ETAPA 02 TUBERÍA DE CONTROL DE ACCESO Y VALIDACIÓN DE TOKENS
1
Verificar estado de Pase/Plantilla (ACTIVE, passDownloadDeactivated=false)
2
Comprobar límite y bloqueo (enableDownloadUntil, limitToOneActivePerPass)
3
Evaluar desafío PIN (?pin= / X-Wallet-Experience-Pin si está habilitado)
iOS Safari / WebKit
ETAPA 03A Enviar ZIP .pkpass
Content-Type: application/vnd.apple. pkpass
Android Chrome
ETAPA 03B Redirección 302 a
JWT firmado Google pay.google.com/ gp/v/save/<jwt>
Escritorio / WebView en app
ETAPA 03C Mostrar página PassFlow
+ código QR dinámico (GET/d/:slug/qr) +
Email/SMS y PassTour

Detección dinámica de User-Agent y comportamiento por plataforma

  1. 1
    iPhone e iPad (Safari en iOS): Transmite en streaming el archivo .pkpass firmado criptográficamente con tipo MIME Content-Type: application/vnd.apple.pkpass, abriendo de inmediato la hoja modal nativa de iOS Añadir a Apple Wallet.
  2. 2
    WebViews integradas en aplicaciones iOS (Instagram, TikTok, Facebook, LinkedIn): Dado que los navegadores integrados en redes sociales bloquean flujos binarios application/vnd.apple.pkpass, Passinstance detecta el User-Agent integrado y muestra una pantalla guiada específica indicando al titular que abra el enlace en Safari nativo.
  3. 3
    Dispositivos Android: Emite una redirección HTTP 302 (o muestra un botón de un toque Añadir a Google Wallet) apuntando a https://pay.google.com/gp/v/save/<signed_jwt>, aprovisionando el LoyaltyObject, EventTicketObject o GenericObject en la nube directamente en Google Wallet.
  4. 4
    Navegadores de escritorio: Muestra una página PassFlow adaptativa con la imagen de marca y un código QR dinámico de alto contraste (GET /d/:slug/qr), junto con controles de envío autoservicio por correo o SMS (POST /d/:slug/send-link-by-email, POST /d/:slug/send-link-by-sms) para que el usuario traslade el pase a su teléfono en segundos.

Importante: Cuando está activada la Vinculación a un único dispositivo (limitToOneActivePerPass: true) en una plantilla o pase (sharingProhibited), el enlace inteligente de descarga se bloquea automáticamente en cuanto un dispositivo completa su primer registro mediante el Apple Wallet Web Service (POST /v1/devices/:deviceLibraryIdentifier/registrations/...) o el callback save de Google Wallet, impidiendo compartir el enlace sin autorización.

Endpoints de API de enlaces inteligentes y páginas de descarga

Las rutas públicas de resolución de descargas se montan fuera del prefijo /api/v1 en Public Download Page y Public Pass Recovery API (/d/:slug/* y alias /download/:slug/*, además de las rutas autenticadas de gestión bajo /api/v1/download-pages/*):

MétodoRuta del endpointÁmbito de authDescripción técnica
GET/d/:slugPúblicoEnrutador inteligente de entrada; redirige navegadores a /download/:slug o sirve metadatos JSON cuando se solicita; admite ?pass=:passId, ?lang=, ?pin=.
GET/d/:slug/infoPúblicoDevuelve metadatos JSON (request payload), tokens de marca, pasos de PassTour y disponibilidad del pase.
GET/d/:slug/qrPúblicoGenera una imagen escaneable de código QR que codifica la URL inteligente de descarga.
GET/d/:slug/downloadPúblicoDetecta el User-Agent y entrega .pkpass (iOS) o redirección JWT Save de Google (Android); respeta ?pin= o X-Wallet-Experience-Pin.
POST/d/:slug/createPúblico (con límite de tasa)Emite un pase directamente desde una página de descarga (request payload: name, email?, phone?, additionalFields?).
POST/d/:slug/send-link-by-emailPúblico (con límite de tasa)request payload ({ email, passLink? }) — envía por correo electrónico el enlace de descarga al usuario desde vistas de escritorio.
POST/d/:slug/send-link-by-smsPúblico (con límite de tasa)request payload ({ phoneNumber, passLink? }) — envía el enlace de descarga mediante SMS en formato E.164.
POST/d/:slug/request-recoveryPúblico (con límite de tasa){ emailOrPhone } — envía un enlace mágico de recuperación cuando un cliente cambia de teléfono o pierde su enlace.
GET/s/:tokenPúblicoEnlace inteligente canónico vinculado al serialNumber o token de un pase individual.

Seguridad de tokens, protección por PIN y entrega secundaria

Puede configurar salvaguardas de acceso granulares tanto a nivel de plantilla como en cada emisión individual de pase:

  • Caducidad de descarga (enableDownloadUntil): Establece un límite "YYYY-MM-DD HH:mm" o marca temporal ISO tras el cual los enlaces de descarga no reclamados dejan de emitir nuevos pases, mientras los ya instalados siguen activos en los monederos.
  • Bloqueo a un único dispositivo activo (limitToOneActivePerPass): Impide nuevas descargas una vez que el pase cuenta con un registro activo en dispositivo.
  • Bloqueo por PIN (parámetro pin / cabecera X-Wallet-Experience-Pin): Exige que el titular desbloquee con PIN los enlaces de descarga y paquetes .pkpasses antes de instalarlos (verificado mediante POST /api/v1/pass-projects/:id/validate-pin en Wallet Experiences).
  • Pausar todas las descargas (passDownloadDeactivated): Interruptor de emergencia en los ajustes de plantilla que detiene nuevas descargas en todos los canales sin revocar pases ya instalados en dispositivos de clientes.
  • Prioridad de resolución del pase (?pass=:passId): La resolución pública evalúa la disponibilidad específica del pase (P1), los valores predeterminados de la página de descarga (P2) y el respaldo del espacio de trabajo (P3), mientras pass bundle (bundleId) coordina las descargas .pkpasses entre tarjetas vinculadas.
  • Superposiciones opcionales PassTour: Guíe a los nuevos usuarios de Apple y Google Wallet con instrucciones visuales interactivas (Guía PassTour).

Ejemplo: payloads de entrega secundaria y recuperación

Cuando un cliente visualiza un pase en un ordenador de escritorio o pierde el acceso a su pase del monedero, la página PassFlow invoca los endpoints públicos de acción:

JSON
POST /d/vip-gold-2026/send-link-by-email
{
  "email": "alex.rivera@example.com",
  "passLink": "https://app.passinstance.com/d/vip-gold-2026?pass=pass_01j8k9m2"
}
JSON
POST /d/vip-gold-2026/request-recovery
{
  "emailOrPhone": "alex.rivera@example.com"
}

Consulte la documentación relacionada sobre Distribución en autoservicio, Entrega por correo electrónico y SMS y Buscar o recuperar su pase.

Documentación de producto y API relacionada

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