Aparcar desde el emisor de transporte

El flujo de trabajo de estacionamiento iniciado por el emisor puede activarse a través de uno de los siguientes 2 métodos:

1. El usuario utiliza su aplicación móvil.
2. Directamente desde el sistema del emisor de tránsito siguiendo las reglas de negocio.

En ambos casos, la solución D1 Transit recibe una solicitud del sistema del emisor de tránsito.

Esta sección ofrece una visión general del flujo de trabajo, incluidos los pasos detallados, diagramas de secuencia y posibles escenarios de error.

Flujo de trabajo

A continuación se muestran los pasos de alto nivel del flujo de trabajo de estacionamiento iniciado por el emisor:

1. Eliminación de la tarjeta: El emisor de tránsito inicia la eliminación de la tarjeta del dispositivo del usuario.
2. Desvincular tarjeta: D1 Transit notifica a Apple que la tarjeta de tránsito debe eliminarse del dispositivo del usuario.
3. Resultado del estacionamiento: Apple envía una notificación a D1 Transit con el resultado del flujo de trabajo de estacionamiento.

Diagrama de secuencia

Eliminación de la tarjeta

El emisor de tránsito instruye a D1 Transit para eliminar la tarjeta del dispositivo especificado.

Desvincular tarjeta

Al recibir una solicitud de D1 Transit para eliminar la tarjeta de un dispositivo, el servidor de Apple iniciará la eliminación del pase asociado.

Resultado del estacionamiento

Después de que el proceso de estacionamiento se complete en el lado de Apple, se envía un eventNotification a D1 Transit, proporcionando el resultado del flujo de trabajo de estacionamiento.

Si el evento es lifecycleOutcomeSuccess, D1 Transit notificará al emisor de tránsito y eliminará la tarjeta digital de su sistema y permitirá que la tarjeta se aprovisione en el mismo u otro dispositivo asociado con la misma cuenta de iCloud.

Escenarios de error

Estacionamiento fallido

Si el estacionamiento no tiene éxito, Apple informa a D1 Transit mediante un eventNotification con el parámetro eventType establecido en lifeCycleOutcomeFailure. El emisor de tránsito puede intentar reintentar el proceso de estacionamiento.

Dispositivo sin conexión

Como la solicitud no es iniciada por el dispositivo, no hay certeza de que el dispositivo esté en línea. En tales casos, la solicitud para eliminar la tarjeta puede no llegar nunca al dispositivo. Por ejemplo, el dispositivo puede estar en modo avión. Por lo tanto, se recomienda encarecidamente poner las tarjetas digitales aprovisionadas en la lista de denegación para evitar su uso en el tránsito.

El emisor de tránsito debe asegurarse de que la lista de denegación se haya propagado completamente en todos los lectores relevantes antes de permitir que la tarjeta se aprovisione en otro dispositivo. Este paso es crítico para evitar que la misma tarjeta de tránsito se utilice simultáneamente en múltiples dispositivos y prevenir un posible uso indebido.

Sin notificación de Apple

Si la plataforma D1 Transit no recibe un eventNotification dentro de un período de tiempo definido después de la solicitud managePass, se enviará una solicitud getStatus para verificar el estado del paquete de aprovisionamiento.

• Si la respuesta indica un estado activo, el estacionamiento está incompleto. La plataforma D1 notifica al emisor de tránsito, para que la instancia de la tarjeta pueda ponerse en la lista de denegación.
• Si el encabezado de la respuesta contiene un código de estado HTTP 404, confirma que la tarjeta ha sido eliminada con éxito y ya no existe en los servidores de Apple, es decir, el estacionamiento fue exitoso.

En ambos casos, debería ser posible aprovisionar la tarjeta en otro dispositivo asociado con la misma cuenta de iCloud.

Solicitud de notificación de evento retrasada desde Apple

Si la plataforma D1 Transit recibe un eventNotification de Apple después del período de tiempo predefinido (por ejemplo, el dispositivo vuelve a estar en línea después de un período prolongado), D1 Transit elimina la tarjeta digital de su sistema y notifica al emisor de tránsito que el estacionamiento fue exitoso. El emisor de tránsito elimina la instancia de la tarjeta de la lista de denegación.