Netherlands (Alpha/005)

Compatible Cases

About the service

ID Check NL Alpha is an identity verification service for Netherlands. It uses National Database, Telephone Directory, Passports and ID Card.

Product Code: W2-DATA-EKYC-NL-005

Does this service leave a credit search Footprint? Yes

Request

Property	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
HouseNumber	String	26	Mandatory if no HouseName given
Street	String	40	Mandatory
County	String	20	Optional
City	String	20	Mandatory
Postcode	String	8	Mandatory
Phone Number	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.

Response

Example response

"idCheckNLAlphaResult": {
            "individuals": {
                "individual": {
                    "addresses": {},
                    "individualSummary": {}
                },
                "summary": {
                    "decision": "-1",
                    "decisionReasons": {
                        "decisionReasonList": [
                            {
                                "decision": "-1",
                                "element": "Individual/IndividualSummary/DateOfBirthMatch"
                            },
                            {
                                "decision": "-1",
                                "element": "Individual/IndividualSummary/NameMatch"
                            }
                        ]
                    }
                },
                "type": "Result"
            },
            "searchRef": "dd66471d-8d8d-48e2-aafa-12a6c9b4c059",
            "summary": {
                "decisionMatrix": {
                    "code": "******",
                    "decision": {
                        "outcome": "1",
                        "reason": "Individual has only matched on name no address or DOB"
                    },
                    "name": "****************",
                    "rules": {
                        "ruleList": [
                            {
                                "id": "Individuals Datablock",
                                "name": "BSO/DEU/Bespoke/Nam/NameDOB",
                                "outcome": "-1",
                                "reason": "Individual has a full match to forename surname and DOB"
                            },
                            {
                                "id": "Telephony Datablock",
                                "name": "BSO/DEU/Bespoke/NamPremPC/ID/90/NameAddress",
                                "outcome": "-1",
                                "reason": "Individual has a full match to forename surname premise postcode"
                            }
                        ]
                    }
                },
                "kycSummary": {
                    "address": {
                        "count": "4"
                    },
                    "alerts": {
                        "count": "0"
                    },
                    "dateOfBirth": {
                        "count": "3"
                    },
                    "fullNameAndAddress": {
                        "count": "0"
                    },
                    "surnameAndAddress": {
                        "count": "0"
                    }
                },
                "reportSummary": {
                    "datablocksSummary": {
                        "datablockSummaryList": [
                            {
                                "decision": "1",
                                "name": "Individuals"
                            },
                            {
                                "decision": "",
                                "name": "Telephony"
                            }
                        ]
                    }
                }
            },
            "telephony": {
                "type": "NoMatch"
            }
        }

Sandbox

Pass result

If the following details are set, a single fictitious PASS result is returned in IDCheckNLAlphaResult:

Property	Value
City	"Stein"
DayOfBirth	14
Forename	"Michael"
HouseNumber	241
MonthOfBirth	7
PhoneNumber	"0619154863"
Postcode	"6171KK"
Street	"Stadhouderslaan"
Surname	"Meuleberg"
YearOfBirth	1975

The corresponding entry in ServiceTransactions will show the following properties:

Property	Value
HaltTriggered	False
ServiceInterpretResult	NotApplicable
ServiceTransactionResult	Success
ServiceTransactionResultMessage	"This call was generated using sandbox mode"
ValidationResult	Pass

Fail Result

If the following details are set, a single fictitious FAIL result is returned in IDCheckNLAlphaResult

Property	Value
City	"Hague"
DayOfBirth	12
Forename	"Thomas"
HouseNumber	61
MonthOfBirth	5
Postcode	"2522HK"
Street	"Boele van Hensbroekstraat"
Surname	"Duisenberg"
YearOfBirth	1981

The corresponding entry in ServiceTransactions will show the following properties:

Property	Value
HaltTriggered	False
ServiceInterpretResult	Fail
ServiceTransactionResult	Success
ServiceTransactionResultMessage	"This call was generated using sandbox mode"
ValidationResult	Pass