Open Banking API

We will allow you to manage bank accounts in your accounting systems and other third-party apps.

Open
Banking
API

We will allow you to manage
bank accounts in your
accounting systems
and other third-party apps.

All communication is secured.

You can activate or deactivate the new services yourself in the MojeBanka app.

We provide third parties with integrated access to bank account information and payment initiation.

ADDITIONAL BENEFITS

  • We are going with the times and brining a new approach to account and card management.

USEFUL INFORMATION

Access to API payment services (PSD2) as of 13 January 2018

(1/2018)

Komerční banka will make it possible to use new indirect payment services through indirect payment service providers (so-called third parties) and provide (with the client’s consent) these third parties with information about its clients’ payment accounts. These services are available to third parties through a procedure known as “screen scraping” (machine reading of data from a screen). Third parties must register at the address api@kb.cz to make use of this services. They can also use this email address to submit technical questions about the new services.

We are already taking steps that will lead to the full support of KB Open Banking API, but neither the API Catalogue nor the test interface is available at this time. We will be providing information about the launch dates of the services and the API Catalogue on the KB website.

Announcement of the Ministry of Finance and the Czech National Bank of 1 December 2017 regarding the transitional period under Act No. 370/2017 Coll.

 

We have issued Exchange Rates in API

(11/2017)

Under the KB Open Banking API, Komerční banka provides a service for obtaining information about KB Exchange Rates through direct queries about resource exchange rates using the REST API service. This service makes it possible to acquire the below-specified information concerning KB CZ exchange rates. The service is displayed in the Open Data regime, which means that it is available to all users without prior registration.

The service contains the following data sources:

  • Current KB exchange rates – exchange rate information from the respective date or the latest exchange rates issued for the respective date.
  • Historical KB exchange rates – information about exchange rates from the specified date, up to three years retrospectively.
  • Current KB exchange rates for the selected currency – information for the defined menu from the respective date.
  • Historical KB exchange rates for the selected currency – information for the defined menu from the specified date, up to three years retrospectively.

Information provided through API KB are localised only into Czech.

Documentation concerning Exchange Rates in API.

API (Application Programming Interface) is an interface through which the secure exchange of information takes place between the bank and third-party apps. Komerční banka provides these basic categories of API services:

  1. Open data – accessible to all users without need for prior registration
  2. Payment services under the PSD2 regulation – AIS, PIS and CIS services provided to licenced third parties
  3. API partner services – provided based on registration at KB or on a contractual relationship.

Details about the scope of the information provided and complete documentation will be included in the API Catalogue, which is being prepared at this time.
 

1. Open data

Exchange rates

The service contains the following data sources:

  • Current KB exchange rates (of the respective day or from the last issued exchange rates as at the respective day)
  • Historical exchange rates (up to 3 years retrospectively)
  • Current KB exchange rates for the selected currency (from the respective date)
  • Historical KB exchange rates for the selected currency (up to 3 years retrospectively)

Documentation concerning API exchange rates can be found here.

 

2. Payment services (PSD2)

In 2018, Komerční banka will begin providing new services in the area of the secured exchange of banking information with third parties based on Act No. 370/2017 Coll., on the Payment System, which entered in force on 13 January 2018. We are thus joining the ranks of Czech and European banks required under the updated European Payment Service Directive (PSD2) to provide these new services. The new services are intended for so-called third-party apps, which can be used by clients with accounts at Komerční banka who have at least one direct banking channel.

The services will be provided via API, through which secured communication and online exchange of data will take place. Komerční banka will support the Czech Standard for Open Banking, which was prepared by the Czech Banking Association.

The provision of the new services is free of charge, and account transactions are charged according to the KB Fee Schedule as online banking payments. Technical documentation concerning API services will be made available during the first half of 2018 through the API Catalogue, which is being prepared at this time.

We will inform clients of the launch dates of the various services on the KB website.

Provision of a client’s account payment information and account payment history (AIS)

If a KB client requests that data about his/her account be made accessible to a third party and confirms this request in the MojeBanka app, the bank will provide this third party (provided it deems this third party credible) with the requested information via the REST API. An example of a third party is an e-shop that allows a client to check the balance of his/her account online for online purchases.

If a client has more than one account at KB, he/she grants consent to one or more accounts under the consent procedure.

The information provided with respect to the chosen accounts includes the following:

  • Transaction history for a specified period
  • Balance
  • List of the client’s accounts

Details of the scope of the information provided and complete documentation will be included in the API Catalogue, which is being prepared at this time.

Making payments from a KB account via third-party apps (PIS)

