API Documentation

VUB PSD2 official announcement

VUB as the member of ISBD (International Subsidiary Banks Division) is fully aligned with the PSD2 Open Banking activities and introduced group solution for Open Banking portal and new API standard coming from Berlin-group NextGenPSD2 Access to Account Framework (Berlin-group standard).

 

All TPP partners are welcome to join us via our group Open Banking portal (?ISBD Open Banking Group Application?): https://isbd.openbanking.intesasanpaolo.com/en/home

This portal offers capability for test certificate generation, new ticketing system for all TPP requests and after registering and logging also access the documentation.

TPP Introduction

Application programming interfaces

for access to the Account Information Services and Payment Initiation Services, compliant with the new Payment Services Directive (PSD2), the regulatory technical standard for strong customer authentication (SCA) and open programming interfaces and the local Slovak legislation, transposing the PSD2 directive into local law.

Legal introduction 

V¹eobecná úverová banka, a.s. ("VUB") enables access to accounts (XS2A) utilizing REST API services compliant with The Berlin Group NextGenPSD2 standard version 1.3.9 (shortly to be upgraded into version 1.3.11) that is further defined in implementation guidelines.

Access to the API can be requested by any natural or legal person that has the right to API access based on either the:

• Directive (EU) 2015/2366 of the European Parliament and of the Council of November 25^th 2015 on payment services in the internal market, amending Directives 2002/65/EC, 2009/110/EC and 2013/36/EU and Regulation (EU) No 1093/2010, and repealing Directive 2007/64/EC (PSD2);
• Commission Delegated Regulation (EU) 2018/389 of November 27^th 2017 supplementing Directive (EU) 2015/2366 of the European Parliament and of the Council with regard to regulatory technical standards for strong customer authentication (RTS SCA) and common and secure open standards of communication (RTS SCS);
• Act no. 492/2009 Coll. on payment services and amendments to certain laws

This means particularly:

• Third Party Payment Service Providers that have been registered by a competent authority in the EU;
• Third Party Payment Service Providers that are in the process of being registered by a competent authority in the EU.

 

Optional onboarding process

Swagger is available at Open Banking portal.

1. TPP registers on https://isbd.openbanking.intesasanpaolo.com/en/sign_up. For a successful registration you should select either:

a. I'm registered TPP: In this case you should upload public part of a production eIDAS certificate issued by a verified QTSP.

b. I'm in registration process: In this case you should upload either:

i.  Documentation that proves your TPP registration with a relevant NCA.
ii. Documentation that proves you are in the process of obtaining a TPP registration with a relevant NCA and it is likely that you will obtain such registration.

2. TPP receives email notification of successful registration.

3. TPP receives email notification about successful validation of registration, with a password for ISBD Open Banking Group Application

4. TPP logs into ISBD Open Banking Group Application and retrieves certificate and password for Sandbox API.

5. TPP starts using Real API.

 

Technical

Overview

XS2A interface

Access points

Sandbox API base URL: https://api.vub.sk with the http request header attribute "X-PSD2Sandbox" set to "yes"

Real API base URL for SK customers: https://api.vub.sk/

For CZ customers please use https://api.vub.cz

 

Account Information Service (AIS)

• GET /v1/accounts
• GET /v1/accounts/{accountId}
• GET /v1/accounts/{accountId}/balances
• GET /v1/accounts/{accountId}/transactions
• GET /v1/accounts/{accountId}/transactions/{resourceId}
• POST /v1/consents
• GET /v1/consents/{consentId}
• DELETE /v1/consents/{consentId}
• GET /v1/consents/{consentId}/status

Payment Initiation Service (PIS)

• POST /v1/payments/{paymentProduct}
• POST /v1/bulk-payments/{paymentProduct}
• POST /v1/periodic-payments/{paymentProduct}
• GET /v1/payments/{paymentProduct}/{paymentId}
• DELETE /v1/payments/{paymentProduct}/{paymentId}
• GET /v1/bulk-payments/{paymentProduct}/{paymentId}
• DELETE /v1/bulk-payments/{paymentProduct}/{paymentId}
• GET /v1/periodic-payments/{paymentProduct}/{paymentId}
• DELETE /v1/periodic-payments/{paymentProduct}/{paymentId}
• GET /v1/payments/{paymentProduct}/{paymentId}/status
• GET /v1/bulk-payments/{paymentProduct}/{paymentId}/status

Confirmation of Funds Service (PIIS)

• POST /v1/funds-confirmations