W2 Data Ekyc UK 015

An identity verification service for the UK.

W2 Data Ekyc UK 015 Service

W2 Data Ekyc UK 15 is an identity verification service that includes the full Electoral Roll, CCJ and Credit Lenders data. This service will leave a money laundering footprint on the lenders profile of the person you are requesting information about.

Configuration

This service has some configuration that will be discussed with you as part of the on-boarding process. We can configure a matching profile and which sources of information to use when calculating a 2 plus 2 check. Please contact W2 Support for more information.

Contents

The following Query Data properties pertain to this service. Please note that in the SOAP request the fields must be in alphabetical order.

Property Name Type Length Optional/Mandatory
Title
String
10 Optional
Forename
String
15 Mandatory
MiddleNames
String
15 Optional
Surname
String
30 Mandatory
DayOfBirth
Integer
2 Mandatory
MonthOfBirth
Integer
2 Mandatory
YearOfBirth
Integer
4 Mandatory
HouseName
String
26 One of them is Mandatory
HouseNumber
String
26
Flat
String
20 Optional
Street
String
40 Optional
Region
String
20 Optional
County
String
20 Optional
Country
String
20 Optional
City
String
20 Optional
Postcode
String
8 Mandatory

After performing the search, the validation result (pass, fail, etc.) will be part of the <TransactionInformation> returned for the service call. 

The following is an example SOAP request to the W2 Data Ekyc UK 015 Service. 

<serviceRequest>
    <BundleData>
        <BundleName>{YOUR BUNDLE NAME HERE}</BundleName>
    </BundleData>
    <QueryData>
        <DayOfBirth>{e.g. 01}</DayOfBirth>
        <Forename>{e.g. JOHN}</Forename>
        <MiddleNames>{e.g. JAMES} </MiddleNames>
        <MonthOfBirth>{e.g. 01}</MonthOfBirth>
        <Surname>{e.g. SMITH}</Surname>
        <YearOfBirth>{e.g. 1990}</YearOfBirth>
    </QueryData>  
    <ServiceAuthorisation>
        <APIKey>{YOUR API KEY HERE}</APIKey>
        <ClientReference>{YOUR CLIENT REFERENCE HERE}</ClientReference>
    </ServiceAuthorisation>
</serviceRequest>

 

The following shows the basic schema for the <W2DataEkycUk015Result> object that is returned in the <ServiceResult> Section of the <ProcessRequestResult> object.

<W2DataEkycUk015Result>
<DataSources>
<!-- An array of MatchingSource elements -->
<MatchingSource>
<AllowMultipleRecordsAsSeparateDataSources>
{ true | false }
</AllowMultipleRecordsAsSeparateDataSources>
<MatchingCriteria>
{
NotAssigned | NameAndAddress | NameAndDateOfBirth |
NameAndAddressAndDateOfBirth | MortalityHighConfidence |
MortalityLowConfidence | SurnameAndPhoneNumberAtAddress
}

</MatchingCriteria>
<NumberOfMatches>
{ 0 - 99 }
<NumberOfMatches>
<Source>
{
0 = NotAssigned
1 = ElectoralRoll
2 = CCJ
3 = CreditLendersA
4 = CreditLendersB
5 = BT_OSIS
6 = MortalityData
7 = CreditLendersC
}

<Source>
</MatchingSource>
</DataSources>
<InterpretResult>
{
NotPerformed | Pass | Fail | Refer | NoResults |
OneResult | MultipleResults | NotApplicable | NoInterpretPerformed
}

</InterpretResult>
<Message>
{ A message containing additional information about the call }
</Message>
<TransactionResult>
{
None | Success | SuccessNoResults | SuccessIncompleteResults |
MultipleChoices | ClientErrorInformationFormatInvalid | ClientErrorInsufficientInformation |
NotExecutedDueToPreviousHalt | ServerErrorGeneralError | ServiceFailureError
}

</TransactionResult>
</W2DataEkycUk015Result>

Below is some more information about the some of the elements of the response that require explanation:

DataSources = A collection showing every source of data that was used to formulate the result. Each source is represented by a <MatchingSource> elment.

AllowMultipleRecordsAsSeparateDataSources = Indicates that two different record matches from the same data source may count as independent sources when formulating the 2 + 2 result. For example, two Insight results may count as two sources, rather than one, as they would do under normal service circumstances.

MatchingCriteria = Precisely what data has been matched by the data source. E.g. NameAndAddressAndDateOfBirth

NumberOfMatches = The number of matches found by this data source

Source = An integer representing the source of the data match. E.g. 2 = CCJ (County Court Judgement)

SourceId Source Matched
1 Electoral Roll
2 County Court Judgements (CCJs)
3 N/A
4 Credit Lenders (Insight)
5 BT_OSIS
6 Mortality Data
7 Credit Lenders(Call Credit)

InterpretResult = The overall verification result, based on what matches were found in the data source against the query data submitted. The possiblities are Pass, Fail or Refer

Message = Gives some more details / context on the verification result

TransactionResult = A diagnostic result showing whether or not any technical errors were experienced during the check. This should always be "Success" unless a technical error has occured, in which case the verification check will be aborted.

