¿Cuál es la API de PassKit?

El marco de Apple PassKit es un conjunto completo de herramientas y servicios que permiten a los desarrolladores de iOS crear, distribuir y gestionar pases digitales para Apple Wallet. Un pase puede ser un pase de embarque, ticket de evento, tarjeta de fidelidad, tarjeta de regalo, cupón o cualquier otro tipo de credenciales que se beneficie de ser almacenado de forma segura en el dispositivo de usuario.

Cada pase se envasa como un archivo —un archivo ZIP firmado que contiene datos, imágenes y cadenas de localización JSON. Cuando un usuario abre este archivo (a través de un enlace, correo electrónico o descarga in-app), iOS valida la firma y presenta el pase en Wallet. Desde ese momento, el pase vive en el dispositivo, puede ser actualizado sobre el aire, y funciona incluso cuando está fuera de línea para información crítica como códigos o QR.

Cómo funciona la API de PassKit

Estructura de archivo de paso

Un archivo es un archivo ZIP estándar que debe contener al menos un manifiesto, un (una lista de todos los archivos con sus hashes SHA‐1), y un archivo de firma ().El archivo define todo el contenido de pase: campos de encabezado, campos primarios, campos secundarios, subdirectorios de barras, etc

Firma y distribución

Apple requiere que todos los pases sean firmados criptográficamente usando un certificado de desarrollador (obtenidos a través del Portal de Desarrolladores de Apple). La firma verifica la autenticidad e integridad del pase. Una vez firmado, el pase puede ser hospedado en un servidor y distribuido a través de una URL que activa la instalación de Wallet. Alternativamente, los pases pueden ser enviados como archivos adjuntos de correo electrónico, incrustados en códigos QR, o empujados directamente desde su aplicación usando el [LT:10] [LT]

Actualizaciones en tiempo real a través de Push

Una de las características más poderosas de PassKit es la capacidad de actualizar pases después de la emisión. Cuando un vuelo cambia las puertas o un ticket se actualiza, el servidor puede enviar una notificación de empuje silenciosa al dispositivo del usuario. El dispositivo luego sembra un nuevo archivo de la URL del servicio web registrado. El pase en Wallet es reemplazado sin problemas, y el usuario ve la información actualizada inmediatamente.

El flujo de actualización de empuje requiere un servicio web que cumple con la especificación de Apple: el servicio debe exponer puntos finales para obtener el último pase, números de serie y registro remoto de dispositivos. Esto se implementa normalmente en su backend usando Node.js, PHP, Python, o cualquier pila que pueda manejar las solicitudes HTTP.

Beneficios clave para el embarque y la gestión de entradas

Conveniencia de usuario y fricción reducida

El guardar un pase de embarque o un billete en Apple Wallet elimina la necesidad de fusionarse para una versión de papel o mantener abierta una aplicación de terceros. Los pases son accesibles desde la pantalla de bloqueo (a través de geosentencia, notificación basada en el tiempo o grifo manual) y se pueden escanear rápidamente en las puertas, los torntiles o puntos de entrada. Para las aerolíneas, esto acelera el embarque.

Datos fiables, siempre disponibles

Una vez descargado un pase, la imagen de código de barras y la información clave se almacenan localmente. Incluso si el dispositivo pierde conectividad celular, el pase sigue siendo escandaloso. Esto es crítico en aeropuertos, estadios y centros de tránsito donde la cobertura de red puede ser manchada. El pase también aparece en la pantalla de bloqueo cuando se acerca la fecha/tiempo pertinente, gracias a la inteligencia de Apple.

Actualizaciones dinámicas sin acción de usuario

Con actualizaciones basadas en la notificación de empuje, cualquier cambio al contenido de pase puede reflejarse inmediatamente. Para un retraso de vuelo, el tiempo estimado de salida en las actualizaciones de pases; para un festival, un cambio de escenario aparece en el ticket. Los usuarios no tienen que refrescar o descargar nada manualmente. Esto reduce las solicitudes de soporte y mejora la experiencia general.

Seguridad y Anti-Fraud mejorados

Los pases de Apple Wallet se firman con un certificado de desarrollador, por lo que se puede detectar la manipulación. Además, los pases pueden incluir un número de serie único que puede validar la parte del servidor. Para eventos de alto valor, puede combinar PassKit con cheques de servidor, por ejemplo, invalidando un pase remotamente si se reembolsa, luego empujando una versión actualizada con un estado “voided”.

Creación de pases y diseño

Definir campos de paso

El contenido de pases se divide en grupos lógicos: campos de cabecera (por ejemplo, “Paso de carga”), campos primarios (por ejemplo, “Número de viaje frecuente”), campos secundarios (por ejemplo, “Segundo 23A”), campos auxiliares (por ejemplo, “Número de viajero frecuente”) y campos de respaldo (por ejemplo, tipo, términos y condiciones).

Códigos de barras y códigos de QR

