Verification Object

Available only for mobile SDK version 3.x and above and web SDK 3.4.2 and above.

Note: This feature is unavailable for certain ID documents within the web SDK, consequently, the verification object will not appear in the SDK result. Feel free to reach out if the document you need is not supported.

{
.....
  "verifications": [{
	"documentType": "document type, e.g. UAE_ID",
	"sourceDetection": {
  		"enabled": true,
                "allowNonPhysicalDocuments": true or false,
  		"selectedResolution": "e.g. 2160x3840",
  		"optimalResolution": true or false
	},
	"idScreenDetection": {
  		"enabled": true or false,
  		"score": 0-100
	},
	"idPrintDetection": {
  		"enabled": true or false,
  		"score": 0-100
	},
	"idPhotoTamperingDetection": {
  		"enabled": true or false,
  		"score": 0-100
	},
	"dataConsistencyCheck": {
  		"enabled": true or false,
  	  	"fields": [{
      			"name": "common field name",
"match": "MATCH or MATCH_PARTIALLY or NO_MATCH",
      			"sources": [{
          			"source": "SCAN or READING or LOOKUP",
          			"documentSide": "FRONT or BACK or none",
          			"name": "original field name that is used in the source",
          			"value": "original value of the field"
        		}]
    		}]
	},
	"mrzChecksum": {
  		"enabled": true or false,
  		"finalCheckDigit": number,
  		"valid": true or false,
  		"checkDigits": [{
   			"fieldName": "name",
   		 	"fieldValue": "value",
   			"checkDigit": number,
   		 	"valid": true or false
   	 	}]
	},
	"reading": {
  		"enabled": true or false,
                "passiveAuthentication": {
                     "enabled": true,
                     "countrySigningCertificateAvailable": true or false,
                     "documentSigningCertificateAvailable": true or false,
                     "documentSigningCertificateSignatureValid": true or false,
                     "documentDataSignatureValid": true or false,
                },
                "chipAuthentication": {
                     "enabled": true
                },
                "activeAuthentication": {
                     "enabled": true
                }
	},
	"biometric": {
  		"enabled": true or false,
  		"type": "FACIAL_RECOGNITION"
  		"matchLevel": 0-5	
        },
	"lookup": {
  		"enabled": true or false,
  		"documentFound": true or false
	}
   }]
......
}

Source detection:

  • enabled: Always true

  • allowNonPhysicalDocuments: By default is set to false, can be overridden in the mobile SDK configuration. Always true for the web SDK

  • selectedResolution: Resolution used to perform source detection

  • optimalResolution: Indicates if the process was performed with optimal resolution. Regarding the mobile SDK, in the majority of the cases it should be true but in rare cases might be false, for instance for phones that donโ€™t support an optimal resolution. Suboptimal resolution can affect the accuracy of the source detection process and therefore should trigger a warning and therefore manually evaluated

Id screen detection:

  • enabled: Always true

  • score: An assigned score ranging from 0 to 100 indicates the likelihood of a document scanned through a screen. A higher score suggests a higher probability to be a screen. It's important to be aware that the mobile SDK will reject scanning attempts if the score exceeds 50 unless allowNonPhysicalDocuments is set to true

Id print detection:

  • enabled: Always true

  • score: An assigned score ranging from 0 to 100 indicates the likelihood of a document scanned through a printed copy. A higher score suggests a higher probability to be a printed copy

Id photo tampering detection:

  • enabled: Always true

  • score: An assigned score ranging from 0 to 100 indicates the likelihood of tampering with the ID photo. A higher score suggests a higher probability of tampering. It's important to be aware that the mobile SDK will reject scanning attempts if the score exceeds 70. Scores surpassing 40 should trigger a warning and therefore manually evaluated

Data consistency check:

  • enabled: Always true

  • fields: List of fields found across all the steps of the KYC journey that are duplicates and therefore can be matched. Please be aware that the list may be empty if there are no fields available for matching.

  • Field object:

    • name: Common field name across all the sources

    • match: MATCH or MATCH_PARTIALLY or NO_MATCH

    • sources: List of sources that have been matched

    • Source object:

      • source: The source of the field. Possible values are SCAN, READING or LOOKUP

      • documentSide: The side of the document (FRONT or BACK) if source is SCAN

      • name: Original field name

      • value: Value of the field

MRZ checksum:

  • enabled: Enabled if the document contains a MRZ

  • finalCheckDigit: The check digit number used to validate the checksum of multiple values across the MRZ

  • valid: If the final checksum is valid or not

  • checkDigits: List of check digit validations per MRZ field

  • Check digit object:

    • fieldName: Field name

    • fieldValue: Field value

    • checkDigit: Check digit number

    • valid: If the checksum is valid or not

Reading:

  • enabled: If the reading step (NFC chip reading) was enabled or not. Only available in the mobile SDK

  • passiveAuthentication: Available only if passive authentication is supported by the document

    • enabled: true If passive authentication is supported by the document (e.g. passport), otherwise passiveAuthentication object is not returned as described above

    • countrySigningCertificateAvailable: true if the country signing certificate is available

    • documentSigningCertificateAvailable: true if the document signing certificate is available

    • documentSigningCertificateSignatureValid: implies that countrySigningCertificateAvailable is true. If countrySigningCertificateAvailable is false the attribute is not exported

    • documentDataSignatureValid: if digital signature validation of the data was successful or not. For passports could be false as we don't reject the reading because some passports could have a defect

  • activeAuthentication: Available only if active authentication was performed

    • enabled: true If active authentication is supported by the document, otherwise activeAuthentication object is not returned as described above

  • chipAuthentication: Available only if chip authentication was performed

    • enabled: true If chip authentication is supported by the document, otherwise chipAuthentication object is not returned as described above

Biometric:

  • enabled: If biometric was enabled or not

  • type: Can only be FACIAL_RECOGNITION

  • matchLevel: match level returned

Lookup:

  • enabled: If lookup was enabled or not

  • documentFound: If a matching document was found or not

Last updated