Configuring idvcheck
Updated 1 month ago
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.
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.
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.
- 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 (e.g. ‘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 (e.g. "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 (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.
These are the profile details sent to idvcheck:
Field name | Description | Notes |
Portal: First name(s) API: | The individual’s first and, if applicable, middle names. | Required |
Portal: Surname API: | The individual’s last name. | Required |
Portal: Addresses API: | The individual’s address history. | Required |
Portal: Nationality API: | The individual’s country of nationality. | Required if the Check nationality configuration option is selected. Otherwise, optional. |
Portal: Date of birth API: | The individual’s date of birth. | Optional |
Portal: Gender API: | The individual’s gender. Leave unset for non-binary genders. | Optional |
Portal: Phone number API: | The individual’s phone number. | Optional |
Portal: Email address API: | The individual’s email address. | Optional |
API: | 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.
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.
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
These are the profile details sent to idvcheck:
Field name | Description | Notes |
Portal: Company name API: | The company’s name. | Required |
Portal: Country of incorporation API: | The country in which the company is incorporated. | Required |
API: | The history of the company’s registered addresses. | Required |
Portal: Tax IDs API: | 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. |
