## 4.6.1 (Jul 3rd 2026)

- Fixed the problem where `initialize` method was freezing UI on Android. It now runs on a background thread.

Working with Android SDK 5.49.0 and iOS SDK 5.44.0

## 4.6.0 (Jun 23rd 2026)

- Added `showCloseButton` method to show or hide the close button during onboarding. Deprecated `setCommonConfig` in favour of `showCloseButton`. `setCommonConfig` now internally calls `showCloseButton` and logs a deprecation warning; it will be removed in a future major release.
- Added `setSdkMode` method to switch between `standard`, `captureOnly`, and `submitOnly` modes at runtime without reinitializing the SDK.
- Added `setLocalizationLanguage` method to change the UI language at runtime (e.g. `en`, `es`, `pt`, `he`).
- Added `setString` method to override individual UI strings with custom copy, keyed by the current locale.
- Added `isInitialized` method that returns a boolean indicating whether the SDK has been fully initialized.
- Added optional `voiceConsentLanguage` parameter to `sessionConfig` to set the voice consent language in the VideoSelfie module. Supported values: 'en', 'es', 'pt', and 'he'. Default is English.
- Increased minimum Java version to 11.

Working with Android SDK 5.49.0 and iOS SDK 5.44.0

## 4.5.0 (Jun 2nd 2026)

- Added `eyesClosedCheckEnabled` parameter to `addSelfieScan` module.
- Fixed `eyesClosedCheckEnabled`, `headCoverCheckEnabled`, `lensesCheckEnabled`, and `maskCheckEnabled` on iOS not properly disabling checks when set to `"false"` (was passing `false` instead of `nil` to the native SDK).
- Changed default values for `maskCheckEnabled` in `addSelfieScan` module from `false` to `true`.
- Changed default values for `faceMaskCheck`, `headCoverCheck`, `lensesCheck`, and `eyesClosedCheck` in `addFaceAuthentication` module from `false` to `true`.
- Removed the hardcoded Android compileSdkVersion from the Cordova plugin so it inherits the SDK configuration from the host Cordova application.

Working with Android SDK 5.48.0 and iOS SDK 5.44.0

## 4.4.0 (May 12th 2026)

- Added optional `sslPinningConfig` to the `initialize` method.
- Added `isSkippable` flag to the `addGeolocation` module. It allows the geolocation step to be skipped. When set to `true`, skipping or denying location permission advances the flow instead of ending the session with a permission error.
- Added `allAttemptsExhausted` flag to `addId` and `addSelfieScan` results indicating when capture or upload retries are no longer available.
- Fixed bug preventing session recording on iOS unless `forcePermissions` was explicitly provided.

Working with Android SDK 5.47.0 and iOS SDK 5.43.0

## 4.3.0 (Apr 30th 2026)

- Added new internal Android dependency `com.incode.sdk.hybrid-bridge` that is required to have to a successful build. In case you're experiencing issues fetching it during gradle sync phase please contact your Incode representative, as your account access might have to be updated.

Working with Android SDK 5.46.0 and iOS SDK 5.42.0

## 4.2.0 (Apr 16th 2026)

- Added support for Android SDK initialization without api key with e2ee url.
- Added optional `showIdTypeChooser` parameter to the `addId` module.
- Added ability to pass `SessionConfig` to `startFaceLogin()` method. This allows enabling of end-to-end encryption (E2EE) in Face Login mode on Android. The `SessionConfig` will have no effect on iOS.
- Added `startOnboarding` method.
- Added `CURPValidation` module to the `startOnboardingSection` method.
- Updated `startOnboardingSection` method to support `recordSessionConfig` and `sectionTag` parameters, both of which are mandatory.
- Changed `setupOnboardingSession`, `startWorkflow`, and `startFlow` to accept a JSON session config object instead of a plain string `configurationId`.
- Removed `autocaptureUXMode` parameter from `addId` on iOS and Android.
- Removed `enableIdSummaryScreen` parameter from `addId` on Android.
- Removed optional parameters `disableHookCheck`, `disableEmulatorDetection`, `disableRootDetection` and `disableVirtualEnvironmentDetection` from `initializeSDK` method.

Working with Android SDK 5.45.1 and iOS SDK 5.41.0

## 4.1.0 (Mar 5th 2026)

- Fixed issue preventing custom V2 theme from applying when configured via JSON.
- Introduced `startFlow` method.
- Added `addEmail` module to the `startOnboardingSection` method.
- Added new optional parameter, `showLivenessResult`, to `addFaceMatch` module.

Working with Android SDK 5.44.0 and iOS SDK 5.40.0

## 4.0.0 (Jan 28th 2026)