Cada pase debe incluir al menos un objeto de código de barras. Puede utilizar , , o (los últimos dos son comunes para el embarque de líneas aéreas).El valor de código de barras, por lo general el número de entrada o un código de confirmación, se codifica en la imagen a la hora de generación pasada.

Directrices de diseño visual

Apple proporciona unas directrices de diseño sólidas para asegurar que los pases se vean consistentes en dispositivos. El logotipo debe ser simple y centrado, el fondo debe complementar el código de barras, y las imágenes de tira (opcional) pueden añadir flair de marca. Necesitas proporcionar imágenes en múltiples resoluciones (1x, 2x, 3x) para todas las densidades de pantalla. Con el aumento de iPhones más grandes, el diseño de pase se adapta automáticamente, pero es esencial una prueba cuidadosa.

Para un ejemplo práctico de un pase correctamente estructurado JSON, vea el oficial de Apple Crear un pase documentación.

Localización

Los pases pueden ser localizados incluyendo subdirectorios específicos para el lenguaje (por ejemplo, ], ) dentro del paquete . El puede referirse a estas cadenas localizadas para etiquetas y valores de campo. Esto es particularmente importante para las compañías aéreas internacionales y los organizadores de eventos globales que quieren presentar información de tickets en el idioma preferido del usuario.

Distribución de pases a los usuarios

In‐App Direct Addition

Si su aplicación es el punto de contacto primario, puede agregar programáticamente un pase a Wallet usando (iOS 6+) o el más moderno (iOS 12+). El archivo de pase debe ser descargado primero desde su servidor (como NSData) y luego presentado al usuario. Un flujo estándar: el usuario compra un ticket o cheques en, su app fetches el [F]

Distribución por correo electrónico y web

Para los usuarios que no tienen instalada su aplicación (o prefieren no utilizarla para la gestión de pases), puede enviar un enlace al archivo o colocar un enlace de descarga directa en un sitio web. Cuando el usuario pulsa el enlace en un dispositivo iOS, Safari abre automáticamente Wallet y da instrucciones para añadir el pase. También puede utilizar Enlaces Universales para mejorar la experiencia. Este método es ampliamente utilizado por las aerolíneas que envían enlaces de confirmación de reserva.

Código QR o escáner de código de barras

Otro patrón común es incrustar una URL señalando el archivo en un código QR. Cuando se escanea con la aplicación de la cámara, iOS muestra una bandera de Wallet en la parte superior de la pantalla. Tapping añade el pase. Esto es ideal para hacer un ticket de pase en oficinas de caja de eventos o kioscos de autoservicio en los aeropuertos. Para más detalles sobre este enfoque, consulte el

Actualizar los pases en tiempo real

Arquitectura de actualización basada en empuje

Para habilitar actualizaciones automáticas, debe implementar un servicio web simple que puede llamar Apple Wallet. El servicio debe exponer tres puntos finales:

  1. Obtenga la última versión de un pase (llamado por Wallet cuando recibe una notificación de empuje).
  2. Obtener números de serie para un dispositivo (utilizados durante el registro inicial y para detectar cambios).
  3. Registración y desregistración (se almacena fichas de dispositivo para notificaciones de empuje).

Cuando un pase necesita actualizar, su servidor envía una notificación de empuje (utilizando APNs) a los dispositivos registrados. El dispositivo entonces consulta el servicio web para un nuevo archivo . Si la versión de pase ha cambiado, Wallet descarga y reemplaza el viejo pase en silencio. El contenido actualizado (por ejemplo, puerta nueva, nuevo tiempo de salida, estado de vacío) es instantáneamente visible para el usuario.

Cuándo utilizar actualizaciones

Los casos de uso común incluyen:

  • Cambios, demoras o cancelaciones de la puerta de vuelo
  • Cambios de programación o lugar de celebración
  • Actualizaciones o rebajas de asientos
  • Validación de entradas (por ejemplo, escanear en la entrada marca el pase como se utiliza)
  • Actualizaciones de seguridad (por ejemplo, reemplazando un código de barras después de un intento de escanear)

Tenga en cuenta que cada pase sólo puede ser actualizado utilizando el mismo certificado utilizado para firmarlo originalmente. No puede cambiar el tipo de pase o el identificador de la organización después de la emisión.

Prácticas óptimas para la aplicación

Seguridad y confianza

  • Mantenga su certificado de firma y clave privada en un entorno de servidor seguro, nunca en el código cliente.
  • Validar todas las solicitudes de registro de presión entrantes para prevenir la inyección de token.
  • Utilice HTTPS para todas las interacciones entre su servidor y Apple Wallet.
  • Considere usar códigos de barras o ID de corta duración para eventos de alta seguridad.
  • Implementar la tasa limitándose en los puntos finales de su servicio web.

