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.
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.
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.
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.
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) ( Required | The individual’s first and, if applicable, middle names. |
Surname ( Required | The individual’s last name. |
Addresses ( Required | The individual’s address history. |
Nationality ( Optional Required if the Check nationality configuration option is used | The individual’s country of nationality. |
Date of birth ( Optional | The individual’s date of birth. |
Gender ( Optional | The individual’s gender. Leave unset for non-binary genders. |
Phone number ( Optional | The individual’s phone number. |
Email address ( Optional | The individual’s email address. |
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 ( *Required | The company’s name. |
Country of incorporation ( *Required | The country in which the company is incorporated. |
*Required | The history of the company’s registered addresses. |
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. |