Skip to content
Guía del Centro de ayuda
4 min de lecturaVerificado 2026-11-16

Entradas de eventos y control de acceso

Entrega entradas móviles con asiento/puerta, cambios de horario en vivo y escaneo ágil en puerta.

En esta guía

Descripción general

Passinstance sustituye los adjuntos PDF estáticos y las entradas impresas por pases nativos digitales de tipo Event Ticket dentro de Apple Wallet y Google Wallet. Organizadores de eventos, festivales de música, estadios deportivos y productores de conferencias ofrecen accesos de alto rendimiento en puertas, avisos de horarios en tiempo real y mapas de navegación del recinto directamente en el smartphone del asistente.

Arquitectura del backend y tipos de pase

En el backend de Passinstance, las entradas para eventos se modelan mediante tipos nativos de monedero:

  • Tipo de pase (pass type): eventTicket.
  • Variantes de diseño (theme preference):

- posterEventTicket: Implementa el diseño tipo póster de Apple para eventos con gráfico de borde a borde (ranura de recurso artwork) y superposiciones limpias de metadatos. - bannerEventTicket: Clásico banner horizontal en franja con datos destacados de asiento y puerta.

  • Categorización del evento (Apple Wallet event type):

- PKEventTypeLivePerformance: Conciertos, teatro y espectáculos. - PKEventTypeSports: Partidos en estadios y torneos. - PKEventTypeConference / PKEventTypeConvention / PKEventTypeWorkshop: Cumbres de varios días, ferias comerciales y talleres. - PKEventTypeMovie: Cines y festivales de cine. - PKEventTypeGeneric / PKEventTypeSocialGathering: Admisión general y encuentros sociales.

  • Agrupación de pedidos con múltiples entradas (externalId y bundleId): Guarde el identificador de línea de pedido externo de cada entrada en externalId y agrupe hasta 10 entradas familiares o VIP bajo un mismo Pass.bundleId mediante /api/v1/bundles o PassProject para que los asistentes añadan todas sus entradas en un solo toque con .pkpasses.
  • Plantillas de demostración del catálogo: event-ticket y conference-badge.

Guía de eventos de Apple e integración de recintos con MapKit

Para recintos y grandes festivales, los pases de Passinstance se integran con Apple Maps para ofrecer navegación contextual y servicios del evento:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
AVISO DE ENTRADA Y ACCESO EN TORNO
ACTORES DEL SISTEMA
P1 Geocerca del recinto y RelevantDate
P2 Pantalla bloqueo asistente
P3 Escáner del torno
P4 API Passinstance
PASO CTX CONTEXTO Coords. GPS / hora apertura
PASO 1 SOLICITUD / ACCIÓN Aviso en pantalla
›
(Indicador nativo banner)
PASO 2 SOLICITUD / ACCIÓN Aztec 2D
›
(Lectura óptica)
PASO 3 SOLICITUD / ACCIÓN POST/api/v1/scans
›
Cabecera: x-scanner-key
PASO 4 SOLICITUD / ACCIÓN Verificar no usada
PASO 5 RESPUESTA 200 OK (ACCEPTED)
›
6. Registrar escaneo
›
(Pass Status = USED)
PASO 7 SOLICITUD / ACCIÓN Abre el torno

Guía del evento y URLs de acción del recinto (request payload)

  • venuePlaceID: Identificador de lugar en Apple Maps. Cuando está presente, Apple Wallet muestra un mapa interactivo del recinto, indicaciones de aparcamiento y enlaces de transporte público.
  • venueMap: Recurso gráfico personalizado estático con puertas de entrada, zonas VIP, aseos y salidas de emergencia.
  • Enlaces de acción complementarios del evento: request payload admite de forma nativa enlaces opcionales HTTPS/mailto/tel mostrados en los Event Tickets modernos de Apple: bagPolicyURL, orderFoodURL, parkingInformationURL, purchaseParkingURL, directionsInformationURL, contactVenueEmail, contactVenuePhoneNumber y contactVenueWebsite.
  • relevantDate / relevantDates: Fecha(s) W3C ISO 8601. iOS muestra automáticamente la entrada en la pantalla de bloqueo del usuario cuando se acerca la apertura de puertas.
  • Coordenadas de geocerca (locations): Coordenadas de latitud y longitud alrededor del recinto que activan la visualización en la pantalla de bloqueo al llegar el asistente al lugar.

Motor de validación en tornos y puertas de acceso

Las puertas de alto flujo de entrada requieren validación rápida y resistente ante caídas de red:

Modos de escáner (ScanMode)

  • CHECK_IN: Marca la entrada como escaneada para admitir el acceso. Si vuelve a presentarse en un torno, el motor rechaza la entrada con la decisión ALREADY_USED.
  • CHECK_OUT: Permite la salida temporal del recinto para zonas habilitadas o descansos.
  • SAVE_ATTENDANCE: Registra asistencia a sesiones (ideal para salas paralelas en congresos multisesión).

Ejemplo de solicitud de validación en acceso

POST /api/v1/scans
Cabeceras
x-scanner-key sk_live_gate_turnstile_02
Content-Type application/json
JSON
{
  "scannedBarcodeValue": "TKT-ARENA-90218-A"
}

Ejemplo de respuesta de validación (200 OK)

JSON
{
  "decision": "SUCCESS",
  "status": "ACCEPTED",
  "passSnapshot": {
    "id": "pass_tkt_90218",
    "templateId": "tmpl_event_5521",
    "serialNumber": "TKT-ARENA-90218-A",
    "status": "ACTIVE",
    "attributes": {
      "section": "104",
      "row": "F",
      "seat": "18",
      "gate": "Gate C"
    }
  }
}

Actualizaciones push de horarios en tiempo real

Cuando se producen retrasos meteorológicos, cambios de artistas o reasignaciones de puertas:

  1. 1
    Actualice la plantilla o los pases individuales mediante PATCH /api/v1/passes/:id o una actualización por lotes CSV.
  2. 2
    Modifique el campo gate o eventDate.
  3. 3
    Apple Wallet y Google Wallet reciben actualizaciones al instante:

- Apple Wallet muestra un aviso en la pantalla de bloqueo: "Puerta cambiada a Gate D" (mediante changeMessage: "Puerta cambiada a %@"). - Google Wallet actualiza el widget de la tarjeta en directo y notifica al usuario.

Requisitos previos: Utilice simbologías de código de barras 2D Aztec (PKBarcodeFormatAztec) o QR (PKBarcodeFormatQR) en las entradas de eventos. Los códigos Aztec cuentan con una elevada corrección de errores y se decodifican rápidamente con escáneres láser ópticos y cámaras incluso en pantallas móviles con poco brillo.

Explore nuestro Caso de uso de entradas para eventos y Eventos y venta de entradas.

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.