Deeplink issues when opening itsme

You have integrated itsme in your application but when you try to open the itsme app, it doesn’t work. You stay in browser when you expect the itsme app to be opened.

Is the itsme URL opened inside a webview?
No ↓	Yes → Always open the itsme URL in the default browser app. Deeplinks do not work reliably inside webviews.
Send yourself the exact itsme URL by email, open it on mobile and tap it. Does the itsme® app open?
No ↓	Yes → The itsme URL is correctly constructed. Review your implementation for opening this URL with the default browser.
When the itsme URL is loaded in the browser, do you see page redirects?
No ↓	Yes → This should not be the case. Please review the implementation with the itsme support team.
Does the issue occur on every device (both iOS and Android)?
Yes, both ↓	Only one → Review most common issues here.
Please review the itsme URL you construct and make sure it follows the guidelines and applies correct encoding.

Deeplink issues when opening your app

When the flow at itsme side is finished, you expect your app to open but this does not happen.

Do you stay in the itsme® app while you expect your webpage or mobile app to open?
No ↓	Yes → Does this occur on every device (iOS and Android)? If yes, review with itsme support whether your `redirect_uri` is correctly configured. If only one platform is affected, review most common issues here.
Are you testing with one device (itsme app + your app installed) or with two separate devices?
1 device ↓	2 devices → Implement a fallback webpage as described here.
The URL opens in the default browser but does not open your app. Look at the URL in the browser searchbar, is it correctly constructed as you expect?
Yes ↓	No → Please review with itsme support whether your `redirect_uri` is correctly configured.
When your URL is opened in the browser, do you see page redirects happen?
No ↓	Yes → Review your implementation and avoid intermediate redirects before the final deeplink URL. Also ensure your redirect URL is a valid page (no HTTP 404 redirect flow).
Send the redirect URL to yourself by email, open the email on your mobile device and click on the URL. Does your app open?
Yes ↓	No → Please review your AASA / `assetlinks.json` configuration.
Does the issue occur on every device (both iOS and Android)?
Yes, both ↓	Only one → Review most common issues here.
Please contact itsme support for further investigation.