Contents
| Table of Contents |
|---|
Introduction
This page contains an overview of possible error codes that may be display to end-users during usage of the BankID OpenID Connect provider. The document is intended for the development and support organizations of banks and merchants to help dealing with customer incidents.
The error codes are grouped according to their source of origin, and divided into a set of categories. Note that the collection of error codes presented by this service is a combination of
- special error coded codes associated to this OpenID Connect provider
- common BankID error codes originating in the common BankID components and infrastructure
Overview
Error codes are grouped according to their source of origin and/or type of error based on the first digit(s) of the error code.
| Prefix | Description | |
|---|---|---|
| D or no prefix | Errors originating in the OIDC web client or related to the OIDC platform in general | |
| C | Errors related to BankID on mobileX | |
| Errors related to xID | S | Errors related to signing |
...
| ID | Category | End user message | Actions available | ||||
|---|---|---|---|---|---|---|---|
| 1_GEN | Generic | Det har oppstått en feil Vennligst prøv igjen. Skulle feilen vedvare, ta kontakt med banken som har utstedt din BankID og oppgi følgende kode: OIDC-$ An error has occurred Please try again. If the error continues to occur, please contact the bank that has issued your BankID and refer to the following code: OIDC-$ | Shows a button that tries to reset the error state and re-start the session. | ||||
| 2_API | API error Errors related to API returning error or bad data | Det har oppstått en feil Ta kontakt med banken som har utstedt din BankID, og oppgi følgende kode: OIDC-$. An error has occurred Please contact the bank that has issued your BankID, and refer to the following code: OIDC-$. | Shows a button that tries to reset the error state and re-start the session. | ||||
| 3_COM | Communication error Error connecting to API, networking issues | Det har oppstått en kommunikasjonsfeil Dersom feilen vedvarer ta kontakt med banken som har utstedt din BankID og oppgi feilkode OIDC-$. A communication error has occured. If the error continues to occur, please contact the bank that has issued your BankID, and refer to the following code: OIDC-$. | Shows a button that tries to reset the error state and re-start the session. | ||||
| 4_BIMIN | BIM initialization error Error while initializing BankID on mobile | En prosess finnes fra før. A process is already running. | Shows a button that tries to reset the error state and re-start the session. | ||||
| 5_BIMREF | BIM reference error Error during BankID on mobile reference step | Det har oppstått et tidsavbrudd A timeout has occurred. | Shows a button that tries to reset the error state and re-start the session. | ||||
6_UNREC | Unrecoverable error Error shown after getting into an unrecoverable error state | En feil har oppstått An error has occurred | Shows a button that will cancel the session and try to redirect to cancellation endpoint. | ||||
| 7_SKIP | Unrecoverable error (skip) Returns to cancel authentication immediately due to critical error | None. User is immediately redirected back to cancelAuth endpoint. | 8_XID | XID error Shows an XID styled error page | Det har oppstått en feil An error has occurred | Shows a button that tries to reset the error state and re-start the session. | |
| 9_CAS | Cookie Activation Service | None. User is immediately redirected back to cancelAuth endpoint. |
...
C - errors related to BankID on mobile
| Info |
|---|
| For action/solution on to any BankID on mobile related errors, see https://confluence.bankidnorge.no/confluence/kiev-open/bankid-error-codes/errors-related-to-bankid-on-mobile-i-e-sim-cxxx |
...
| Code | Category | Description |
|---|---|---|
| C293 | 4_BIMIN | Another BankID on Mobile session has already started towards the same phone number. |
| C131 | 4_BIMIN | A process is already running at this telephone number. |
| C302 | 5_BIMREF | Timeout from the mobile service provider. |
| C* | 1_GEN | Any other BIM related error. |
...
| Code | Category | Description | Action/solution |
|---|---|---|---|
| S100 | 1_GEN | Cannot start signing, order not found | Cannot find signing order. Make sure that documents are uploaded and signing order is embedded with the authentication request. |
X - errors related to xID
| Code | Category | Description | Action/solution |
|---|---|---|---|
| X100 | 8_XID | Communication problem towards xID core | Communication problem towards xID service. Contact BankID support. |
| X102 | 8_XID | xID session was terminated | Problem with xID session. Try again or if the problem persists contact BankID support. |