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 behaviour 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.

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

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.

Configuration options

Check nationality? (optional): 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 (e.g. ‘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 (e.g. "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 (e.g. "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.

These are the profile details sent to idvcheck:

Field name

Description

Notes

Portal: First name(s)

API:personal_details.name.given_names

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

Required

Portal: Surname

API:personal_details.name.family_name

The individual’s last name.

Required

Portal: Addresses

API:address_history

The individual’s address history.

Required

Portal: Nationality

API:personal_details.nationality

The individual’s country of nationality.

Required if the Check nationality configuration option is selected.

Otherwise, optional.

Portal: Date of birth

API:personal_details.dob

The individual’s date of birth.

Optional

Portal: Gender

API:personal_details.dob

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

Optional

Portal: Phone number

API:contact_details.phone_number

The individual’s phone number.

Optional

Portal: Email address

API:contact_details.email

The individual’s email address.

Optional

API:personal_details.name.title

The individual’s title.

Optional

Document verification

How it works

This is the default behaviour 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 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 10MB. The following file types are accepted: GIF, JPG, PNG, PDF

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.

These are the profile details sent to idvcheck:

Field name

Description

Notes

Portal: Company name

API:metadata.name

The company’s name.

Required

Portal: Country of incorporation

API:metadata.country_of_incorporation

The country in which the company is incorporated.

Required

API:metadata.addresses

The history of the company’s registered addresses.

Required

Portal: Tax IDs

API:metadata.tax_ids

The company’s tax type (e.g. VAT, Euro VAT, EIN) and ID number.

Required when the document is proof of the company’s tax status.

Otherwise, this field is not sent to idvcheck.


How did we do?