Aprovisionamiento push

El flujo de trabajo de Push Provisioning permite a los usuarios aprovisionar tarjetas desde la aplicación del emisor a Google Wallet.

Flujo de trabajo

A continuación se presentan los pasos de alto nivel del flujo de Push provisioning:

1. Aprovisionamiento

   1. Inicio: Use las API TapAndPay para iniciar el proceso de push provisioning.
   2. Entrega del paquete: Google obtiene el paquete de aprovisionamiento que contiene los detalles de la tarjeta.
2. Resultado del aprovisionamiento: Google envía una notificación indicando el resultado del aprovisionamiento.

Este flujo de trabajo asume que el usuario ya tiene una tarjeta de transporte válida vinculada a su cuenta de tarjeta. Si el usuario no tiene una tarjeta de transporte, puede comprar una a través de la aplicación del operador de transporte o, si se admite, usar la aplicación para leer el contenido de su tarjeta física antes de aprovisionarla en Google Wallet.

Diagrama de secuencia

Es importante señalar que el Emisor de Transporte debe comenzar a preparar los datos necesarios para emitir la tarjeta digital tan pronto como la solicitud de pago sea validada con el PSP.

Aprovisionamiento

Cuando el usuario presiona el botón "Agregar a Google Wallet", la aplicación móvil del operador de transporte debe proporcionar los detalles de la tarjeta a su backend para comenzar la preparación del paquete de aprovisionamiento. D1 Transit genera una carga útil encryptedData que contiene los detalles necesarios para iniciar el flujo de aprovisionamiento. Esta carga encryptedData se envía de vuelta a la aplicación móvil del operador de transporte, la cual posteriormente llama a la API TapAndPay pushTokenizeRequest para iniciar el flujo de aprovisionamiento con Google.

Al recibir el encryptedData, Google inicia el proceso de tokenización EMV con D1 Transit con el fin de obtener finalmente el paquete de aprovisionamiento cifrado.

Escenarios de error

No hay solicitud de Google para obtener el paquete de aprovisionamiento

Se establece un periodo de tiempo de espera entre la respuesta de preparar el paquete de push provisioning y la solicitud de aprovisionamiento por parte de Google en el lado de D1 Transit.

Si la solicitud de aprovisionamiento no es recibida por D1 Transit dentro de este periodo de tiempo de espera, el aprovisionamiento se considera fallido.

Si Google solicita el aprovisionamiento después del tiempo de espera, D1 Transit notificará a Google que el paquete de aprovisionamiento ya no está disponible, lo que llevará a Google a detener el flujo de aprovisionamiento.

Resultado del aprovisionamiento

Una vez que Google recibe el paquete de aprovisionamiento, las claves y los datos se extraen y almacenan de forma segura. Tras completar la personalización, se envía un acknowledgePaymentBundle a D1 Transit para informar el resultado del flujo de aprovisionamiento.

Escenarios de error

La tarjeta no se aprovisiona en el dispositivo

Si el aprovisionamiento falla, Google no proporciona ninguna notificación a la plataforma D1 Transit. Como consecuencia, D1 Transit espera a que se alcance el tiempo de espera configurado (ver más abajo).

No hay solicitud acknowledgePaymentBundle por parte de Google

D1 Transit tiene un periodo de tiempo de espera después de enviar el paquete de aprovisionamiento a Google. Si no se recibe ningún acknowledgePaymentBundle dentro del plazo especificado, D1 Transit completa el flujo de trabajo considerando el aprovisionamiento como fallido; es decir, se notifica al emisor de transporte para que pueda:

• reembolsar al cliente y notificar a D1 Transit que la cuenta de la tarjeta ha sido eliminada.
• Permitir al cliente reiniciar el push provisioning

El emisor de transporte puede basarse en getCardAccountInfo API para comprobar cuáles son la información de cardAccount almacenada en la plataforma D1 Transit (estado de la cuenta de tarjeta, tarjetas digitales vinculadas a la cuenta de tarjeta) con el fin de tomar una decisión.