If a KB client requests the activation of the service and confirms the request in the MojeBanka app, the bank will allow him/her to make payments from his/her KB account through third-party apps (provided it considers the third parties credible) via the REST API. The bank’s client signs in and authorises payments via standard KB methods. At the same time, he/she has the possibility to set up special payment limits for payment via third-party apps.

Details of the scope of the information provided and complete documentation will be included in the API Catalogue, which is being prepared at this time.

Provision of information about sufficient funds on a client’s account (CIS)

If a KB client requests activation of the service and confirms the request in the MojeBanka app, the bank will allow third parties (if the bank considers them credible) to make queries via the REST API about whether the client has sufficient funds on his/her payment account. The third party will make a query about a specific amount, and the bank’s response will either be positive or negative, depending on whether the client has sufficient funds on his/her account. The bank will not provide information about the exact balance under this service.

Details of the scope of the information provided and complete documentation will be included in the API Catalogue, which is being prepared at this time.

 

3. Partner services

At this time, we do not provide any such API services. If you would like to begin cooperation with us in the fields of new API services, please contact us at api@kb.cz.

Clients have control over third-party access to their accounts

All utilisation of access services to a banking client’s account must be explicitly permitted by the client. The client can also revoke this consent at any time via the MojeBanka app or through the Contact Centre (Direct Banking Help Line). For payment authorisations, the client uses standard KB methods that meet the strictest security requirements.

We require third parties to have a Czech National Bank licence

Third parties can either be banking or non-banking institutions that have obtained a licence to make use of API-related services from the Czech National Bank. If a third party does not present this licence to the bank, we will not allow it to use any API services on our clients’ accounts.

We verify technical and security conditions with respect to third parties and check them on an ongoing basis

All third parties that will be making use of AP payment services will be checked by Komerční banka as to whether they meet both the security and technical conditions for connection. At the same time, third parties will always have to identify themselves with valid certificates (electronic seals), which guarantee their identity. Should we suspect a third party of fraud, we will immediately bar it from using API services.

Komerční banka will bring the API Catalogue online in the first half of 2018.

We are already taking steps leading to the full support of the KB banking API, but neither the API Catalogue nor the test interface is available at this time. We will be providing information about the launch dates of the services and the API Catalogue on the KB website. The catalogue will contain complete technical documentation that will allow third parties to connect to Komerční banka’s systems, including the test interface.

Komerční banka will support the Czech Standard for Open Banking while observing the Announcment of the Ministry of Finance and the Czech National Bank dated 1 December 2017 for the transitional period under Act No. 370/2017 Coll., on the Payment System, regarding the possibility of indirect payments and disclosure of account payment information to third parties. It will allow the use of the new service of indirect payments through third parties and provide (with the client’s consent) these third parties with information about its clients’ payment accounts. Third parties can utilise this services via “screen scraping” (machine reading of data from a screen). To utilise this new service, third parties must register on api@kb.cz. They can also use this e-mail address to submit technical questions concerning the new services.

1. What will PSD2, or the updated Payment System Act, bring?

In 2018, Komerční banka will being providing new services in the area of secured exchange of banking information with third parties based on Act No. 370/2017 Coll., on the Payment System, which entered into force on 13 January 2018. We are thus joining the ranks of Czech and European Banks required under the updated European Payment Service Directive 2 to provide these new services. The new services are intended for so-called third-party apps, which can be used by clients with accounts at Komerční banka who have at least one direct banking channel.

2. What are third parties?

Third parties can be banking or non-banking institutions that have obtained a licence to use API-related services from the Czech National Bank. If these third parties do not identify themselves with such licence to the bank, the bank will not allow them to use the new services on KB client accounts. Typically, third parties will be other banks, e-shops, accounting firms, banking service aggregators etc.

All third parties interested in providing their apps to KB clients and using the KB API will always be checked whether they fulfil security and technical conditions. At the same time, third parties will always identify themselves with a certificate (electronic seal) that will guarantee their identity. Should Komerční banka suspect a third party of fraud, it will immediately block it access to the KB API.

3. What are third-party apps?

These are apps that have access to banking clients’ accounts even though such apps are not banking apps. The bank only provides information from the account of the respective client and sends it (with the client’s consent) to the third party, which then utilises it.

4. What services will Komerční banka provide?

Provision of a client’s account payment information and account payment history

If a KB client requests that data about his/her account be made accessible to a third party and confirms this request in the MojeBanka app, the bank will provided this third party (provided it deems this third party credible) with the requested information via the API, and the third party will then use it in its app. Typically, the third parties (even banks) will be those that aggregate/collect information about all accounts from various banks in one location, e.g., in the online banking of one bank.

