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 (
externalIdybundleId): Guarde el identificador de línea de pedido externo de cada entrada enexternalIdy agrupe hasta 10 entradas familiares o VIP bajo un mismoPass.bundleIdmediante/api/v1/bundlesoPassProjectpara que los asistentes añadan todas sus entradas en un solo toque con.pkpasses. -
Plantillas de demostración del catálogo:
event-ticketyconference-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:
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 payloadadmite de forma nativa enlaces opcionales HTTPS/mailto/tel mostrados en los Event Tickets modernos de Apple:bagPolicyURL,orderFoodURL,parkingInformationURL,purchaseParkingURL,directionsInformationURL,contactVenueEmail,contactVenuePhoneNumberycontactVenueWebsite. -
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ónALREADY_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
/api/v1/scans
{
"scannedBarcodeValue": "TKT-ARENA-90218-A"
}
Ejemplo de respuesta de validación (200 OK)
{
"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
Actualice la plantilla o los pases individuales mediante
PATCH /api/v1/passes/:ido una actualización por lotes CSV. -
2
Modifique el campo
gateoeventDate. -
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.
