microblink/blinkid-react-native v8002.0.0

on GitHub

Updated to BlinkID native SDKs v8002.0.0 (Android) and v8002.0.2 (iOS). See also the platform release notes and the native SDK release notes (Android, iOS).

What's new

• Session presets — Configure common workflows with BlinkIdSessionSettings.sessionPreset instead of hand-tuning every module flag:
  • documentVideo — live camera document scanning (optional documentVideoUseCase: scenario, quality, captureEnvironment).
  • documentPhoto — single photo or gallery image (optional documentPhotoUseCase: scenario, quality).
  • standaloneBarcode — barcode scanning without document detection.
  • verifyCapture — BlinkID Verify live capture (face, input and barcode images; no result aggregation).
  • Optional scanningSettings merges onto the preset (per module key); omit or pass {} to keep preset defaults. Manual module configuration without a preset remains supported.
• Scanning UX — BlinkIdScanningUxSettings.passportOnly for passport-booklet-only flows; helpTooltipShowDelay and helpTooltipHideDelay to control automatic help tooltip timing; allowScanSound to enable or disable scan completion sounds.
• Barcode & document expansion (native) — Faster, more resilient 1D/2D barcode engine; expanded barcode/QR parsing for Argentina DNI and Philippines IDs.
• Integration presets (native) — Quality profiles (balanced, highSpeed, highAccuracy, permissive) and scenarios (general, mrzMandatory, mrzOnly, barcodeOnly) align with native preset factories exposed in React Native via sessionPreset and use-case objects.

Bug fixes

• Passport card scanning flow: fixed occasional skip of the back side of passport cards.
• Single-image mode cropping: improved edge cases where crop detection failed or bounds were inaccurate.
• Centenarian date logic: fixed two-digit birth-year rollover in MRZ and date parsing for ages 100+.
• Fixed DocumentTypeID.ByIdCard wire value ("byIdCard") for class filters on Android; iOS bridge maps "byIdCard" ↔ native byidCard.

New documents support

• Bahrain - Vehicle Ownership Certificate
• British Virgin Islands - DL
• British Virgin Islands - Passport
• British Virgin Islands - Rigid Passport
• China - DL
• Colombia - Consular ID
• Congo - ID
• Dominican Republic - Consular ID
• Dominican Republic - Residence Permit
• Ethiopia - Rigid Passport
• Fiji - Passport
• Honduras - Consular ID
• Hong Kong - DL
• Iraq - DL
• Iraq - Vehicle Registration
• Jordan - Rigid Passport
• Kazakhstan - DL
• Liechtenstein - Passport
• Liechtenstein - Rigid Passport
• Moldova - Resident ID
• Namibia - DL
• Niger - DL
• Northern Mariana Islands - DL
• Somalia - ID
• Suriname - Rigid Passport
• Syria - DL
• Syria - Resident ID
• Tajikistan - DL
• UAE - Golden Card
• Yemen - ID

New document versions for supported documents

• China - DL
• Colombia - Passport
• Dominican Republic - DL
• Gambia - Passport
• Japan - Residence Permit
• Kyrgyzstan - DL
• Kyrgyzstan - ID
• Moldova - DL
• Moldova - Rigid Passport
• Paraguay - DL
• Tajikistan - Rigid Passport
• USA, Montana - DL
• USA, Montana - ID
• USA, Nebraska - DL
• USA, Nebraska - ID
• USA, Oklahoma - DL
• USA, Oklahoma - ID
• Virgin Islands of the United States - DL
• Virgin Islands of the United States - ID

New extracted fields from documents

• On many documents, documentAdditionalNumber and/or documentOptionalAdditionalNumber are now exposed as cardAccessNumber; some documents use passportNumber instead of documentAdditionalNumber (see platform release notes for the per-document list).
• Added parentInfo support on additional Brazil documents (alien ID, DL, passport).
• Kyrgyzstan identity card: Cyrillic firstName, lastName, nationality, and sex.

Requirements

• React Native 0.82.x or newer (built and tested; backward compatible with the old architecture)
• iOS 16.0 or newer; Xcode 16.3 or newer (Swift 6.1 toolchain)
• Android API level 24 or newer; compileSdk 37; targetSdk 37 recommended; Kotlin 2.2.21
• Integrator apps do not need Jetpack Compose setup; Compose is used internally by BlinkID UX

API changes

Country identifier (breaking)

• CountryID.VirginIslandsBritish → CountryID.BritishVirginIslands ("britishVirginIslands").

Session presets

• Added sessionPreset on BlinkIdSessionSettings with values "documentVideo" | "documentPhoto" | "standaloneBarcode" | "verifyCapture".
• Added documentVideoUseCase and documentPhotoUseCase (scenario, quality, and for video captureEnvironment).
• When sessionPreset is set, scanningMode still overrides the preset scanning mode if provided.
• scanningSettings merges module-level overrides onto the preset; omit scanningSettings or use {} for preset-only configuration.

const sessionSettings: BlinkIdSessionSettings = {
  sessionPreset: 'documentVideo',
  documentVideoUseCase: {
    scenario: 'general',
    quality: 'balanced',
    captureEnvironment: 'handHeld',
  },
  scanningSettings: {
    documentCaptureModule: { documentImageReturnEnabled: true },
  },
};

Scanning UX

• Added passportOnly on BlinkIdScanningUxSettings (default false).
• Added helpTooltipShowDelay and helpTooltipHideDelay (milliseconds; helpTooltipShowDelay ≤ 0 disables automatic display).
• Added allowScanSound on BlinkIdScanningUxSettings (default true).

Classification enums

• Added DocumentTypeID values: specifiedResidenceCard, goldenCard, vehicleOwnershipCertificate, byIdCard ("byIdCard").
• Added RegionID.NorthernIreland ("northernIreland").

Scanning results

• Added top-level (and per-side VIZ) string results: vehicleNumber, passportNumber, trafficParticipantNumber.
• Added FieldType.VehicleNumber, FieldType.PassportNumber, FieldType.TrafficParticipantNumber for redaction.

Not exposed in React Native

• Android-only customization of passport help/onboarding copy via blinkIdPassportHelpDialogsStrings on native BlinkIdSdkStrings is not bridged in React Native. On iOS, equivalent copy is customized via bundled localization (Localizable.xcstrings) in the host app. Use native APIs or app localization if you need custom passport help text.
• Other native-only preset or SDK APIs not mapped to JSON settings continue to require native integration.