Mobbeel for developers

Mobbeel for developers

  • MobbScan
  • MobbID
  • MobbSign
  • Clients
  • FAQ

›Getting Started

MobbScan iOS

  • Welcome to the MobbScan SDK
  • SDK size

Configure SDK

  • Configure the iOS SDK

Migration Guides

  • Migration to 2.26.0
  • Migration to 2.19.0
  • Migration to 2.18.0
  • Migration to 2.17.0
  • Migration to 2.16.0

Getting Started

  • Initalize API
  • Scanning a document with MobbScan
  • Performing Face Matching
  • Adding a video step
  • Record a video while user scans the document
  • Getting the verification result
  • Scanning documents with NFC
  • Detect and scan MRZ
  • Detect and scan a PDF417
  • Add fields to validations in agent portal
  • Error Handling

Additional Configuration

  • MobbScan Configuration

Customization

  • Customize Detection Views
  • Customize Feedback Messages
  • Customize Unattended Process

Reference

  • Changelog

Detect and scan MRZ

You can use this feature to detect and scan a Machine Readable Zone (MRZ). All official ID cards and Passports complying with ICAO 9303 standard contain this section from which it is possible to retrieve most of personal data without the need to indicate the particular ID type or issuing state beforehand. By using this method, we will be able to scan and get information from worldwide documents.

Extra Configuration

In order to use this feature you must add to your project the MobbScanOffline.xcframework file, the same way you added the other frameworks.

MRZ detection and scan

Note: To start the MRZ detection and scan, you should have previously started the process to get the scanId. Keep in mind that the document type you have to now use is IDDocumentMRZ.

Swift
ObjectiveC
let operation = ScanOperationMRZ()
operation.scanMRZMode = MobbScanMRZMode.DEFAULT
MobbScanAPI.getInstance().scanMRZDocument(operation, detectionResult: { result, resultData, error in
// Here you will receive document image
}, scanResult: {result,resultData,error in
// Here you will receive document extracted data
})
ScanOperationMRZ *operation = [[ScanOperationMRZ alloc] init];
operation.scanMRZMode = MobbScanMRZMode_DEFAULT;

[[MobbScanAPI getInstance] scanMRZDocument:operation
detectionResult:^(MobbScanDetectionResult result, MobbScanDetectionResultData *resultData, NSError *error) {
// Here you will receive document image
} scanResult:^(MobbScanScanResult result, MobbScanScanResultData *resultData, NSError *error) {
// Here you will receive document extracted data
}];

You can select any of these modes to detect the MRZ and the document:

Scan MRZ ModeDescription
MobbScanMRZMode_DEFAULTDoesn't crop the document
MobbScanMRZMode_WITH_CROPPED_DOCUMENTTries to crop the document from the frame where the MRZ was detected. If not available, returns the full frame
MobbScanMRZMode_FORCE_CROPPED_DOCUMENTForces the document detection. Always returns the cropped document.

MRZ validations

It is possible to generate a list (validationList) with all required fields that the scanning process must get and validate before notifying the process back as a successful result. By default, the name and the surname will always be checked and validated as non null values.

You can set the list with the ScanOperationMRZ object:

Swift
ObjectiveC
var validationList = NSMutableArray()

validationList.add("validationPersonalNumberFormat")
validationList.add("validationDateOfBirth")
validationList.add("validationSurnameNotEmpty")
. . .

var operation = ScanOperationMRZ()
operation.scanMRZMode = MobbScanMRZMode.DEFAULT
operation.listValidation = validationList
NSMutableArray* validationList = [[NSMutableArray alloc] init];

[validationList addObject:@"validationPersonalNumberFormat"];
[validationList addObject:@"validationDateOfBirth"];
[validationList addObject:@"validationNameNotEmpty"];
[validationList addObject:@"validationSurnameNotEmpty"];
. . .

ScanOperationMRZ *operation = [[ScanOperationMRZ alloc] init];
operation.scanMRZMode = MobbScanMRZMode_DEFAULT;
operation.listValidation = validationList;

Scan only mandatory data

The MRZ is structured in mandatory and optional areas. The optional ones can be used by each issuing state to include customized information (personal number, SSN code...) and non-standard checkdigit calculation methods are also allowed. If you want to obviate optional areas while performing a scan, add to listValidations this validation:

MobbScanValidationType_MRZ_MANDATORY_DATA_VALIDATION
← Scanning documents with NFCDetect and scan a PDF417 →
  • Extra Configuration
  • MRZ detection and scan
  • MRZ validations
    • Scan only mandatory data
Mobbeel for developers
Product Documentation
MobbIDMobbScanMobbSign
Connect
LinkedInFacebookX
More
FAQContact Us
Mobbeel Solutions SL
Copyright © 2025 Mobbeel Solutions SL