The aggregation widget allows to import personal data, account balances, and full statements from any supported bank into your system. In order to do that, the aggregation widget requires end-user bank credentials (i.e. a bank login and password). Asking the end-user for their credentials may not be very convenient, hence we are offering a widget that can be embedded on your website as an HTML5 iframe.
The aggregation widget handles bank credentials, ensuring that sensitive information will never pass through your servers, thus greatly reducing security risks. The widget supports many unusual login scenarios (e.g. masked passwords, hardware tokens, SMS codes, CAPTCHAs, multiple login paths, etc.) and supports all edge-cases of invalid credentials, blocked accounts, expired sessions, etc.
<div id=”nordigen-widget” />element where you want the widget to be rendered, referencing the specified id;
instantiateNordigen()JS function, specifying the
nordigenId can be received from Nordigen API Dashboard as the
|divID||Element where the Nordigen widget will be rendered in|
|country||Origin country of the end-user bank|
|nordigenID||The client ID which can be found in the Dashboard|
|operations||Defines which products to apply to input data; multiple products can be requested at the same time. If the operations parameter is omitted, all products ('categorisation', 'kyc', 'income', 'loans', and 'risk') will be used||Yes|
|widgetTest||Use the value 'true' to use dummy data. Contact support for dummy credentials||Yes|
|locale||Widget interface language: contact our support for more info||Yes|
|importPeriod||Allows to specify the import period for transaction data||Yes|
Add a message listener to your window object to receive the
request_id, you will receive the
error from failed connections in the message listener.
After successful call from Emb.JS library, you will be receiving
event.data parameter that can be used to receive analysis results via GET result API call.
|Error Key||Error Description|
|NETWORK_ISSUE||Unable to get data due to network issues at the bank or between TPP and the bank|
|SESSION_ERROR||Session has been expired or session limit is exceeded|
|UNKNOWN_ERROR||An unknown error, requires investigation by Nordigen|
|AGGREGATOR_ERROR||Unhandled condition occurred by aggregator|
|ACCESS_BLOCKED||Access to the account is blocked|
|MANUAL_REQUEST||User needs to perform actions inside his online bank|
|INVALID_CREDENTIALS||Invalid credentials provided by the user|
|UNSUPPORTED_LANGUAGE||The language of the bank UI is not supported|
|AUTH_INTERRUPTED||The authentication process has been interrupted by an external factor or agent|