Introduction


This document contains an overview of possible BankID error codes that may be display to end-users and/or is made available to merchants in their integration of BankID. The document is intended for the development and support organizations of banks and merchants to help dealing with customer incidents.
Note that a separate document [BSEC] provides an overview of error codes for supplementary BankID services.
Note further that error dialogues in the BankID Client, including those that contain display of error codes from this document, are described in the User Dialog Definitions for the netcentric client: [WEBUDD].
Lastly, in [BIKI], all known issues with the BankID solution are listed. This information is also available online at https://www.bankid.no/bedrift/utvikler/Kjente-feil-og-mangler--Known-issues/

Target audience

The target group of this document is customer support services at Banks/Merchants and developers integrating an application with BankID.

Acronyms

Acronym

Description

COI

Common Operational Infrastructure (a.k.a. FOI in Norwegian).

CORS

Cross-Origin-Resource-Sharing

HA

Norwegian for "HAVE" – something the user possesses which is used as a factor during a two-factor authentication. The legacy term "OTP" is replaced with "HA1". Second generation HAVE-factors are termed "HA2".

HAT

HSM Activation Tool, see HSM.

HSM

Hardware Security Module

ODS

Order Distribution System

OTP

One-Time Password, see also HA above.

SDM

Session Data Manager (a COI component handling initSession() request from Merchant)

VA

Validation Authority

XHR

Asynchronous HTTP Request

Referenced documents

Document Type

Name

Reference

Interface

BankID Interface Description, C Server

[ICSRV]

Interface

BankID Interface Description, Java Server

[IJSRV]

Interface

BankID Services Interface Description

[BSID]

User Dialog Description

BankID User Dialog Description Banklagret - Web-client

[ WEBUDD]

User Dialog Description

BankID User Interface BankID on Mobile

[ NUDD-M]

Error Codes

BankID Services Error Codes

[ BSEC]

Known issues

BankID Known Issues

[ BIKI]