Bank API

Summary

The Banking API allows importing data from the end-user account from any supported bank to your system. In order to do that, the user has to log in into a bank via our SignIn Widget. Upon successful login, the widget returns the session information needed to start the import via our API.

Banking API can be nicely complemented by our Data Science solution which provides you the most fitting set of features, scores, labels, percentiles and tiers, that you can add as extra data points in your scoring model and observe the uplift on your scoring model performance.

SignIn Widget

In order to achieve this, the end-user has to log in to their bank using the Kontomatik SignIn Widget which is a front-end website widget that works on desktop and mobile.

In the first step, the end-user chooses their bank from the list. Next, they have to agree to the terms and conditions for Kontomatik to be able to act as an intermediary in the data sharing process. In the end, they are redirected to the bank page through which they have to log in and choose the accounts they wish to share.

If the process is successful, the widget creates a session that is required for Banking API to work.

Sample workflow

To integrate with our service and make the API ready for importing you need to

  1. Get Client ID, whitelist your IP and generate API keys
  2. Embed the SignIn Widget on your website
  3. Handle the necessary Widget callbacks
  4. Integrate our API endpoints to your pipeline
  5. When the user successfully logs into a bank, the widget will return the session data
  6. Pass your API key and the session data to the API endpoints
  7. Poll our API for the status of the import
  8. When the status is successful, get the data
  9. (Optional) Request for Kontomatik Score
  10. Done

Default vs Advanced import flow

After the end-user logs in you get the session parameters from The SignIn Widget that you can use to perform an import. There are two ways in which you can do it:

We highly recommend using the Default import as it’s easiest to integrate with. If you plan to use Advanced version to get all the data, you need to consider that the import will be slower, it’s easier to make an integration mistake, and you can’t mix it with the Default version.

Supported banks and features

Kontomatik Banking API supports major banks in many countries and we’re ready to add more. Additionally in Poland we also offer a PDF Parsing API. On top of that, both APIs come with extensions adding high-level analytics and transaction labels to the raw data extracted from online banks or the PDF statements. To help you get to know our full capabilities we’ve prepared a spreadsheet containing:

Go to Kontomatik Services & Coverage table »

Best practices

We believe that you can make the experience of using the widget by the end-users even more pleasant and easy. Therefore, we’ve prepared the following set of guidelines that aim to achieve this objective:

  1. Provide an extensive description of what the widget does, its benefits and explain why it is safe.
  2. Make the widget a separate step in the application process to allow the user to focus solely on it.
  3. Consider making Kontomatik the primary scenario/path in your loan application process.
  4. Allow users to continue filling the application when the import takes place.
  5. Use gzip encoding in your HTTP requests to download data faster.

FAQ

The Banking API allows you to import data from the end-user account from any supported bank to your system. To do that, the user has to log in to a bank via our SignIn Widget. The widget is provided along with the API. To find out more about the widget please refer to widget section of the technical documentation here ».

After the end-user logs in you get the session parameters from The SignIn Widget that you can use to perform an import. There are two ways in which you can do it:

  • Using Default import flow that downloads all available data with a single command
  • Using Advanced import flow to get only information that is necessary to you.

We highly recommend using the Default import as it’s easiest to integrate with. If you plan to use Advanced version to get all the data, you need to consider that the import will be slower, it’s easier to make an integration mistake, and you can’t mix it with the Default version.

You can find the features table here »

Kontomatik Banking API supports major banks in many countries and we’re ready to add more. Additionally in Poland we also offer a PDF Parsing API. On top of that, both APIs come with extensions adding high-level analytics and transaction labels to the raw data extracted from online banks or the PDF statements. To help you get to know our full capabilities we’ve prepared a spreadsheet containing:

  • covered countries, APIs and analytics products,
  • detailed list of integrated banks with features such as credit cards or type of accounts,
  • matrix of data possible to fetch from each bank,
  • supported banks via PDF parsing API,
  • list of available test accounts for Banking API.

Go to Kontomatik Services & Coverage table »

In some banks we do support corporate accounts. These banks will be tagged accordingly in the coverage table here », under the “Supported accounts” column.

However, please note that in most cases access to the account via PSD2 channels is blocked by default and any attempts to go through the Kontomatik process will result in an error on the redirection page. We have no control over this, nor do we get any feedback from the bank why an error occurred.

In such cases please inform the end-user that this option needs to be enabled in the online banking system - usually by a person with the highest access control, typically the account holder (owner or president of the company, CFO etc.).

This feature might be named differently in banks, but we’ve seen options such as “PSD2 consent” or “AIS / PIS / CAF access”.

The PSD2 directive specifies what type of data should be shared by banks. Nevertheless, banks may interpret the specific rules differently and as a result, share more or less data than necessary. As for Kontomatik, if it’s available via banking API, we support accessing:

  • bank account’s owners and co-owners*
  • bank accounts list
  • transactions for the selected bank account and period
  • credit cards’ details**
  • money transactions associated with a given credit card**

*Please note that each bank may share different details about owners. You can find the scope for each bank here ».

**Importing credits cards is only available in Poland and Spain in selected banks.

See all FAQs

Documentation

Banking API

Read-only API to banks. Import all data from any supported bank into your system.

Open
Parsing API

PDF parsing API enables checking PDF statements against tampering attempts.

Open
Zero-integration solution

Easy integration with access to data via Customer Platform.

Open

Contact

Sales Contact

Do you need help in explaining our products, costs, and cooperation?

Contact our Sales team
Support Contact

Do you have technical questions about our products and services?

Contact Support