Usage
Create an iDIN transaction with provider: nlIDIN and method: auth. You control what's asked for and how the bank-selection step looks; the rest of the flow happens on the bank's side.
Data requests
Request only the personal data you need, each as its own flag:
- Name — requested by default.
- Date of birth — requested by default.
- Telephone
- Address
- Gender
Each one is a simple on/off flag on the transaction. If you ask for none of the above, the user goes through a lighter-weight repeat identification rather than a full identification.
Age check
Instead of (or alongside everything else) you can ask the bank to confirm the user is at least 18, without disclosing their actual date of birth. The age check can't be combined with any of the data requests above: it's age check on its own, or the data requests above on their own.
Description and language
Set a short description (up to 35 characters) of what the identification is for; it's shown to the user on the bank's iDIN page. Defaults to the Dutch word for "identification". Set the UI language to Dutch or English; defaults to Dutch.
Preset bank
By default the user picks their bank from a list. If you already know which bank to use, set it directly and skip that screen: ABN AMRO, ING, Rabobank, ASN Bank, RegioBank, SNS Bank or bunq.
During the transition period, the bank-selection screen itself also offers itsme as an identification option, shown alongside the banks above. That's presented by the screen, not something you set: presetBank only covers the seven banks above, so you can't preset itsme directly. If a user picks it instead of a bank, they complete the identification through itsme behind the scenes, before control returns to your nlIDIN transaction as normal.
Completion data
Depending on what you requested, completion data can include the user's initials, legal last name (and prefix, for Dutch surnames like "de Vries"), date of birth, address, gender, phone, email and the age check result, alongside which bank authenticated them. See the API reference for the full list of fields.