Introduction 

The target audience of this document is the consumers of the Nordea e-identification service from the Open Banking Initiative (OBI). The purpose of this document is to describe the implementation required in the consumers' apps, on top of the regular e-identification service integration, for enabling the app switch from Nordea e-identification service to the authentication apps and back to the consumer app. Authentication apps in this context are Nordea ID and Swedish BankID. Note, that this integration is required only from the native applications. 

The app switch is triggered by the end-user by selecting the App Switch Button from the polling screen of the Nordea e-identification service. The App Switch Button is the "Open" button illustrated in the picture below.

The App Switch Button for Nordea ID

Implementation inside WebView 

Nordea ID

Implementation of app switch for Nordea ID inside WebView requires URL interception. 

Open button calls Nordea ID scheme URL. In the WebView this URL should be intercepted and the action should be passed on. 

nordeamta://confirm?returnUrl=null 

 
Return URL can be also modified to point back to calling applications after the interception. 

The value must be URL encoded. Note: For Android, returnUrl should be left as null.

nordeamta://confirm?returnUrl=[RETURNURL]  

BankID on mobile

Implementation of app switch for the Swedish BankID inside WebView requires URL interception.

WebView needs to intercept this URL:

bankid:///?autostarttoken=[token]&redirect=null 

Token value is already added to the call. And to support switching back, the URL encoded application link should be placed in the redirect value. Note: For Android redirect, the value should be left as null.

BankID also supports universal/app links for iOS and Android 6+ Chrome and should be treated the same way in WebView.

https://app.bankid.com/?autostarttoken=[token]&redirect=null

Information and support

In problem situations call the E-support for corporate customers on banking days:

• In Finnish: 0200 67210 (8-17), local network charge/mobile call charge or international call charge
• In Swedish: 0200 67220 (9-16.30), local network charge/mobile call charge or international call charge
• In English: (+358) 200 67230 (9-17), local network charge/ mobile call charge or international call charge

Giving your customer ID speeds up service.