Example Response:

The below example shows a case where we have found one NameAndAddress match on the Electoral roll and 3 NameAndAddressAndDateOfBirth matches on CreditLendersB. This has resulted in a Pass.

<W2DataEkycUk015Result>
<DataSources>
<MatchingSource>
<AllowMultipleRecordsAsSeparateDataSources>false</AllowMultipleRecordsAsSeparateDataSources>
<MatchingCriteria>NameAndAddress</MatchingCriteria>
<NumberOfMatches>1<NumberOfMatches>
<Source>1<Source>
</MatchingSource>
<MatchingSource>
<AllowMultipleRecordsAsSeparateDataSources>true</AllowMultipleRecordsAsSeparateDataSources>
<MatchingCriteria>NameAndAddressAndDateOfBirth</MatchingCriteria>
<NumberOfMatches>3<NumberOfMatches>
<Source>4<Source>
</MatchingSource>
</DataSources>
<InterpretResult>Pass</InterpretResult>
<Message />
<TransactionResult>Success</TransactionResult>
</W2DataEkycUk015Result>

Transaction Result

HaltTriggered False
ServiceTransactionResult
  • Success
  • SuccessIncompleteResults Too many matches on the search criteria and the results have been truncated
  • SuccessNoResults No matches found
  • ServerErrorGeneralError An error occurred
  • ServiceFailureError- Unable to contact third party service
  • ClientErrorInsufficientInformation Required field not supplied or insufficient/invalid information
ServiceInterpretResult
  • OneResult
  • MultipleResults
  • Fail
  • NoResults
  • NoInterpretPerformed
  • NotPerformed - An error occurred and the search was not performed
ServiceTransactionResultMessage Usually empty, can contain optional information such as too many matches etc.
ValidationResult
  • Pass
  • NotPerformed - No search occurred to match against
  • Fail MissingMandatoryField or PatternNotMatched

Sandbox mode can be used to test the service. By setting the following query option and sending some the below query data we will return a pre-configured response without actually calling our suppliers.

<QueryOptions>
  <KeyValueOfstringstring>
    <Key>Sandbox</Key>
    <Value>true</Value>
  </KeyValueOfstringstring>
</QueryOptions>

If the Sandbox query option is set to "true" then the following queries will return results. The result of the verification will depend on the configuration of the matching set up during the on-boarding process.

To see the details of the service response of each sandbox case, simply click on it in the table below:

 

Forename Surname Day Of Birth Month Of Birth Year Of Birth Flat House Name Number Street Postcode
Amber Ball 9 7 1957 147 Ocean View WT1 1TD
Anquan Error 14 5 1978 10 Error Road ER3 3OR
Billy Jones 31 12 1944 68 RH13 3HE
Callum Error 5 5 1992 7 Ocean View Z15 007B
Cameron Parker 17 12 1959 3 Ocean View WT1 1TD
Charlie Error 12 6 1965 83 Ocean View Z15 007B
Charlie Wilkinson 18 11 1968 26 LN4 7AT
Chloe Error 12 3 1980 44 Ocean View Z15 007B
David Robson 9 5 1992 42 HU12 9FL
Declan Woods 11 1 1975 37 Ocean View WT1 1TD
Elise Dodd 15 7 1992 11 Ocean View WT1 1TD
Fred Error 3 4 1986 56 Ocean View NP1 1NP
Isaac Atkinson 13 12 1940 13 Ocean View WT1 1TD
Jack Doherty 28 1 1978 10 Ocean View WT1 1TD
James Error 10 6 1978 4 Ocean View NP1 1NP
James Thorpe 10 6 1978 4 AB54 4PN
Jamie Error 15 8 1959 57 Ocean View NP1 1NP
John Smith 8 11 1977 76 Ocean View WT1 1TD
Jonny Miles 8 1 1943 2 99 IVT X34
Kate Blake 8 9 1968 15 Ocean View WT1 1TD
Laura Error 28 7 1965 33 Ocean View NP1 1NP
Luana Melania 11 12 1924 8 AB54 5TR
Lucy Error 5 8 1967 56 Ocean View Z15 007B
Martin Error 3 9 1987 63 Ocean View NP1 1NP
Mary Error 1 12 1991 32 Ocean View NP1 1NP
Megan Crawford 5 4 1957 1B 1 Orchid Bank WT2 2DF
Micah Stefanu 10 4 1952 7 AB54 5TR
Moray Abdiou 11 12 1924 26 LN4 7AT
Nicholas Daly 20 6 1968 2 Ocean View WT1 1TD
Olivia Owens 29 6 1990 38 Ocean View WT1 1TD
Rosie Duncan 1 2 1967 40 AB41 7YW
Ruby Error 23 7 1956 33 Ocean View Z15 007B
Suzanne Error 8 11 1978 47 Ocean View Z15 007B
Theron Marcel 8 1 1943 99 IVT X34
Tom Goodwin 12 9 1973 5 Ocean View WT1 1TD
Tom Error 1 5 1998 3 Ocean View Z15 007B
Vincenc Claus 10 4 1952 7 AB54 5TR
(Click on a sandbox case to see the service result data here)