Enable Finnish Bank ID in your services
The Finnish Bank ID consists a set of Finnish banks. These are:
Nets is an ID broker and offers all banks through our E-Ident/FTN service. Upon configuration you will be setup with all banks.
Read more about FTN
Information about the end user
|DOB||End user's birth date. |
|SURNAME||End user's surname.|
FI_SATU||Finnish unique identification number (sähköinen asiointitunnus). |
fi_ssn / ssn
FI_SSN||End user's Finnish personal identity code (henkilötunnus). Read more about
SSN handling. |
FI_TUPAS_BANK||The end user’s bank used in the identification process.|
fi_tupas_pid / pid
|FI_TUPAS_PID||Personal identifier set by Nets FTN. |
|GIVENNAME||End user's first/given name. |
Note: The name value is constructed of the
|FULLNAME||End user's full name|
|The organisation name connected to the user's legal person ID.
Read more. |
Handling of SSN
The social security number (SSN) of an end user can be returned if you are allowed to receive this. This will be determined when you enter into an agreement with Nets or the issuing bank. The SSN is returned as the
fi_ssn and ssn claim (if
ssn is part of
scope in OIDC identification request) or as
FI_SSN in the assertion (SAML).
Information about organisation
Some banks issues IDs to not only natural persons, but also to a legal person. To get information about the organisation affiliation, you need to either set the scope to organisation (OIDC) or append the returnorg=true parameter to the identification request. The name of the person's organisation and organisation number (VAT number) will be returned.
Bank ID dialogue
Step 1 (select bank - optional page):
The end user is directed to the bank's identification client. See each individual bank's look and feel when testing the service.
End user routed directly to the bank's client
The bank selection page in step 1 above can be skipped by appending the
forcebank parameter to the identification request. This can be used if you already know which bank the end user is using or to build your own bank selection page. Check the bank's web site to get correct logo or you may request the logos from
The Bank ID "step 1" page can be styled by overriding the Nets default style.
If needed, the different bank's logo can be found at these links: