W2 Data EKYC FR 029 Service

An identity check service for France

This service is currently only available in Beta

W2 Data EKYC FR 029 Service

W2 Data EKYC FR 029 is an identity verification service for France. W2 will combine several sources of data to make a match. We have a default setup for how we combine sources to make a match, which can be configured if needed. Please contact W2 support for more details.

Query Data

The following QueryData elements pertain to this service.

Property Name Type Length Optional/Mandatory Notes
Forename
String
15 Mandatory  
MiddleNames
String
15 Optional  
Surname
String
30 Mandatory  
Gender
String
  Optional Must be 'M' or 'F' if provided
DayOfBirth
Integer
2 Mandatory  
MonthOfBirth
Integer
2 Mandatory  
YearOfBirth
Integer
4 Mandatory  
HouseName
String
26 Mandatory if no HouseNumber given  Minimum address fields are HouseName or Housenumber as well as the postcode. We advise that more address information be sent if possible as this will improve the chances of a match
HouseNumber
String
26 Mandatory if no HouseName given  
Street
String
255 Optional  
Region
String
255 Optional  
City
String
100 Optional  
Postcode
String
5 Mandatory  
Phone Number
String
16 Optional Please provide the phone number as one contiguous set of numbers with no other characters or spaces.
NationalId
String
30 Optional  

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

Request

A typical request might look like this:

<neur:QueryData>
<neur:City>Paris</neur:City>
<neur:DayOfBirth>21</neur:DayOfBirth>
<neur:Forename>Emmanuel</neur:Forename>
<neur:HouseNumber>55</neur:HouseNumber>
<neur:MonthOfBirth>12</neur:MonthOfBirth>
<neur:Postcode>75008</neur:Postcode>
<neur:Surname>Macron</neur:Surname>
<neur:Street>Rue du Faubourg</neur:Street>
<neur:YearOfBirth>1977</neur:YearOfBirth>
</neur:QueryData>

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

<W2DataEkyc029Result>
<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>
{
8 = Credit
9 = Goverment
10 = Commercial
11 = Consumer
12 = Utility
13 = Proprietary
14 = Teleco
15 = Postal
}

<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>
</W2DataEkyc029Result>

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. 8 = Credit

SourceId Source Matched Notes 
8 Credit Established credit agencies in the country (Coverage: > 90%; Update Frequency: Daily)
9 Government Electoral data, driver's license or history (Coverage: > 90%; Update Frequency: Daily)
10 Commercial Insurance Records, Business Directory, Tenancy Information (Coverage:  > 50%; Update Frequency: Quarterly )
11 Consumer Public Records, Citizen Data sources, marketing and membership data (the AA etc) (Coverage:  > 50%; Update Frequency: Quarterly )
12 Utility Data issued for a national utility provider which includes telephone, gas, electricity, or water. (Coverage: > 90%; Update Frequency:  Annually)
13 Proprietary  
14 Teleco Public Number Directory (Coverage: > 75%; Update Frequency:  Annually)
15 Postal  
     


InterpretResult
= The overall verification result, based on what matches were found in the data source against the query data submitted. The possibilities 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 occurred, 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 Government and 3 NameAndAddressAndDateOfBirth matches on Commercial. This has resulted in a Pass.

<W2DataEkyc029Result>
<DataSources>
<MatchingSource>
<AllowMultipleRecordsAsSeparateDataSources>false</AllowMultipleRecordsAsSeparateDataSources>
<MatchingCriteria>NameAndAddress</MatchingCriteria>
<NumberOfMatches>1<NumberOfMatches>
<Source>9<Source>
</MatchingSource>
<MatchingSource>
<AllowMultipleRecordsAsSeparateDataSources>false</AllowMultipleRecordsAsSeparateDataSources>
<MatchingCriteria>NameAndAddressAndDateOfBirth</MatchingCriteria>
<NumberOfMatches>3<NumberOfMatches>
<Source>10<Source>
</MatchingSource>
</DataSources>
<InterpretResult>Pass</InterpretResult>
<Message />
<TransactionResult>Success</TransactionResult>
</W2DataEkyc029Result>

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

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

If the Sandbox query option is set to "true" then any of the following entities will return a result:

Forename Surname Day Of Birth Month Of Birth Year Of Birth Flat House Name Number Street Postcode Result
Camille Pelchat 23 5 1987 69 rue Lenotre 35000 Pass
Dorene Bordeaux 1 4 2001 85 Square de la Couronne 77330 Pass
Émile Bernard 24 9 1979 19 rue de la paix 45260 Pass
Jacquenett DAubigne 11 4 1959 62 boulevard de la Liberation 13014 Pass
Jacques Morel 28 6 1994 24 rue du petit val 2310 NoResults
Martin Fréminet 10 12 1987 39 rue Jean de Bernardy 13001 Pass
Monique Desnoyer 12 12 1974 72 Place de la Gare 31770 Pass
Paige Léveillé 28 11 1967 64 rue de la Hulotais 59430 Inconclusive
Simon Marmion 8 1 1969 166 rue du Général Leclerc 67540 Inconclusive
Suzanne Valadon 22 2 1985 22 chemin de Pénatière 38640 Fail
Vincent Bérubé 26 4 1965 96 rue des six frères Ruellan 95110 Fail
(Click on a sandbox case to see the service result data here)