Table of contents

Release Notes for Android SDK - 3.x

3.4.1200 (04/02/2026)

New

  • Image results: MRZScanResult now returns captured images alongside the parsed MRZ data. Three types of images can be retrieved from the result:
    • Document image: A cropped and perspective-corrected image of the document, available via getDocumentImage(EnumDocumentSide). Returned by default.
    • Original image: The raw full-frame camera image captured at the moment of scanning, available via getOriginalImage(EnumDocumentSide). Disabled by default.
    • Portrait image: The detected portrait extracted from the document, available via getPortraitImage(). Returned by default.
    • For two-sided ID cards, images for both sides are accessible by passing EnumDocumentSide.DS_MRZ or EnumDocumentSide.DS_OPPOSITE to getDocumentImage() and getOriginalImage().
  • New EnumDocumentSide enumeration: Added EnumDocumentSide with values DS_MRZ (the side containing the MRZ) and DS_OPPOSITE (the reverse side) to identify which side of a document an image belongs to.

  • Image return configuration: Added three new MRZScannerConfig methods to control which images are included in the scan result:
    • setReturnDocumentImage(boolean) (default: true)
    • setReturnOriginalImage(boolean) (default: false)
    • setReturnPortraitImage(boolean) (default: true)
  • Additional MRZ data fields: MRZData now exposes the following additional parsed fields:
    • getIssuingStateRaw() — the raw issuing state value as encoded in the MRZ, before standardization.
    • getNationalityRaw() — the raw nationality value as encoded in the MRZ, before standardization.
    • getOptionalData1() — the first optional data field (nullable).
    • getOptionalData2() — the second optional data field (nullable).
    • getPersonalNumber() — the personal number field, typically present on TD3 passport documents (nullable).
  • New UI button visibility controls: Added three new MRZScannerConfig methods to control the visibility of toggle buttons in the scanning UI:
    • setBeepButtonVisible(boolean) — shows or hides the beep sound toggle button (default: true).
    • setVibrateButtonVisible(boolean) — shows or hides the vibration toggle button (default: true).
    • setFormatSelectorVisible(boolean) — shows or hides the document format selector at the bottom of the scanning UI (default: true).

3.2.5000 (12/18/2025)

Fixes & Improvements

  • Resolved a libPNG CVE issue by updating the C++ dependencies to use the latest libPNG CVE.

3.2.3000 (11/05/2025)

Fixed

  • Resolved an issue where scanning could take longer than expected.
  • Fixed a potential crash that could occur in certain scenarios.

3.2.1000 (10/16/2025)

  • 🚀 High-Speed and Precise MRZ Region Detection: Revolutionary neural network MRZLocalization model delivers 42.7% faster processing with enhanced region detection accuracy for passport and ID workflows

3.0.5000 (07/29/2025)

New

  • Supported 16 KB page sizes.

Fixed

  • Fixed various minor bugs and improved overall stability.

3.0.3100 (05/30/2025)

  • Fixed a bug where the camera might not be opened.

3.0.0 (05/15/2025)

Improved

  • Improved the read-rate and the accuracy of MRZ text recognition.

This page is compatible for: