Skip to main content

Configuring idvcheck

idvcheck is a data provider you can use to run these checks:

  • ID verification (Passfort collects documents)

  • Document verification

ID verification (Passfort collects documents)

How it works

This is the default behavior for a variant of the ID verification (Passfort collects documents) check with idvcheck as the data provider.

You upload the individual’s documents to Passfort. Passfort submits the documents and the individual’s profile information (name, address history, and, if available, nationality, date of birth, gender, title, phone number, and email address) to idvcheck.

You can upload these documents for the Verify address task:

  • Driving license

  • State ID

  • Utility bill

  • Bank statement

  • Mortgage

  • Council tax, submitted as Tax

  • Miscellaneous

You can upload these documents for the Verify identity task:

  • Driving license

  • Passport

  • State ID

  • Tax (e.g. tax statements)

  • Miscellaneous

The document size limit is 50MB. The following file types are accepted: GIF, JPG, PNG, PDF, TIFF. To learn which documents idvcheck will accept under the Miscellaneous category, check your idvcheck contract or speak to your idvcheck account manager.

idvcheck assigns a specialist to manually check whether the documents are valid and to perform any other processes you have previously agreed with idvcheck.

The check passes when the specialist confirms the documents are valid.

If the specialist chooses not to pass the check because the ID may be fraudulent or is expired, the check fails.

If the specialist indicates the check pending, the check fails and the reason for their decision is displayed in the fail message. If this is the case, you may wish to run the check again at a later date.

If the individual’s profile doesn’t have data for the required fields, the check returns an error.

This check variant is supported for all countries.

To learn more about what your idvcheck specialists do for you, speak to your idvcheck account manager.

To learn how the idvcheck API handles this check, see idvcheck’s API documentation. To get step-by-step instructions for running this check, see Verify a document.

Configuration options

Check the individual's nationality against the one extracted from the document: When this option is selected, the profile’s nationality is always sent to idvcheck. If the profile does not have a country of nationality, an error is displayed.

What we’ll need

Let us know that you’d like to add a variant of the ID verification (Passfort collects documents) with idvcheck and whether you’d like to use the Check nationality configuration option. We’ll set it up for you.

We’ll also need your idvcheck username and password. For help getting this information, please speak to your idvcheck account manager.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

  1. Does the check pass when the specialist at idvcheck confirms the ID is authentic?

    To run the test, create any individual profile and run the check variant, using any image as the ID. If the check passes, it’s working as expected.

  2. Does the check fail when the specialist at idvcheck determines the ID may be fraudulent?

    To run the test, create an individual profile with Fraud as the last name, such as Alex Fraud, and run the check variant, using any image as the ID. If the check fails, it’s working as expected.

  3. Does the check fail when the specialist at idvcheck determines the ID is expired?

    To run the test, create an individual profile with "Expired as the last name, such as Alex Expired, and run the check variant, using any image as the ID. If the check fails, it’s working as expected.

  4. Does the check fail when the specialist at idvcheck indicates the ID has pending checks?

    To run the test, create an individual with Pending as the last name, such as Alex Pending, and run the check variant, using any image as the ID. If the check fails and the explanation in the fail message is, "The following data comparison checks failed: expiry," the check is working as expected.

Test words are not case-sensitive.

Profile fields

These are the profile details sent to idvcheck:

Name

Description

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

Required

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

Surname (personal_details.name.family_name)

Required

The individual’s last name.

Addresses (address_history)

Required

The individual’s address history.

Nationality (personal_details.nationality)

Optional

Required if the Check nationality configuration option is used

The individual’s country of nationality.

Date of birth (personal_details.dob)

Optional

The individual’s date of birth.

Gender (personal_details.gender)

Optional

The individual’s gender. Leave unset for non-binary genders.

Phone number (contact_details.phone_number)

Optional

The individual’s phone number.

Email address (contact_details.email)

Optional

The individual’s email address.

personal_details.name.title

Optional

The individual’s title.

Document verification

How it works

This is the default behavior for a variant of the Document verification check with idvcheck as the data provider.

You upload the company’s documents to the check on the task. The type of document depends on the task:

  • For the Verify bank account task, upload proof of the company’s bank account.

  • For the Verify company address task, upload proof of the company's address. This can be a bank statement or utility bill.

  • For the Verify company details task, upload proof of the company’s identity.

  • For the Verify tax status task, upload proof of the company’s tax status.

The document size limit is 50MB. The following file types are accepted: GIF, JPG, PNG, PDF, TIFF.

Passfort submits the documents and the company’s profile information (name, address of incorporation, and, if the document is proof of the company’s tax status, tax number) to idvcheck.

idvcheck assigns a specialist to manually check whether the documents are valid and to perform any other processes you have previously agreed with idvcheck.

The check passes when the specialist confirms the documents are valid.

If the specialist chooses not to pass the check because the documents are expired, the check fails.

If the company’s profile doesn’t have data for the required fields, an error is displayed.

This check variant is supported for all countries.

To learn more about what your idvcheck specialists do for you, speak to your idvcheck account manager.

Configuration options

There are no additional configuration options for this check variant.

What we’ll need

Let us know that you’d like to add a variant of the Document verification check with idvcheck, and we’ll set it up.

We’ll also need your idvcheck username and password. For help getting this information, please speak to your idvcheck account manager.

Using your configuration

We’re currently building out the tests for this check variant.

Profile fields

These are the profile details sent to idvcheck:

Name

Description

Company name

(metadata.name)

*Required

The company’s name.

Country of incorporation

(metadata.country_of_incorporation)

*Required

The country in which the company is incorporated.

metadata.addresses

*Required

The history of the company’s registered addresses.

Tax IDs

(metadata.tax_ids)

*Required (only required when the document is proof of the company's tax status)

The company’s tax type, such as VAT, Euro VAT or EIN, and ID number.

In this section: