Registrar el autenticador

Resumen

Antes de completar un desafío 3DS durante una transacción de comercio electrónico, el usuario final debe registrar un autenticador de dispositivo en la aplicación del emisor.

El SDK D1 proporciona un autenticador basado en FIDO para EMV 3‑D Secure (3DS). El registro inscribe el autenticador del usuario final en el dispositivo para 3DS.

Flujo de inscripción

Flujo de inscripción de autenticador a alto nivel.

Diagrama de secuencia

El diagrama a continuación muestra la secuencia de mensajes de extremo a extremo para la inscripción del autenticador.

Prerrequisitos

• La aplicación del emisor integra el SDK D1 y el SDK está inicializado.
• La aplicación del emisor ha iniciado sesión en el SDK D1.
• El usuario final está registrado en la Plataforma D1.
• Las notificaciones push están configuradas en la aplicación del emisor.

Diagrama de secuencia para la inscripción del autenticador.

• Cada dispositivo admite un máximo de un usuario final inscrito.
• Un único usuario final puede estar inscrito en múltiples dispositivos.
• Ciertos dispositivos Android pueden generar una carga de atestación incorrecta, lo que puede resultar en un fallo de inscripción. Para mitigar este riesgo, es altamente recomendable inscribirse usando un BIOMÉTRICO autenticador en lugar de un PLATAFORMA autenticador.

Integración del SDK D1

Inscribir el autenticador

Android Java

// Proporcionar un AuthnCallback
D1Authn d1Authn = d1Task.getD1Authn(activity, authnCallback);

// Seleccionar el tipo de autenticador
AuthnType preferredAuthnType = AuthnType.BIOMETRIC;

d1Authn.enrollAuthnCredentials(preferredAuthnType, new D1Task.Callback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // El dispositivo está inscrito para 3DS. Continúe con el desafío OOB.
    }

    @Override
    public void onError(@NonNull D1Exception e) {
        // Maneje el error en su aplicación.
    }
});

Android Kotlin

fun enrollAuthnCredentials(d1Task: D1Task, activity: FragmentActivity, authnCallback: AuthnCallback) {
    // Implementar la interfaz conforme a AuthnCallback
    val d1Authn: D1Authn = d1Task.getD1Authn(activity, authnCallback)

    // Seleccione su tipo de autenticador preferido
    val preferredAuthnType: AuthnType = AuthnType.BIOMETRIC

    d1Authn.enrollAuthnCredentials(preferredAuthnType, object : D1Task.Callback<Void?> {
        override fun onSuccess(unused: Void?) {
            // Proceda con los flujos subsecuentes, el dispositivo ahora está inscrito para el servicio 3D Secure.
        }

        override fun onError(e: D1Exception) {
            // Consulte la sección D1 SDK Integration – Error Management.
        }
    })
}

iOS

// Conformar a AuthnDelegate
let d1Authn = d1Task.d1Authn(self)

// Seleccionar el tipo de autenticador
let preferredAuthnType = AuthnType.biometric

d1Authn.enrollAuthnCredentials(preferredAuthnType, completion: { error in
    if let error = error {
        // Maneje el error en su aplicación.
    } else {
        // El dispositivo está inscrito para 3DS. Continúe con el desafío OOB.
    }
})

A continuación, proceda a Gestionar el desafío OOB.

Dar de baja el autenticador

Llamar unenrollAuthnCredentials para eliminar la inscripción en este dispositivo. El backend de D1 y el almacenamiento local del dispositivo eliminan los datos de inscripción asociados. Otros dispositivos permanecen inscritos. Si el dispositivo ya está dado de baja, la llamada tiene éxito (idempotente).

Android Java

// Proporcionar un AuthnCallback
D1Authn d1Authn = d1Task.getD1Authn(activity, authnCallback);

d1Authn.unenrollAuthnCredentials(new D1Task.Callback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // El dispositivo ya no está inscrito para 3DS.
    }

    @Override
    public void onError(@NonNull D1Exception e) {
        // Maneje el error en su aplicación.
    }
});

Android Kotlin

fun unenrollAuthnCredentials(d1Task: D1Task, activity: FragmentActivity, authnCallback: AuthnCallback) {
    // Implementar la interfaz conforme a AuthnCallback
    val d1Authn: D1Authn = d1Task.getD1Authn(activity, authnCallback)

    d1Authn.unenrollAuthnCredentials(object : D1Task.Callback<Void?> {
        override fun onSuccess(unused: Void?) {
            // el dispositivo ahora está dado de baja para el servicio 3D Secure.
        }

        override fun onError(@NonNull e: D1Exception) {
            // Consulte la sección D1 SDK Integration – Error Management. Puede fallar debido a la conexión de red.
        }
    })
}

iOS

// Conformar a AuthnDelegate
let d1Authn = d1Task.d1Authn(self)

d1Authn.unenrollAuthnCredentials({ error in
    if let error = error {
        // Maneje el error en su aplicación.
    } else {
        // El dispositivo ya no está inscrito para 3DS.
    }
})

Personalizar el mensaje del aviso

Android Para BIOMÉTRICO, puede personalizar el mensaje mostrado en el cuadro de diálogo de aviso biométrico. Para PLATAFORMA, no se admite la personalización del mensaje del aviso.

iOS No se admite la personalización del mensaje del aviso de autenticación.

Android Java

public void customizingBiometricPromptMessage(@NonNull D1Task d1Task, @NonNull FragmentActivity activity) throws D1Exception {
    // Seleccione su tipo de autenticador preferido como AuthnType.BIOMETRIC
    AuthnType preferredAuthnType = AuthnType.BIOMETRIC;

    String customMessage = "Please authenticate with biometrics";

    d1Task.getD1Authn(activity, new AuthnCallback() {
        @Override
        public void onTransactionDataConfirmation(@NonNull Map<String, String> map, @NonNull AuthnUserConfirmationCallback authnUserConfirmationCallback) {
            // El 'map' contiene los datos de la transacción que deben ser autenticados.
            // Aplicación para mostrar el contenido, solicitar al usuario final que 'proceda' o 'rechace' la solicitud de autenticación.
        }

        @NonNull
        @Override
        public String onBiometricPromptMessage() {
            return customMessage;
        }
    });
}

Android Kotlin

@Throws(D1Exception::class)
fun customizingBiometricPromptMessage(d1Task: D1Task, activity: FragmentActivity) {
    // Seleccione su tipo de autenticador preferido como AuthnType.BIOMETRIC
    val preferredAuthnType = AuthnType.BIOMETRIC

    val customMessage = "Please authenticate with biometrics"

    d1Task.getD1Authn(activity, object : AuthnCallback {
        override fun onTransactionDataConfirmation(map: Map<String, String>, authnUserConfirmationCallback: AuthnUserConfirmationCallback) {
            // El 'map' contiene los datos de la transacción que deben ser autenticados.
            // Aplicación para mostrar el contenido, solicitar al usuario final que 'proceda' o 'rechace' la solicitud de autenticación.
        }

        override fun onBiometricPromptMessage(): String {
            return customMessage
        }
    })
}