Home

Product

The Account Direct Access API (ADAA) service provides secure access to information about:

• Client’s transaction history
• Bank account balance
• Information about transaction history is provided in connection with current accounts of a client of Komerční banka.

more details is on website Direct Account Access API

Enviroments

• For testing requests we recommend the application Postman

Sandbox

• Postman Sandbox collection
• Register on Sandbox API Portal

Production

• Postman [Production](./postman/KB API - Production - API Business suite.postman_collection.json) collection
• Register on production API portal

How to start

• swagger
• demo app

Process

Actors

• User - Client KB - User who give access to his account via API in Komercni banka
• Developer - Developer who create app
• KB - Komercni banka

1. Developer registers on production API portal

• create application
• subcribe to API (Client Registration, OAuth2, Adaa API)
• create API key (apiKey)

how create API key (apiKey)

2. Developer registers your application in KB

• Software Statement with qualified certificate issued by a trusted certification authority (I.CA, PostSignum)

3. Developer calls Application Registration OAuth2 in browser

• browser shows this page and gives control to KB

4. Client KB works in Bank - Register app

• Client KB continue to login to bank
• Authorize app
• Client KB choose accounts to API
• Bank transfer control back to app

5. Developer processes the application registration information

• decrypt on redirect_uri, you registered in Software Statement, we give you link to decrypt client_id, client_secret, application registration

6. Developer calls - Authorization code Tokens

7. Client KB works in Bank - Confirm apps scopes

• Client KB continue to login to bank
• Client KB confirms scopes
• Bank transfer control back to app

8. Developer processes authorization code

• change authorization code to refresh token and access token

9. Developer get - Accounts

• Accounts for account id to next step

Next endpoints

5. Account Balances
6. Transactions
7. Notification of changes to your account (webhook)
8. Account Statements - PDF

Recommendations for the user interface

• support for flow registration of the application by the user (each user needs only 1 application)
• support for token acquisition and renewal (once every 12 months or sooner)
• our demo app