Digitalización del flujo amarillo
Descripción general
El flujo amarillo es un flujo de tokenización en el que el backend del emisor aprueba la tokenización con autenticación reforzada (ID&V).
Este flujo es común cuando el SDK de NFC Wallet se integra en una aplicación de billetera digital que tokeniza tarjetas de múltiples emisores.
En este caso, la solución debe autenticarse usando ID&V para completar la tokenización.
Experiencia de usuario
Diagrama de secuencia
digitizationApprovedWithIDV.Integrar el SDK
Después de que tú Verificar la elegibilidad de la tarjeta:
Llama a
CardDigitizationService.digitizeCard().Si la tokenización se aprueba con condiciones (flujo amarillo):
El SDK de NFC Wallet emite
digitizationApprovedWithIDV.
Obtenga los métodos ID&V admitidos por el emisor usando
IDVMethodSelector.getIDVMethodList().Muestre los métodos y permita que el usuario final elija uno.
Notifique al SDK de NFC Wallet llamando a
IDVMethodSelector.select(idvID:).
Métodos ID&V admitidos
El SDK de NFC Wallet admite los siguientes métodos ID&V:
otpBySMS: Verifique al usuario final con una contraseña de un solo uso (OTP) enviada por SMS.otpByEmail: Verifique al usuario final con una contraseña de un solo uso (OTP) enviada por correo electrónico.customerService: Verifique al usuario final a través del servicio de atención al cliente del emisor.webService: Verifique al usuario final en el sitio web del emisor.appToApp: Verifique al usuario final en la aplicación del emisor.con criptograma: La aplicación del emisor genera un criptograma del emisor.sin criptograma: El emisor activa el token usando la API del emisor de TSP.
Liste y seleccione un método ID&V
Use el siguiente ejemplo para listar los métodos ID&V admitidos por el emisor.
Usar IDVMethod.id al llamar a IDVMethodSelector.select(idvID:).
ID&V con OTP
Si el usuario final selecciona otpBySMS o otpByEmail, el TSP genera una OTP. Luego el TSP solicita al emisor que envíe la OTP por SMS o correo electrónico.
El SDK de NFC Wallet emite activationRequired con PendingCardActivation.State establecido en otpNeeded.
Después de que el usuario final introduzca la OTP, llame a PendingCardActivation.activate() con el valor de la OTP.
El SDK de NFC Wallet aprovisiona el perfil de la tarjeta digital en segundo plano. Cuando finaliza el aprovisionamiento, el SDK de NFC Wallet emite activatedByIDV.
ID&V de servicio al cliente o de servicio web
Si la aplicación de billetera digital selecciona webService o customerService, el emisor gestiona ID&V directamente. Esto se hace a través de un portal web del emisor o del servicio de atención al cliente del emisor.
Usar IDVMethod.value para obtener la URL del portal web del emisor o el número de teléfono del servicio de atención al cliente del emisor.
Después de que el emisor autentique correctamente al usuario final, el emisor activa el token usando la API del emisor de TSP.
Luego, el backend de NFC Wallet envía una CPS notificación push a la aplicación de billetera digital.
Procese el push como se describe en Procesar notificaciones CPS.
ID&V de app a app
En este método ID&V, la aplicación de billetera digital redirige al usuario final a la aplicación del emisor.
El SDK de NFC Wallet emite activationRequired con PendingCardActivation.State establecido en appToAppSelected.
Usar appToAppSelected.requestPayload, appToAppSelected.scheme, y appToAppSelected.source para redirigir al usuario final a la aplicación del emisor.
Después de que la aplicación del emisor complete la autenticación, redirige al usuario final de vuelta a la aplicación de billetera digital.
Hay dos métodos posibles:
AppToApp con criptograma: La aplicación del emisor genera un criptograma del emisor.AppToApp sin criptograma: El emisor activa el token usando la API del emisor de TSP.
Para AppToApp con criptograma, llame a PendingCardActivation.resumeAppToAppActivation(withTAV:) y proporcione el criptograma del emisor. El SDK de NFC Wallet aprovisiona el perfil de la tarjeta digital en segundo plano. Cuando finaliza el aprovisionamiento, el SDK de NFC Wallet emite activatedByIDV.
Para AppToApp sin criptograma, llame a PendingCardActivation.resumeAppToAppActivation(). Luego, el backend de NFC Wallet envía una CPS notificación push a la aplicación de billetera digital. Procese el push como se describe en Procesar notificaciones CPS.
Reanudar activación
Si el proceso ID&V se interrumpe, reanúdelo usando el PendingCardActivationSession API.
Esto permite que el usuario final vuelva a seleccionar un método ID&V: otpBySMS, otpByEmail, customerService, webService, o appToApp con criptograma.
Última actualización
¿Te fue útil?