Overview

The Widget is a white-label user interface designed to simplify the integration of the nrich API.
It guides users through the entire process of connecting bank accounts or initiating payments,
providing seamless access to the financial data and enrichments that are important to your business.
By using the Widget, you can reduce the integration complexity to just three API calls.

Use Case-Specific Flows

To initiate the Widget, you first need to create a Widget Link through one of the use case-specific
endpoints. This step allows you to configure various aspects of the user journey. Currently, the
following endpoints are available:

POST /onetime/access for one-time account access
POST /ongoing/access providing ongoing account access
POST /onetime/payment to initiate a one-time payment
POST /ongoing/payment for ongoing payment initations

Authentication and Authorization

Banks enforce Strong Customer Authentication (SCA) to ensure that financial data access is granted
solely by the user. The Widget supports multiple SCA flows, including various authentication methods
(such as photoTAN, flickerTAN, and appTAN), eliminating the need for manual frontend implementation.

Widget Customization and Integration

The Widget's fully responsive UI can be customized to seamlessly integrate with your application's
look and feel. This flexibility enables integration into both web and mobile applications, adapting
to diverse screen sizes and device types. Two integration options are available:

OAuth Protocol (recommended)
- Ideal for mobile and hybrid mobile/web applications
- Provides secure, standardized authentication
iframe Integration
- Designed specifically for web applications
- Enables smooth, embedded user experiences

For detailed best practices and implementation guidance, please refer to our comprehensive
Widget Integration documentation.