Prerequisites

API Access

The nrich API uses HTTP Basic Authentication with two credentials:

• Client ID (username) and
• Client Secret (password)

Each set of credentials is associated with specific access scopes that define your permissions on the nrich platform. Contact us to obtain your dedicated credentials.

Postman Collections

We recommend downloading our Postman Collections to simplify your integration through our pre-configured API requests, allowing you to test endpoints instantly without any manual setup.

Getting Started

Before implementation, review our Widget Integration Guide for best practices and setup instructions.

Overview

Our Multibanking product allows customers to offer end users a connection of all their financial accounts in one place, unlocking hyper-customized offers by receiving detailed real-time data on the spending habits of users across all of their bank and other financial accounts. By harmonizing and aggregating transaction data across all bank and other financial accounts, customers can provide valuable insights to their end users about their spending behaviors, prevent users from payment defaults and unnecessary overdrafts, or offer valuable financial products.

Connectivity via the nrich API

The nrich API provides connectivity to several countries and offers access to a variety of account types, enabling you to access a wide range of financial data. Here's a breakdown of the supported countries and available account types:

Supported Countries:

• Germany
• Austria
• Spain
• Portugal
• Romania

Available Account Types:

📘

Please note that the availability of account types may vary by country.

Payment Accounts: These are standard current or checking accounts used for day-to-day financial transactions.

(Daily) Savings Accounts: These accounts offer a safe place to save money and often provide interest on the deposited amount.

Depot Accounts: Depot or investment accounts are used for managing securities and investments, allowing you to track and manage your holdings.

Credit Cards: Access credit card account information, including balances, transaction history, and credit limits.

Loans: Retrieve information about loans, including outstanding balances, repayment schedules, and interest rates.

Insurances: Access data related to insurance policies, providing valuable insights into coverage and premiums.

How it Works

You can find a step-by-step description in the Implementation Guide.

Data-Access Types

Ongoing Account Access

Ongoing account access is normally used whenever customers want to access information over a period of time.

In case of ongoing account access, Qwist automatically adds new connected bank accounts to a background service that runs an automatic synchronization process (“autosync”) up to 4 times a day until the Consent of the user expires (usually after 180 days). This allows the customer to fetch updated financial data for its users up to 4 times a day from Qwist’s database without any interaction their side. After max. 180 days the consent of the user expires and they need to renew the consent by providing a Second Factor for Strong Customer Authentication (SCA), e.g. a TAN.

In order to activate the autosync, the users must save their credentials during the login process. This is done via a checkbox on the Widgets UI or by setting the save_secrets parameter to true in the Ongoing access API call. The credentials are stored in an encrypted database that can only be accessed and decrypted by the nrich API when communicating with the banks.

Qwist will not delete any financial data of the end user until the customer has sent a DELETE request via the nrich API.