iDIN Naw in the Netherlands is an the person verification service by a standard bank login process.
| Parameter | Description | Required |
|---|---|---|
initials | Initials | Yes |
lastName | Last name | Yes |
middleName | Middle name | No |
gender | Gender. Can be “Male” or “Female”. Short version “M” or “F” is also supported. | Yes |
birthDate | Date of birth (YYYY-MM-DD or YYYYMMDD) | Yes |
title | Academic title | No |
street | Street | No |
houseNumber | House number (only digits) | No |
houseNumberAddition | House number addition | No |
postalCode | Postal code (1000AA or 1000 AA) | No |
city | City | No |
phoneNumber | Phone number | No |
mobileNumber | Mobile number | No |
email | E-mail address | No |
relaystate | This optional parameter will be returned to you at the redirect back to your server. Use it to link an unique ID of your choice that you can parse. Example: | No |
target | If this parameter is supplied the browser session will finally be redirected to this URL-value. | No |
targetError | targetError works as target except it is navigated on user cancel or error situations. | No |
webhook | A URL where success/error results will automatically be POST:ed | No |
Each request returns a response with status and details.
id | A unique session identifier generated for each workflow instance. |
state | Session state |
errors | A JSON array of error conditions, see error handling. |
identity | Identity |
idinNawCheckUrl | Idin Check URL is used to perform the Naw check through Idin. |
idinCertificate | Can be used to verify the Idin check. |
{
"id": "f6b3f404-1483-4a9e-95c4-6f30b5857598",
"state": "Pending",
"errors": [],
"identity": {
"countryCode": "NL",
"firstName": "de",
"lastName": "Vries",
"fullName": "de Vries",
"personalNumber": "",
"dateOfBirth": "1975-07-25",
"age": 45,
"gender": "",
"addressInfoRaw": "Pascalstreet,Aachen,1000AA",
"idProviderName": "CDDN",
"identificationDate": "2020-09-07T08:46:24.3975039Z",
"idProviderRequestId": "",
"idProviderPersonId": "",
"customerPersonId": "",
"idProviderAuthenticityScore": "noT_SET"
},
"providerData": "{\"nategisCode\":\"NA GISRHXPW Q \",\"timestamp\":20990101,\"idinTitle\":\"\",\"idinInitials\":\"VJ\",\"idinMiddleName\":\"de\",\"idinLastName\":\"Vries\",\"idinGender\":\"M\",\"idinBirthDate\":19750725,\"idinStreet\":\"Pascalstreet\",\"idinHouseNumber\":\"19 \",\"idinHouseNumberAddition\":\"\",\"idinPostalCode\":\"1000AA\",\"idinCity\":\"Aachen\",\"idinPhoneNumber\":0,\"idinMobileNumber\":0,\"idinEmail\":\"[email protected]\",\"idinCertificate\":\"FANTASYBANK1234567890\",\"cddnIdentifier\":\"B1D7F71E-BCD5-429E-819B-E691E947BE9F\",\"idinNawCheckUrl\":\"https://idin.cddn.nl/test/getid/?uid=B1D7F71E-BCD5-429E-819B-E691E947BE9F&callback=https%3a%2f%2flocalhost%3a44381%2fapi%2fv3%2fcallbacks%2fidin%2fnaw%2ff6b3f404-1483-4a9e-95c4-6f30b5857598\"}",
"idinNawCheckUrl": "https://idin.cddn.nl/test/getid/?uid=B1D7F71E-BCD5-429E-819B-E691E947BE9F&callback=https%3a%2f%2flocalhost%3a44381%2fapi%2fv3%2fcallbacks%2fidin%2fnaw%2ff6b3f404-1483-4a9e-95c4-6f30b5857598"
}GET to https://env.zignsec.com/v3/eid/idin/naw/sessionid
env is API or test
How to get notified when workflow is finished:
There is both active and passive notification for when the workflow is finished
{
"id": "f6b3f404-1483-4a9e-95c4-6f30b5857598",
"state": "Pending",
"errors": [],
"identity": {
"countryCode": "NL",
"firstName": "de",
"lastName": "Vries",
"fullName": "de Vries",
"personalNumber": "",
"dateOfBirth": "1975-07-25",
"age": 45,
"gender": "",
"addressInfoRaw": "Pascalstreet,Aachen,1000AA",
"idProviderName": "CDDN",
"identificationDate": "2020-09-07T08:46:24.3975039Z",
"idProviderRequestId": "",
"idProviderPersonId": "",
"customerPersonId": "",
"idProviderAuthenticityScore": "noT_SET"
},
"providerData": "{\"nategisCode\":\"NA GISRHXPW Q \",\"timestamp\":20990101,\"idinTitle\":\"\",\"idinInitials\":\"VJ\",\"idinMiddleName\":\"de\",\"idinLastName\":\"Vries\",\"idinGender\":\"M\",\"idinBirthDate\":19750725,\"idinStreet\":\"Pascalstreet\",\"idinHouseNumber\":\"19 \",\"idinHouseNumberAddition\":\"\",\"idinPostalCode\":\"1000AA\",\"idinCity\":\"Aachen\",\"idinPhoneNumber\":0,\"idinMobileNumber\":0,\"idinEmail\":\"[email protected]\",\"idinCertificate\":\"FANTASYBANK1234567890\",\"cddnIdentifier\":\"B1D7F71E-BCD5-429E-819B-E691E947BE9F\",\"idinNawCheckUrl\":\"https://idin.cddn.nl/test/getid/?uid=B1D7F71E-BCD5-429E-819B-E691E947BE9F&callback=https%3a%2f%2flocalhost%3a44381%2fapi%2fv3%2fcallbacks%2fidin%2fnaw%2ff6b3f404-1483-4a9e-95c4-6f30b5857598\"}",
"idinNawCheckUrl": "https://idin.cddn.nl/test/getid/?uid=B1D7F71E-BCD5-429E-819B-E691E947BE9F&callback=https%3a%2f%2flocalhost%3a44381%2fapi%2fv3%2fcallbacks%2fidin%2fnaw%2ff6b3f404-1483-4a9e-95c4-6f30b5857598"
}