W2 Data EKYC Global 029 ​

Compatible Cases

About the service ​

W2 Data EKYC Global 029 is a global identity verification service. 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.

Product Code: W2-DATA-EKYC-GLOBAL-029

Does this service leave a credit search Footprint? Yes

Request ​

Query Data ​

The following QueryData elements pertain to this service.

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

Suported countries ​

The full list of supported countries with required fields.

National IDs ​

The table above specifies some countries require a national Id type. This can be provided in the query options section of the request.

The key for the option should be Global029NationalIdType

The available national IDs and national ID types per country are as follows:

Example request ​

A typical request might look like this:

"Data": {
	"Country":"FRA",
  	"City": "Paris",
  	"DayOfBirth": 21,
  	"Forename": "Emmanuel",
  	"HouseNumber": "55",
  	"MonthOfBirth": 12,
  	"Postcode": "75008",
  	"Surname": "Macron",
  	"Street": "Rue du Faubourg",
  	"YearOfBirth": 1977
  }

Response ​

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

Example Response ​

Single data source example ​

"w2DataEkycGlobal029Result": {
	"dataSources": [{
			"AllowMultipleRecordsAsSeparateDataSources": false,
			"MatchingCriteria": "NameAndAddress",
			"NumberOfMatches": 1,
			"Source": "Credit"
		}
	],
	"interpretResult": "Pass",
	"Message": "The call was successful",
	"transactionResult": "SuccessIncompleteResults"
}

Multiple data sources example ​

"w2DataEkycGlobal029Result": {
	"dataSources": [{
			"AllowMultipleRecordsAsSeparateDataSources": false,
			"MatchingCriteria": "NameAndAddress",
			"NumberOfMatches": 1,
			"Source": "Credit"
		},{
			"AllowMultipleRecordsAsSeparateDataSources": false,
			"MatchingCriteria": "NameAndAddressAndDateOfBirth",
			"NumberOfMatches": 3,
			"Source": "Government"
		}
	],
	"interpretResult": "Pass",
	"Message": "The call was successful",
	"transactionResult": "SuccessIncompleteResults"
}

Response breakdown ​

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

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.

Transaction Result

Sandbox ​

The following is an example request. Sandbox cases are provided below.

Remember to include the W2 provided API key in the Authorization Header.

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

Example sandbox request ​

{
    "Bundle": "KYC_Global_029",
    "Data": {
	"Country":"BEL",
        "Forename": "Michael",
        "Surname": "Tschank",
        "DayOfBirth": 7,
        "MonthOfBirth": 5,
        "YearOfBirth": 1984,
        "HouseNumber": "51",
        "Street": "Nobilegasse",
        "City":"Wien",
        "Postcode": "1150"
    },
    "Options": {
        "Sandbox": "true"
    },
    "ClientReference": "your-client-reference"
}

Sandbox cases

These are the sandbox options for these service. Learn about our Sandbox here

Click on a sandbox case to view the request and response