switchToLockConfigurationWithPin

public final Unit switchToLockConfigurationWithPin(Application application, SDKConfiguration sdkConfiguration, CharArray sdkPin, Callback<Unit> callback)

Protected operation to change SDK configuration without resetting. Requires at least one enrolled account.

FTInvalidStateException may be returned in callback for these reasons:

  1. The function is called before launching the SDK.

  2. There are no enrolled accounts.

  3. Wrong switchToLockConfiguration* method is used for the provided SDKConfiguration.

Parameters

application

to re-launch the SDK with the new configuration

sdkConfiguration

the new SDKConfiguration to apply. Must use LockConfigurationType.SDK_PIN_WITH_BIOMETRICS_OPTIONAL

sdkPin

the SDK PIN to be set for the new configuration

callback

to receive success or failure result of this operation.

Throws

if the SDK is locked.

if the provided SDKConfiguration is invalid. Please refer to the website guide to confirm your configuration is valid.

if sdkConfiguration uses setInvalidatedByBiometricChange(true) and no supported biometrics are available on the device, or LockConfigurationType.NONE is used.

if setInvalidatedByBiometricChange(false) with LockConfigurationType.BIOMETRICS_OR_DEVICE_CREDENTIALS and the device has no biometrics or lock credentials are available.

if there are no enrolled accounts.

if the SDK is not initialized.

if the SDK detects corrupted storage. This state requires the SDK to reset or to perform launchAccountRecovery

if the SDK cannot access necessary cryptographic material or perform cryptographic operations

if the API request fails. Refer to FTApiException subtypes for more specific errors.