W2 Data Ekyc UK 005

An identity verification service for the UK.

 

W2 Data Ekyc UK 005 Service

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

Contents

The following QueryData properties pertain to this service. Please note in the actual SOAP request the fields should be in alphabetical order.

Property Name Type Length Optional/Mandatory Notes
Forename
String
15 Mandatory  
MiddleNames
String
15 Optional The contents of this field will be converted into initials, therefore the character limit can usually be ignored.
Surname
String
30 Mandatory  
DayOfBirth
Integer
2 Mandatory  
MonthOfBirth
Integer
2 Mandatory  
YearOfBirth
Integer
4 Mandatory  
HouseName
String
26 Optional * Either house name or house number must be supplied
HouseNumber
String
26 Optional *  Either house name or house number must be supplied
Flat
String
16 Optional *  
Street
String
40 Optional *  
County
String
20 Optional *  
City
String
20 Optional *  
Postcode
String
8 Mandatory  
PhoneNumber
String
16 Optional * Please provide the phone number as one contiguous set of numbers with no other characters or spaces.

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

Notes

  • * Address information is optional if an AddressLookupRef is supplied in the query options. The AddressLookupRef is retrieved from the W2 Data Address Lookup 024 service as an addressId.

  • If an AddressLookupRef is not supplied then a minimum of House Name/Number and Postcode are required. Though it is advised to supply as much address information as possible as this is more likely to return a match if no prematched addressId is supplied. 

Request

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

<QueryData>
  <DayOfBirth>01</DayOfBirth>
  <Forename>Sirath</Forename>
  <HouseNameNumber>345</HouseNameNumber>
  <MonthOfBirth>07</MonthOfBirth>     
<PhoneNumber>01159922997</PhoneNumber> <Postcode>LA16 7DG</Postcode> <Surname>Niver</Surname> <YearOfBirth>1994</YearOfBirth>
</QueryData>

Response

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

<W2DataEkycUk005Result>
<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
}
<Source>
</MatchingSource>
</DataSources>
<InterpretResult>
{
NotPerformed | Pass | Fail | Refer | NoInterpretPerformed
}
</InterpretResult>
<Message>
{ A message containing additional information about the call }
</Message>
<TransactionResult>
{
None | Success | SuccessNoResults | SuccessIncompleteResults |
MultipleChoices | ClientErrorInformationFormatInvalid | ClientErrorInsufficientInformation |
NotExecutedDueToPreviousHalt | ServerErrorGeneralError | ServiceFailureError
}
</TransactionResult>
</W2DataEkycUk005Result>

 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> element.

 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 CCJ 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 = The source of the data match. E.g. CCJ

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

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
  • ClientErrorInformationFormatInvalid - Address fields cannot contain commas
ServiceInterpretResult
  • OneResult
  • MultipleResults
  • NoResults
  • 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 Postcode
Allen Kiril 8 1 1943 99 IVT X34
Rosie Duncan 1 2 1967 40 AB41 7YW
(Click on a sandbox case to see the service result data here)