ID Check Passport MRZ service

ID Check Passport MRZ service

IDCheckPassportMRZService is a passport verification service. It checks that the validity of the machine readable zone (MRZ), and checks the MRZ against any additional supplied optional parameters.

Properties

The following properties pertain to this service.

Property Name Type Length Optional/Mandatory Notes
MRZ
String
  Mandatory  
PassportNumber
String
  Optional  
Country
IsoCountriesEnum
  Optional

Validates against the MRZ's nationality if supplied (does not validate against the Country of Issue).

Cannot be "None"

ForeName  
String
  Optional  
Surname  
String
  Optional  
MiddleNames  
String
  Optional  
DayOfBirth  
Int
   Optional  
MonthOfBirth  
Int
   Optional  
YearOfBirth  
Int
   Optional  "yyyy"
Gender
String
  Optional Must be "M" or "F" if supplied

After performing the search, the validation result (pass, fail, etc.) will be part of the TransactionInformation returned for the service call.

Request

The following is an example SOAP request.

<QueryData>                   
<PassportNumber>MRZ... Data truncated</PassportNumber> </QueryData>

Response

<IDCheckPassportMRZResult>
<ValidationErrors> <string>{ e.g. MRZ is not 88 characters}</string> </ValidationErrors> </IDCheckPassportMRZResult>

Sandbox

This service uses Sandbox V2.

If the Sandbox query option is set to "true" the following entry will be returned in the ServiceResult:


If the PassportNumber is entered as "P<CZESPECIMIN<<VZOR<<<<<<<<<<<<<<<<<<<<<<<<<99003853<1CZE1101018M120704611010111<<<<<<94"

then IDCheckPassportMRZResult will contain an empty, non-null ValidationErrors.
The corresponding ServiceTransactions will show the following properties:

<HaltTriggered> False
<ServiceTransactionResult> Success
<ServiceInterpretResult> Pass
<ServiceTransactionResultMessage> "This call was generated using sandbox mode"
<ValidationResult> NotApplicable

 

If the PassportNumber is entered as any other 88 character string

then IDCheckPassportMRZResult's ValidationErrors will contain the error "Final checksum is invalid".
The corresponding ServiceTransactions will show the following properties:

<HaltTriggered> False
<ServiceTransactionResult> Success
<ServiceInterpretResult> Inconclusive
<ServiceTransactionResultMessage> "This call was generated using sandbox mode"
<ValidationResult> NotApplicable

 

If the PassportNumber is entered as any other string, or null,

then IDCheckPassportMRZResult's ValidationErrors will contain the error "MRZ is not 18 characters".
The corresponding ServiceTransactions will show the following properties:

<HaltTriggered> False
<ServiceTransactionResult> Success
<ServiceInterpretResult> Inconclusive
<ServiceTransactionResultMessage> "This call was generated using sandbox mode"
<ValidationResult> NotApplicable