iDIN Naw in the Netherlands is an the person verification service by a standard bank login process.

 

Start: POST to https://env.zignsec.com/v3/eid/idin/naw

Result: GET from https://env.zignsec.com/v3/eid/idin/naw/sessionid
where env is API or test sessionid is the session identifier retrieved from the setup call, named id in the response.

POST to https://env.zignsec.com/v3/eid/idin/naw

env is API or test 

ParameterDescriptionRequired
initialsInitialsYes
lastNameLast nameYes
middleNameMiddle nameNo
genderGender. Can be “Male” or “Female”. Short version “M” or “F” is also supported.Yes
birthDateDate of birth (YYYY-MM-DD or YYYYMMDD)Yes
titleAcademic titleNo
streetStreetNo
houseNumberHouse number (only digits)No
houseNumberAdditionHouse number additionNo
postalCodePostal code (1000AA or 1000 AA)No
cityCityNo
phoneNumberPhone numberNo
mobileNumberMobile numberNo
emailE-mail addressNo
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: relaystate=zignsec_eid_1234

No
targetIf this parameter is supplied the browser session will finally be redirected to this URL-value.No
targetErrortargetError works as target except it is navigated on user cancel or error situations.No
webhookA URL where success/error results will automatically be POST:edNo

Each request returns a response with status and details.

idA unique session identifier generated for each workflow instance.
stateSession state
errorsA JSON array of error conditions, see error handling.
identityIdentity
idinNawCheckUrlIdin Check URL is used to perform the Naw check through Idin.
idinCertificateCan 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

  • Callback: Set target and targetError URL parameter in step 1 and you can do the above GET when navigation will occur.
  • Webhook. You can set webhook URL parameter in step step 1 Result will be posted to the URL.
  • Polling: Repeatedly call the above collect-GET until the results contain a final result.
{
    "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"
}