Configuring GetID

GetID is a data provider you can use to run the ID verification (PassFort collects documents) check.

How it works

This is the default behaviour for a variant of the ID verification (PassFort collects documents) check with GetID as the data provider.

You can upload one of the following documents for an individual to GetID:

  • Driving Licence
  • Passport
  • State ID
  • Residence ID
  • Voter ID
  • Tax ID
  • Unknown (You can select Unknown if the document type is not known, GetID will perform a check to determine the type of documentation provided.)
File size: The file size must be between 32KB and 6MB per photo. The face size on the photo must be a minimum of 150x150px.

GetID checks for signs of forgery and extracts the following information from the documents:

  • Address
  • Name
  • Date of birth
  • Nationality

PassFort cross-references the extracted data provided by GetID with the details recorded in the individual’s profile (name, date of birth, nationality, and document type). 

PassFort imports an image of the documents to the task on the profile.

The check passes when:

  • All checks from GetID are marked Approved.
  • The data extracted from the document submitted for validation matches the data stored on the profile in PassFort.

The check will fail when:

  • Any of the results from GetID are marked as Declined or Needs review.
  • The data comparison and validation performed by PassFort fails.
About MRZ validation
PassFort performs MRZ validation as part of the check. On the identity page of your passport, the MRZ is the machine readable zone that cameras and software can quickly read. It contains two rows of 44 characters each. The characters used are A-Z and 0-9, demarcated with < separators. We extract the following fields from the MRZ:
  • issuing_country

  • issuer

  • nationality

  • given_names

  • family_name

  • When the MRZ has names with single separators only, the name components on the MRZ will be compared to the full name (given names and surname combined) on the PassFort profile.
  • dob

  • gender

  • number

  • expiry

  • Additionally, we mark the MRZ itself as invalid if any of the checksums fail or none of the above fields are found. This validation is enabled by default for the specific providers that return the MRZ details.

If the individual’s details do not match the data in GetID’s sources, the check fails.

To get step-by-step instructions for running this check, see Verify a document.

Configuration options

The following configuration options are available:

This integration has no special configuration parameters beyond credentials at the moment.

What we'll need

Let us know that you’d like to add a variant of the ID verification (PassFort collects documents) check with GetID. We’ll set it up for you.

If you have a direct agreement, we’ll also need to know your GetID API key, URL, and Webhook signature key. This information is provided by GetID.

Testing your configuration

Once the check variant is configured, create different profiles in your demo environment to test whether it's working as expected.

To get a PASSED result, check that the ID is authentic and the document details in the demo environment match profile details.

Create an individual profile with these details:

  • First name: Alex  
  • Surname: Wheeler.
  • Date of birth: 01 January 2000

Expected result: DOCUMENT_ALL_PASS

To get a FAILED result, use the example where the DOB entered is different from the details in the demo environment.

Create an individual profile with these details:

  • First name: Ashley 
  • Surname: Williams
  • Date of birth: 30 June 1980

Expected result: DOCUMENT_DOB_FIELD_DIFFERENT

Required profile fields

These are the required profile details matched with the document details extracted by GetID:

Name

GetID field

Description

First name(s)(personal_details.name.given_names)

(documents[0].extracted_data.personal_details.name.given_names)

The individual's first and, if applicable, middle names.

Surname (personal_details.name.family_name)

(documents[0].extracted_data.personal_details.name.family_name)

The individual's last name.

Date of birth (personal_details.dob)

(documents[0].extracted_data.personal_details.dob)

The individual's date of birth.

Nationality (personal_details.nationality)

(documents[0].extracted_data.personal_details.nationality)

The individual’s country of nationality.


How did we do?


Powered by HelpDocs (opens in a new tab)