Establecer método CDCVM

Resumen

El perfil de tarjeta digital define si admite CDCVM.

Para una instancia de cartera dada, la primera tarjeta aprovisionada que admite CDCVM define el método CDCVM utilizado por la aplicación de cartera digital.

NFC Wallet SDK no permite que coexistán tarjetas con diferentes métodos CDCVM en la misma instancia de cartera.

Como se describe en Manejar CDCVM, la mayoría de los programas de NFC Wallet usan CDCVM.

En esta sección, estableces el método CDCVM en función de las capacidades del dispositivo durante Tokenización de la primera tarjeta que admite CDCVM.

Configurar el método CDCVM es obligatorio

Si el perfil admite CDCVM y no configuras el método CDCVM:

• La recuperación de la lista de tarjetas falla con DigitalizedCardErrorCodes.CD_CVM_REQUIRED.
• Los pagos NFC fallan hasta que configures el método CDCVM.

Integración del SDK

Comprueba si CDCVM es compatible y establece

Use CHVerificationManager para comprobar si CDCVM es compatible y ya está configurado para la instancia de cartera actual:

• CHVerificationManager.isFCDCVMSupported() comprueba si CDCVM es compatible.
• CHVerificationManager.isFCdCvmSet() comprueba si el método CDCVM ya está configurado.
• CHVerificationManager.getDefaultFCdCvm() devuelve el método CDCVM utilizado por la aplicación de cartera digital.

Si CDCVM es compatible y no está configurado, inicialízalo como se describe en Configura el método CDCVM.

Gestiona CD_CVM_REQUIRED al listar las tarjetas

Si no configuras el método CDCVM y recuperas la lista de tarjetas usando DigitalizedCardManager.getAllCards(), el SDK puede devolver DigitalizedCardErrorCodes.CD_CVM_REQUIRED. En ese caso, inicializa el método CDCVM como se describe en Configura el método CDCVM.

DigitalizedCardManager.getAllCards( new AbstractAsyncHandler<String[]> () {
    
    @Override
    public void onComplete(final AsyncResult<String[]> asyncResult) {
        if (asyncResult.isSuccessful()) {
            // Lista de tarjetas recuperada correctamente
        }
        else {
            // Falló la recuperación de la lista de tarjetas
            final int errorCode = asyncResult.getErrorCode();
            if (errorCode == DigitalizedCardErrorCodes.CD_CVM_REQUIRED) {
                // Configura aquí el método CDCVM (consulta la siguiente sección)
                // ....
            }
        }
    }
    
});

Configura el método CDCVM

Use DeviceCVMManager.initialize(...) para configurar el método CDCVM según las capacidades del dispositivo:

• Biometría: CHVerificationMethod.BIOMETRICS
• Credenciales del dispositivo (keyguard): CHVerificationMethod.DEVICE_KEYGUARD

Después de configurar el método CDCVM, considera escenarios en los que el usuario final cambia el método de desbloqueo del dispositivo. Consulta Escenario de actualización del método de desbloqueo del dispositivo.

Ejemplo de implementación

// Comprueba la elegibilidad del dispositivo para CDCVM
DeviceCVMEligibilityResult result =
        DeviceCVMEligibilityChecker.checkDeviceEligibility(getApplicationContext());

if (result.getBiometricsSupport() == BiometricsSupport.SUPPORTED) {
    // La biometría es compatible
    try {
        DeviceCVMManager.INSTANCE.initialize(CHVerificationMethod.BIOMETRICS);
    } catch (DeviceCVMException e) {
        // Manejar error
    }
}
else if (result.getDeviceKeyguardSupport() == DeviceKeyguardSupport.SUPPORTED) {
    // Si la biometría no es compatible, usa el keyguard del dispositivo.
    try {
        DeviceCVMManager.INSTANCE.initialize(CHVerificationMethod.DEVICE_KEYGUARD);
    } catch (DeviceCVMException e) {
        // Manejar error
    }
}
else {
    // El dispositivo no admite CDCVM, o el usuario final no habilitó una pantalla de bloqueo segura.
    // Pide al usuario final que habilite la biometría o las credenciales del dispositivo.
}