Account Information Service (Single Access)

Summary

Account Information Service (AIS) 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 to a bank via our SignIn Widget. Upon successful login, the widget returns the session information needed to start the import via our API.

Single access lets you get the data just one time, right after the user authorizes the action.

Integration

To integrate AIS in the Single access mode into your process you will need to:

  1. Get API access
  2. Get your Client ID from Insight, generate API key(s) and whitelist your server(s)
  3. Embed our SignIn Widget on your website
  4. Configure the Widget parameters and handle necessary Widget callbacks
  5. Create a connection between your frontend and backend to pass session information from the Widget to your servers
  6. In your backend, integrate with the Default Import command and Get Import Result endpoint
  7. (optionally) Integrate with Analytical Services endpoints
  8. Save the data from our API

Sample process flow

  1. A user visits your website, fills in a form to start your process
  2. You assign ownerExternalId, a unique identifier to the user, and show the SignIn Widget to the user
  3. The user goes through the bank authorization
  4. onSuccess callback is triggered - you can pass the received session information to the backend and redirect the user to another step in your process
  5. On the backend, you send a request to import the data with the session information to the Default Import endpoint
  6. You receive a command ID that you can now use to periodically (once every 2-5 seconds) ask for the import status via Get Import Result endpoint
  7. At this point the user’s participation has ended, and you can inform them that they will be notified later about the result of the bank verification
  8. Once all data is imported, you will receive it as a response of the Get Import Result import alongside a “successful” status - you should now stop calling that endpoint and save the response with the data to your server
  9. (optionally) Make requests to our Analytical Services endpoints to fetch extra insights into the owner’s finances
  10. Inform the user about the status of the verification or your decision regarding the user’s application

Important information

Coverage and data scope

We support major banks in many countries and we’re ready to add more depending on the demand. In those banks the basic data scope includes:

Each bank is different and offers a different set of details. You can check our Coverage to find which banks we support and what data scope they offer.

Transaction history

In each bank we’re able to fetch a different scope of history in terms of the timespan when the transactions were made. In some banks it can be 10 years, 4 years, 1 year or just 90 days.

Typically, we recommend importing 90 days of transactional history, up to a 1 year, due to general availability and the time it takes to download the data.

However, you need to remember that fetching more than 90 days requires additional setup due to Strong Customer Authentication implemented by banks: Getting more than 90 days of data.

Auto import

It’s possible to use Single Access without integrating with our API. It requires a minimal setup from your side. Please see this article for details.

Best practices

To improve your conversion and make the process better for the users, you can implement the following:

Provide an extensive description of what the widget does, its benefits and explain why it is safe.
Make the widget a separate step in the application process to allow the user to focus solely on it.
Allow users to continue filling the application when the import takes place.
Use gzip encoding in your HTTP requests to download data faster.
Remember to save responses from SignIn Widget and Kontomatik API, especially identifiers such as sessionId, in order to easier identify issues that arise. We also recommend saving your own requests you make to our API.

Documentation

For technical documentation, refer to our unified documentation that offers comprehensive support for customers integrating with AIS services, our PDF parser, and Data Analysis solutions. Discover detailed guidance on seamless integration with Kontomatik services and explore their full range of capabilities.

Contact

Sales

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

Technical Support

Do you have technical questions about our services or API integration?