Configuring GetID

How it works

This is the default behavior 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 License
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 fields listed here 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 and which configuration options you'd like to use. We’ll set it up for you.

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

Testing your configuration

Once the check variant is configured, follow these steps 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 the 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.

In this section: