Own list for bank selection

Kontomatik offers a solution where you can create your own frontend for the list of banks instead of users selecting a bank in our SignIn Flow. To implement this, you simply need to pass the selected bank identifier to the SignIn Flow parameters.

However, please note that this solution has some limitations. You will not have control over the subsequent verification steps, as they must remain unchanged for security and compliance reasons.

Obtaining a List of Enabled Banks

To obtain a list of enabled banks and their identifiers to be passed to the SignIn Flow, we provide the AIS Catalog command.

The response returned by the /catalog.xml command will contain all currently available targets, along with information about the currently used interface type, a list of available commands, and other relevant information. In our case, we are particularly interested in the name and institution attributes, which are necessary to identify the bank and check the currently used interface. This information is essential for passing the appropriate values to the SignIn Flow.

Identifying the target and institution

Using the institution attribute, you can identify the bank that your customer will be using. For example, the value could be “KontoBank”. Then, you need to check the value available in the name attribute, which indicates the currently used interface. In this case, it could be the value “KontoBankApi”. This value should be passed as the target in the SignIn Flow parameters.

The next time you run this command, the institution will be still showing “KontoBank”, but it might happen that the target got switched to another type, for example, the fallback interface, and this time the attribute name has a value of “KontoBank”. In this situation, the value passed as the target SignIn Flow parameter will change to “KontoBank”.

You can use the institution information to map the bank logo and bank name. The institution name won’t change when we switch targets within. You can also implement a verification mechanism to alert you if a new institution appears in the Catalog response or if there’s a missing one.

Example

As an example, let’s say that you’ve made a command catalog request and received a response that contains the following snippet:

<target country="pl" name="MBankApi" institution="MBank" officialName="mBank" officialUrl="https://www.mbank.pl" psd2="true">

In this case, you should identify the bank using the institution field, which is “MBank”. And then, you should pass the name value, which in this case is “MBankApi”, to the SignIn Flow in order to proceed with verification.

For the SignIn Widget, the code should look like this:

embedKontomatik({
client: 'YOUR_CLIENT_ID'
divId: 'kontomatik',
target: 'MBankApi',
...
});