Global Identity Check (029)

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

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

Example request

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

Available Countries

Response

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

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

Sandbox

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

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

Example sandbox request

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