If a client has more than one account at KB, we will allow him/her to permit the service for only those accounts he/she chooses. The scope of the information provided from the specified accounts include: transaction history for a certain period, account balance (currently available balance and current balance, including permitted debit), and a list of the client’s accounts. Details about the scope of information provided will be included in the API Catalogue section on the KB website.

Making payments from a KB account via a third-party app

If a KB client requests the activation of the service and confirms the request in the MojeBanka app, the bank will allow him/her to make payments from his/her KB account through third-party apps. The client will always authorise the payment through the KB MůjKlíč app. The client will choose a special limit for payments made through third-party apps.

This service can be utilised by, for example, e-shops, which will allow a client to pay for a purchase from his/her bank account directly from their website.

Provision of information about sufficient funds on a client’s account

If a KB client requests activation of the service and confirms the request in the MojeBanka app, the bank will allow third parties (if the bank considers them credible) to make queries via the KB API about whether the client has sufficient funds on his/her payment account. The third party will make a query about a specific amount, and the bank’s response will either be positive or negative, depending on whether the client has sufficient funds on his/her account. The bank will not provide information about the exact balance under this service.

The third party will typically be an independent issuer of a means of payment, such as a commercial chain that issues to its clients/customers a means of payment tied to the payment account maintained at the bank. This provider will then make a query about the funds on the client’s account maintained at the bank. Should there be sufficient funds on the account, the provider will pay for the purchase on behalf of the client and then claim the funds from the client in a special way, such as by invoicing, collection, etc.

5. Will a fee be charged for the new services?

The new services are free of charge, and account transactions are charged according the KB Fee Schedule as online banking payments. For payments made through third parties, the agreed Individual Fees for the Internet will apply.

6. Will using the new services be secure?

We pay great attention to security! If a KB client requests a service, he/she will have to first allow it via the MojeBanka channel. A client can revoke consent to a service at any time via the MojeBanka app or, should the app not be accessible, at the Contact Centre (Direct Banking Help Line).

To authorise payments made through third-party apps, KB clients will use the new KB MůjKlíč app, which will be installed on their smart phone.

7. What is API?

For third-party apps, Komerční banka will provide information via the API (Application Programming Interface), through which secure communication and online exchange of information will take place. Komerční banka will support the Czech Standard for Open Banking, which it helped created with other banks in the Czech Banking Association. A detailed description of the interface for developer will be provided in the API Catalogue when issued.

8. When will the KB API Catalogue be available?

We are already taking steps leading to the full support of the KB banking API, but neither the API Catalogue nor the test interface is available at this time. We will be providing information about the launch dates of the services and the API Catalogue on the KB website. We expect this to be in the first half of 2018. The portal will contain complete technical documentation that will allow third parties to connect to Komerční banka’s systems, including the test interface.

Komerční banka will support the Czech Standard for Open Banking while observing the Announcment of the Ministry of Finance and the Czech National Bank dated 1 December 2017 for the transitional period under Act No. 370/2017 Coll., on the Payment System, regarding the possibility of indirect submission of payment orders and disclosure of account payment information to third parties. It will allow the use of the new service of indirect payments through third parties and provide (with the client’s consent) these third parties with information about its clients’ payment accounts. Third parties can utilise this services via “screen scraping” (machine reading of data from a screen). For third parties to utilise this new service, they must register on api@kb.cz. They can also use this e-mail address to submit technical questions concerning the new services.

9. What will KB allow as of 13 January 2018 once the Payment System Act enters into force?

Screen scraping

Komerční banka will make it possible to use new indirect payment services through indirect payment service providers (so-called third parties) and provide (with the client’s consent) these third parties with information about its clients’ payment accounts. These services are available to third parties through a procedure known as “screen scraping” (machine reading of data from a screen). Third parties must register at the address api@kb.cz to make use of these services. They can also use this email address to submit technical questions about the new services.

Announcment of the Ministry of Finance and the Czech National Bank of 1 December 2017 on the transitional period under Act No. 370/2017 Sb.

Exchange rates in API

Under the KB Open Banking API, Komerční banka provides a service for obtaining information about KB Exchange Rates through direct queries about resource exchange rates using the REST API service. This service makes it possible to acquire the below-specified information concerning KB CZ exchange rates.

The resource for obtaining information from the exchange rate table provides:

  • Current KB exchange rates – exchange rate information from the respective date or the latest exchange rates issued for the respective date.
  • Historical KB exchange rates – information about exchange rates from the specified date, up to three years retrospectively.
  • Current KB exchange rates for the selected currency – information for the defined menu from the respective date.
    • Historical KB exchange rates for the selected currency – information for the defined menu from the specified date, up to three years retrospectively.

Information provided through API KB are localised only into Czech.

Exchange rates in API.