Experiencia de usuario

  • Mostrar la opción “Añadir a Wallet” en el momento más relevante, después de la confirmación de compra, después de la entrada, o al comienzo de un día de evento.
  • Utilice un estilo claro y de alto contraste para códigos de barras y asegure que cumplan con los requisitos de tamaño mínimo (al menos 2 pulgadas de ancho en equivalentes de impresión).
  • Mantenga el paso simple: evite el desorden con campos innecesarios. La vista de la pantalla de bloqueo debe mostrar los tres pedazos más críticos de información.
  • Prueba pasa en dispositivos reales con diferentes versiones de iOS. Simulator puede renderizar pases, pero no puede probar actualizaciones de empuje o escaneado real allí.

Integración de backend

Su servicio de generación de pases debe ser idempotente y escalable. Utilice una base de datos para mapear el número de serie de cada usuario a su evento o reserva de vuelo. Almacene las fichas del dispositivo para actualizaciones de empuje. Muchos equipos apalancan bibliotecas como Protobuf o los ayudantes del servidor existentes (por ejemplo,

Pruebas y QA

Apple proporciona una herramienta de prueba de Wallet Pass dentro de Xcode que puede validar la estructura de su . Úsalo antes de distribuir pases. Además, prueba el ciclo de vida completo: añadir pase → actualización mediante push → pasar. Prueba con malas condiciones de red para asegurar los trabajos de pantalla de códigos de barras sin conexión. Simula las notificaciones de presión usando herramientas de APNs para verificar que tus puntos de servicio web respondan correctamente.

Ejemplos y Casos de Uso en el Mundo Real

Aerolíneas y aeropuertos

Todas las principales aerolíneas —Delta, United, Emirates y muchos otros— utilizan PassKit para pasar el embarque. Los pasajeros pueden consultar a través de la aplicación de la aerolínea, añadir el pase de embarque a Wallet y utilizarlo durante su viaje. Los cambios de puerta y reasignaciones de asientos se empujan automáticamente. Algunas aerolíneas incluso utilizan el pase para mostrar acceso al salón o estado de embarque prioritario.

Entradas para eventos

Ticketmaster, Live Nation y muchas aplicaciones de festivales apoyan los pases de Apple Wallet. Los fans compran un ticket, reciben un pase con un código QR rotativo (para prevenir el fraude), y lo utilizan para la entrada. El pase también puede incluir compras adicionales como estacionamiento o actualizaciones VIP. Durante el evento, los organizadores pueden presionar actualizaciones sobre cambios de horario, mapas de lugares o alertas meteorológicas.

Transporte público y estacionamiento

Las agencias de tránsito de la ciudad (como MTA en Nueva York o TfL en Londres) han experimentado con PassKit para pases mensuales o entradas de un solo viaje. Algunas aplicaciones de aparcamiento utilizan Wallet como permisos de estacionamiento digital que pueden ser validados por los oficiales de seguridad. Los pases de tránsito se benefician de la misma capacidad de empuje en tiempo real, por ejemplo, si una línea de tren se interrumpe, el pase puede sugerir rutas alternativas.

Limitaciones y consideraciones

Aunque PassKit es poderoso, tiene limitaciones que los desarrolladores deben planear para:

  • iOS solamente:] Los pases no pueden ser añadidos a los dispositivos Android. Si su audiencia es multiplataforma, debe ofrecer una alternativa (por ejemplo, un PDF o un billete móvil basado en la web).
  • Ninguna interacción Bluetooth o NFC (por defecto): Los pases no admiten NFC a menos que incrustes la sesión NFC de una aplicación nativa. Para el verdadero tap‐and‐go, tendría que utilizar Core NFC por separado.
  • Push update latency: Mientras las notificaciones de empuje son rápidas, el dispositivo debe estar en línea para recibir el gatillo. Si un usuario está fuera de línea durante una actualización, el pase permanecerá estancado hasta que se conecten.
  • Memoria y almacenamiento: Cada pase es pequeño (normalmente 30–80 KB), pero si se emiten millones de pases, su servicio web de empuje debe manejar la alta concurrencia.
  • Renovación significativa: Los certificados de firma de pases expiran cada año o dos. Debe asegurarse de que su servidor actualice el certificado antes de la caducidad, de lo contrario todos los pases firmados con el certificado antiguo dejarán de ser actualizados (siempre funcionarán, pero los nuevos empujes fallan).

Conclusión

La API de iOS PassKit proporciona una manera robusta, segura y fácil de manejar pases de embarque y entradas en Apple Wallet. Al aprovechar la creación de pases, firmar, distribuir y actualizaciones de empuje en tiempo real, los desarrolladores pueden ofrecer una experiencia de viaje o evento sin problemas que mantenga informados a los usuarios sin necesidad de un compromiso de aplicaciones constante. Implementar PassKit requiere una atención cuidadosa a las directrices de diseño y seguridad de Apple, así como una infraestructura de servidor confiable, pero la rentabilidad sustancial.

Para más lectura, consulte la PassKit documentation] y la PassKit Programming Guide. Estos recursos cubren las claves JSON, especificaciones de imagen y el protocolo de actualización de empuje en detalle exhaustivo.