Skip to main content

Using Passfort

Configuring Capita Identity Solutions

With Capita Identity Solutions, you can run the Electronic identity check for profiles in the UK.

How it works

This is the default behavior for a variant of the Electronic identity check with Capita Identity Solutions as the data provider.

The check is performed by searching for the individual’s details, name, address, and, if available, date of birth (DOB) and gender, in the sources supplied by Capita.

The check passes when a 2+2 result is achieved, which happens when either of these conditions are true:

  • The individual’s full name and address are matched in one source and the individual’s full name and DOB are matched in a second source of a different type, for example, a credit bureau and an electoral role are two different types.

  • The individual’s full name and address are matched in two distinct sources of different types.

If a 2+2 result cannot be achieved, the check looks for a 1+1 result.

The check returns a partial match when a 1+1 result is achieved, which happens when either of these conditions are true:

  • The individual’s full name, DOB, and address are matched in one source.

  • The individual’s full name and address are matched in one source.

If the conditions are not met for a 2+2 result or a 1+1 result, the check fails.

If the individual’s profile doesn’t have data for the required fields or the country of the individual's address is something other than the UK, the check returns an error.

What we'll need

Let us know that you'd like to add a variant of the Electronic identity check with Capita Identity Solutions and which configuration options you'd like to use. We'll set it up for you.

We'll also need your Capita details:

  • License Key

  • Client Key

  • Profile short code

For help getting this information, please speak to your Capita Identity Solutions account manager.

Configuration options

You can use the following configuration options:

  • Configure custom matching rules: When this option is selected, you can use your own rules.

  • Date of birth must match in one source to achieve a 1+1 or 2+2 result: When this option is selected, it's only possible to achieve a 2+2 result or a 1+1 result when the individual's date of birth (DOB) is matched in Capita's sources. In other words:

    • A 2+2 result is only achieved if the individual's full name and address are matched in one source and the individual's full name and date are matched in a second source.

    • A 1+1 result is only achieved when the individual's full name, DOB, and address are matched in one source.

  • Fail the check if a mortality result is found: If a match for the individual's full name and address or the individual's full name and DOB is found on Capita Identity Solutions' mortality lists, the check fails.

  • Pass check on 1+1 result: When this option is selected, the check passes when a 1+1 result is achieved. Partial matches are never returned.

Using your configuration

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

When the check variant is configured to pass on 2+2 results, the default configuration:

  • Does the check pass when a 2+2 result is achieved? To run the test, create any individual profile and run the check variant. If the check passes, it’s working as expected.

  • Does the check return a partial match when a 1+1 result is achieved? To run the test, create an individual profile with 1+1 as the given name or surname, for example, Alex 1+1, and run the check variant. If the check returns a partial match, it’s working as expected.

  • Does the check fail when the conditions are not met for a 2+2 result or a 1+1 result? To run the test, create an individual profile with FAIL as the given name or surname, such as Alex FAIL and run the check variant. If the check fails, it’s working as expected.

When the check variant is configured to pass on 1+1 results:

  • Does the check pass when a 1+1 result is achieved? To run the test, create an individual profile with 1+1 as the given name or surname, for example, Alex 1+1, and run the check variant. If the check returns a partial match, it’s working as expected.

  • Does the check fail when the conditions are not met for a 1+1 result? To run the test, create an individual profile with FAIL as the given name or surname, such as Alex FAIL and run the check variant. If the check fails, it’s working as expected.

It's only possible to test the Mortality check configuration option in the live environment. If you have it enabled, run the check on an individual you know has passed away to confirm the check fails. The results returned are for demo purposes only. In the live environment, it is only possible to achieve 2+2 results and discover matches based on address for profiles that have an address. Equally, an error is displayed in the live environment when the check variant is run on a profile with a country of address that isn't covered by Capita Identity Solutions. The test words are not case-sensitive.

Profile fields

These are the profile details searched in the sources from Capita Identity Solutions:

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.

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.