iDIN Age in the Netherlands is an age verification service by a standard bank login process. The process uses the bank for user age verification purpose only.
POST to https://env
.zignsec.com/v3/eid/idin/age
env
is API or test
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. |
idinCheckUrl | Idin Check URL is used to perform the 18+ check through Idin. |
idinCertificate | Can be used to verify the Idin check. |
{ "id": "7e68465a-11cd-4f11-a111-8b069810f7ee", "state": "WithoutIdinCheck", "errors": [], "idin18Plus": false, "idinCertificate": "", "idinCheckUrl": "https://idin.cddn.nl/prod?uid=C391BAF6-9894-4A1B-98B5-E83612587A4E&callback=https%3a%2f%2fdev.zignsec.com%2fv3%2fcallbacks%2fidin%2fage%2fe3d89066-dbde-49b7-a5c1-14ce746298ce" }
GET to https://env
.zignsec.com/v3/eid/idin/age/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": "7e68465a-11cd-4f11-a111-8b069810f7ee", "state": "Finished", "errors": [], "idin18Plus": true, "idincertificate": "TRANSOhw1Bi1eAk1mtDl7BiosiUXDwvnZ/m4SQ1ouEvo1j0ZO111RsV1VGha7coP/H4cBi+e/CN1hBOK0osk1YOgUBw==" }