Crear vinculación del dispositivo (flujo verde)

Use el emparejamiento de dispositivo del Marco de Token en la Nube de Visa (CTF) flujo verde cuando el emisor aprueba el emparejamiento del dispositivo sin autenticación de elevación de privilegios.

En Producción, el emparejamiento del dispositivo a menudo requiere autenticación de elevación de privilegios. Esa ruta es el flujo amarillo.

Prerrequisitos:

• La tarjeta de pago ya está tokenizada.
• Usted tiene un vProvisionedTokenId.
• El usuario final puede autenticarse en el dispositivo (PIN, código de acceso, huella dactilar, Face ID, etc.).

Flujo

Flujo verde de emparejamiento de dispositivo.

Paso	Descripción
1	Inicie el flujo de emparejamiento de dispositivo desde la aplicación del comerciante usando el SDK de Thales.
2	El SDK de Thales genera un ID de dispositivo y un par de claves CTF, luego almacena el par de claves CTF de forma segura en el dispositivo.
3	El SDK de Thales inicia la autenticación del usuario final en el dispositivo.
4	El SDK de Thales genera y firma la carga útil definida por Visa.
5	El SDK de Thales envía la carga útil firmada y la clave pública CTF al backend de Thales.
6	El backend de Thales convierte la clave pública en un certificado usando una CA de Visa.
7	El backend de Thales registra el dispositivo y solicita el emparejamiento del dispositivo a VTS.
8	VTS verifica la decisión del emisor.
9	El emisor aprueba el emparejamiento del dispositivo sin autenticación de elevación de privilegios.
10	VTS reenvía el resultado al backend de Thales.
11	Se informa al SDK de Thales y vincula localmente el identificador del token al dispositivo.
12	El backend de Thales notifica al backend del comerciante/PSP con los detalles del emparejamiento.

Integración del SDK

Crear un emparejamiento

Android

String vProvisionedTokenId;
String correlationId;

visaCTFHelper.createBinding(vProvisionTokenId, 
                            correlationId, 
                            new TokenBindingListener() {

        ......
        
        @Override
        public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
            // Realizar autenticación del usuario
         }

        @Override
        public void onSuccess() { }

        @Override
        public void onError(TMGClientException exception) { 
            // Comprobar error
            int errorCode = exception.getErrorCode();
            int errorMessage = exception.getMessage();
        }
    });

iOS

createBinding es asincrónico. Se recomienda llamar a runOnUiThread(Runnable) en la devolución de llamada de la función en casos donde la aplicación tenga que actualizar cualquier UI.

Autenticar al usuario final

Crear un emparejamiento de dispositivo requiere la presencia del usuario final. Implemente el deviceAuhenticationHandler callback desde createBinding.

Use este callback para presentar cualquier interfaz personalizada (por ejemplo, solicitudes de permiso de Face ID). Inicie la autenticación llamando a startAuthentication. También puede pasar un mensaje personalizado para mostrar durante la autenticación.

Android

@Override
public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
    FragmentActivity fragmentActivity;
    CharSequence title;
    CharSequence subTitle;
    CharSequence description;
    CharSequence negativeButtonText;

    // Iniciar la autenticación del usuario
    deviceAuthentication.startAuthentication(fragmentActivity, 
                                             title, 
                                             subTitle, 
                                             description, 
                                             negativeButtonText);
}

iOS

Manejar resultados

Los resultados se devuelven a través de la onSuccess o onError callback.

En caso de error, registre e inspeccione el código de error y el mensaje de la excepción.

Android

@Override
public void onError(TMGClientException exception) {
    // Comprobar el error
    int errorCode = exception.getErrorCode();
    int errorMessage = exception.getMessage();
}

iOS