Configuring GetID

Updated 1 month ago by Caroline

Configuration options

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

dob

gender

number

expiry

checksums

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.