- Introduced `setCommonConfig` method to enable setting of a shared runtime configuration outside of SDK initialization.
- Added `setShowCloseButton` parameter in `setCommonConfig` that shows a close button when set to `true`. Defaults to `false`.
- Fixed issue in `addId` module on iOS preventing `enableFrontShownAsBackCheck` and `enableBackShownAsFrontCheck` from being configurable.
- Fixed issue in `addVideoSelfie` module on iOS and Android preventing `enableFrontShownAsBackCheck` and `enableBackShownAsFrontCheck` from being configurable.
- Added support for End-to-End Encryption (E2EE).
- Aligned module results on Android and iOS.

Working with Android SDK 5.43.0 and iOS SDK 5.39.1

## 3.0.0 (Nov 19th 2025)

- Introduced `startWorkflow` method.
- Removed hardcoded Artifactory credentials from Cordova SDK `build.gradle` on Android.
- Deprecated `enableIdSummaryScreen` parameter from `addId` on iOS. Screen will not appear when using v2 UI. IdSummaryScreen will be removed in future update.
- Updated setTheme method to also configure theme on Android platform for V2 UX.
- Fixed error handling for IncodeException errors on Android.

Working with Android SDK 5.41.1 and iOS SDK 5.38.0

# 2.9.0 (Oct 3rd 2025)

- Added support for the Face Authentication module that performs a selfie scan to authenticate the user.
- Introduced `setFaceAuthenticationHint` method to provide a face authentication hint.
- Introduced `setUXConfig` method for UX customizations in V2 IdScan and SelfieScan modules.

Working with Android SDK 5.40.1 and iOS SDK 5.37.0

# 2.8.0 (Jul 7th 2025)

Working with Android SDK 5.38.0 and iOS SDK 5.35.0

# 2.7.0 (June 12th 2025)

- Cordova SDK Android `minSdkVersion` bumped from 21 to 23
- Added `disableVirtualEnvironmentDetection` optional parameter to the `initialize` method. Used to disable virtual environment detection on Android.
- Added `clientExperimentId` optional parameter to the `initialize` method. Used to enroll customer to experimental features like ID V2.

Working with Android SDK 5.37.0 and iOS SDK 5.34.1

# 2.6.0 (Jan 13th 2025)

- Added `enableIdSummaryScreen` parameter to the `addId` module. Specifying false means no summary screen will be shown to the user once he fail to capture ID multiple times. Defaults to true.

Using Android SDK version 5.31.1, iOS 5.30.1-d.

# 2.5.0 (Oct 28th 2024)

- Added `addNFC` module to the `startOnboardingSection` method, available exclusively in the NFC version of the plugin (`2.5.0-nfc`).
- Added new optional parameter, `matchType`, to `addFaceMatch` module. Possible values are: `idSelfie`, `nfcSelfie`, and `nfc3Way`.
- `initializeSDK` method now throws a typed string error with following possible values:

`simulatorDetected`, `testModeEnabled`, `invalidInitParams`, `configError`, and `unknown`
- Added new optional parameters to `initializeSDK` method: `disableHookCheck`, `disableEmulatorDetection`, `disableRootDetection`, and `disableJailbreakDetection`.
- `startOnboardingSection` method now returns a typed string error. Possible values are: `simulatorDetected`, `rootDetected`, `hookDetected`, `permissionsDenied`, `virtualEnvDetected`, and `unknown`.

Using Android SDK version 5.31.1, iOS 5.30.1-d.

# 2.4.0 (June 24th 2024)

- Added `addEKYC` and `addAntifraud` module to the `startOnboardingSection` method.
- VideoSelfie result on Android now returns `status` instead of `success` to be aligned with iOS platform.
- Aligned some `faceMatchData` response fields between Android and iOS.

Using Android SDK version 5.28.0, iOS 5.28.0-d.

# 2.3.0 (Oct 31st 2023)

- Added non-UI `faceMatch` method.
- Added `addVideoSelfie` module to the `startOnboardingSection` method.
- Fixed `addSelfie` params `maskCheckEnabled` and `lensesCheckEnabled`.
- Implemented automatically skipping back ID for one-sided documents if provided `configurationId` has that configured.

Using Android SDK version 5.19.0, iOS 5.20.0-d.

# 2.2.0 (Sept 26th 2023)

Using Android SDK version 5.17.2, iOS 5.17.0-d.

# 2.1.0 (July 11th 2023)

- Fixed `onEvent` function in iOS.

Using Android SDK version 5.16.0, iOS 5.17.0-d.

# 1.1.0 (June 2023)

- Advanced plugin with modules and respective parameters.
- Added token mechanism to initialize the SDK.
- Updated Android `minSdk` to 21 and `compileSdk` to 33.
- Added support for theme and translations on both platforms.
- Added User and Machine learning consent.
- Minor bug fixes.

Using Android SDK version 5.16.0, iOS 5.16.0-d.

# 1.0.2 (January 2023)

- Basic Incode Cordova plugin to conduct KYC process.
- Updated Android `minSdk` to 17 and `compileSdk` to 31.