Browse the available APIs
Create an account
Creating an account is free. Click "Create an account", then enter your name, email address, consumer organization, and password. We'll then send you an email with an activation link. Click the link, and you'll be ready to start developing.
Create new app
Before you can use an API, you have to register your application. Log in to this developer portal and click the “Apps” section in the menu. Click the »Create New App« button.
Enter the »Title« of your application and »Certificate« (X.509 PEM format), »Description and »OAuth Redirect URL«. Click on »Save« button to complete the registration of your application.
When you register an application, the application is assigned a unique client ID and client secret. You must use the client ID when you call an API that requires you to identify your application by using a client ID or a client ID and client secret. Check the API description for details.
Make a note of your API Secret because it is only displayed once. Your API Secret is stored encrypted so we cannot retrieve the unencrypted version to tell you the value if you forget it.
You can reset it, which will update the stored value and return the new value to you. To do that click “Apps” in the main menu, click on the application in question and then you can click the “Reset API Secret” link in the “Subscriptions” section.
Invite members
Invite other members of your organization.
Choose an API plan
After your application is registered, you need to subscribe to API Product and choose a plan. We are offering:
- Account Information
- Consents Service API
- Confirmation of funds Service API
- Account Information Service API
- Payment Initiation
- Payment Initiation Service API
- ATM Information API
- Currency Exchange Calculator API
- Merchant API
The plan for PSD2 APIs determines the environment (production/simulation) and status of the user (TPP or not). We are offering:
- Default Plan – production
- Premium Plan – production
- Simulation Plan
- Non-TPP Default Plan
- Non-TPP Premium Plan
- Non-TPP Simulation
In Bankart API portal mandatory PSD2 APIs are available. API specification is available as a Swagger file, in the "API Product" section in the menu. All APIs follow Berlin standard, JSON format is supported.
For the non PSD2 APIs (ATM Information, Currency Exchange Calculator and Merchant API) we are offering:
- Default Plan
For subscription you select the desired product and make a subscription to one of the plans. In the next step you select an existing application or create a new application. Once your application is subscribed, you use received credentials to test all APIs included in the subscribed products.
Use PSD2 APIs in the Sandbox Environment
It is possible to test an API from this developer portal with static data in the sandbox environment by subscribing to the sandbox API. Before using test cases below, please read the API documentation and swagger definitions under "API Product" tab.
In Bankart API portal mandatory PSD2 APIs are available. All APIs follow Berlin standard, JSON format is supported. APIs published on the portal are sandbox versions and return static answers. All data in the tables below is intended for testing and has no relation to real data. Data in tables can change at any time without prior notice.
Consents Service API
| consentId | |
|---|---|
| POST /consents | *token is mandatory |
| GET /consents/{consentId}/status | 16dd7e042-963f-4e28-9a50-334a167a44ba |
| GET /consents/{consentId} | 6dd7e042-963f-4e28-9a50-334a167a44ba |
| DELETE /consents/{consentId} | 6dd7e042-963f-4e28-9a50-334a167a44ba |
Account Information Service
| API | IBAN | CURRENCY | Consent-ID | WithBalance | Account-id | TransactionId |
|---|---|---|---|---|---|---|
| get /accounts | SI56051001001033999 | EUR | 12345 | TRUE | ||
| SI56051001001033999 | EUR | 123456 | FALSE | |||
| SI56051001001044999 | EUR | 1234567 | TRUE | |||
| get /accounts/{account-id} | SI56051001001033999 | EUR | TRUE or FALSE | 8735076338630656 | ||
| SI56610000018109471 | EUR | FALSE | 8735076338658900 | |||
| get /accounts/{account-id}/transactions | SI56051001001033999 | EUR | FALSE | 8735076338630656 | ||
| SI56051001001044999 | EUR | TRUE | 8735076338630333 | |||
| get /accounts/{account-id}/transactions/{transactionId} | SI56051001001033999 | EUR | 8735076338630656 | 2030000202303039 | ||
| SI56051001001044999 | EUR | 8735076338630545 | 2030000202303040 | |||
| get /accounts/{account-id}/balances | SI56051001001033999 | EUR | 8735076338630656 | |||
| SI56031101000397567 | EUR | 8735076338630655 |
Payment Initiation Service API
| API | payment-service | payment-product | paymentId |
|---|---|---|---|
| POST /{payment-service}/{payment-product} | payments | sepa-credit-transfers | * token is mandatory |
| GET /{payment-service}/{payment-product}/{paymentId} | payments | sepa-credit-transfers | 73bafcc1-ddc1-4c58-abcc-3b4de6e5e482 |
| GET /{payment-service}/{payment-product}/{paymentId}/status | payments | 73bafcc1-ddc1-4c58-abcc-3b4de6e5e482 | |
| payments | 73bafcc1-ddc1-4c58-abcc-3b4de6e5e222 | ||
| DELETE /{payment-service}/{payment-product}/{paymentId} | payments | sepa-credit-transfers | 73bafcc1-ddc1-4c58-abcc-3b4de6e5e482 |
| *with SCA | payments | sepa-credit-transfers | 73bafcc1-ddc1-4c58-abcc-3b4de6e5e222 |
Payment Instrument Issuing
| API | IBAN | CURRENCY | Expected result |
|---|---|---|---|
| post /funds-confirmations | SI56051001001033999 | EUR | "true" |
| SI56051001001033988 | EUR | "false" | |
| SI56051001001033977 | EUR | "true" | |
| SI56051001001011977 | EUR | "false" |
Use PSD2 APIs in the Simulation Environment
If you want to test APIs with your TPP application, we recommend that you choose the simulation plan. You will need a simulation payment account, for which you can write to psd2admin@bankart.si. The functionality is the same as in the production environment.
In order to access the simulation APIs, you must have a valid eIDAS certificate (X.509 PEM format) that is uploaded on the developer portal for your application. You can upload it when creating a new app or later when editing the existing app.
After adding your certificate and redirect URL, you are able to use all PSD2 APIs, according to your given role in simulation environment.
Use PSD2 APIs in the Production Environment
In order to access the production APIs, you must have a valid eIDAS certificate that is uploaded on the developer portal for your application. You can upload it when creating a new app or later when editing the existing app. For the production environment, your app should be subscribed to the Default or Premium Plan.
After adding your certificate and redirect URL, you are able to use all PSD2 APIs, according to your given role. For each PSD2 API, after you subscribe, you are using the simulation plan which is connected to simulation environment. You will notice this on the "Development" badge that is shown on the app card.
When you are ready, you can upgrade it to production by clicking the “Upgrade to production” button.