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 behaviour 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 and gender) in the sources supplied by Capita Identity Solutions.

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

  1. The individual’s full name and address are matched in one source and the individual’s full name and date of birth are matched in a second source of a different type (e.g. a credit bureau and an electoral role are two different types).
  2. 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:

  1. The individual’s full name, date of birth, and address are matched in one source.
  2. 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.

Configuration options

You can use the following configuration options:

  • Date of birth is required for 1+1 and 2+2 results (optional): 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 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 of birth are matched in a second source.
    • A 1+1 result is only achieved when the individual's full name, date of birth, and address are matched in one source.
  • Mortality check (optional): If a match for the individual's full name and address or the individual's full name and date of birth is found on Capita Identity Solutions' mortality lists, the check fails.
  • Pass check on 1+1 results (optional): When this option is selected, the check passes when a 1+1 result is achieved. Partial matches are never returned.

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:

  • License Key
  • Client Key
  • Profile short code

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

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 (default configuration):

  1. 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.
  2. 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 (e.g. "Alex 1+1") and run the check variant. If the check returns a partial match, it’s working as expected.
  3. 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 (e.g. "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:

  1. 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 (e.g. "Alex 1+1") and run the check variant. If the check passes, it’s working as expected.
  2. 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 (e.g. "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.

Required and optional 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.


How did we do?


Powered by HelpDocs (opens in a new tab)