АТ «ВСТ БАНК» забезпечує доступ авторизованих сторонніх надавачів платіжних послуг (Third Party Providers) до спеціалізованих інтерфейсів Open API відповідно до Закону України «Про платіжні послуги», нормативних актів Національного банку України та стандарту Berlin Group NextGenPSD2
На сторінці доступна технічна документація API, параметри Sandbox-середовища, опис інтеграційних сценаріїв та контакти технічної підтримки
Технічна документація
Повна специфікація API, опис методів, параметрів, моделей запитів та відповідей доступні у Swagger UI
Спеціалізовані інтерфейси
Consent Management
Сервіс призначений для створення, авторизації, перевірки статусу та відкликання згод користувача на доступ до рахунків
Доступні операції
| Метод | Endpoint | Призначення |
|---|---|---|
| POST | /v2/consents/account-access | Створення згоди |
| PUT | /v2/consents/account-access/{consentId} | Авторизація згоди |
| GET | /v2/consents/account-access/{consentId}/status | Перевірка статусу |
| DELETE | /v2/consents/account-access/{consentId} | Відкликання згоди |
Особливості роботи зі згодами
- авторизація користувача здійснюється за схемою Redirect;
- згода PSU для одного TPP може включати декілька рахунків;
- згода на один і той самий рахунок PSU для одного TPP є єдиною;
- разова згода відміняє множинну згоду для відповідного рахунку/користувача;
- множинна згода відміняє попередню множинну згоду для відповідного рахунку/користувача.
Підтримувані типи ідентифікатора PSU:
- номер телефону;
- IBAN;
- ІПН.
Account Information Service (AISP)
Сервіс надає доступ до інформації про рахунки клієнта після отримання його згоди
Доступні операції
| Метод | Endpoint | Призначення |
|---|---|---|
| GET | /v2/accounts | Отримання списку рахунків |
| GET | /v2/accounts/{accountId}/balances | Отримання залишків |
| GET | /v2/accounts/{accountId}/transactions | Отримання історії операцій |
Payment Initiation Service (PISP)
Сервіс забезпечує ініціювання платіжних операцій після проходження автентифікації користувача
Доступні операції
| Метод | Endpoint | Призначення |
|---|---|---|
| POST | /v2/payments/{payment-product} | Створення платіжної інструкції |
| POST | /v2/payments/{product-type}/{paymentId}/authorisations | Авторизація платежу |
| GET | /v2/payments/{product-type}/{paymentId}/status | Перевірка статусу |
Sandbox
Загальні параметри
| Параметр | Значення |
|---|---|
| URL | https://openbanking.test.vstbank.ua/ |
| Підхід до роботи зі згодами | Redirect |
| SCA | Підтримується |
Тестові облікові дані Sandbox
| Параметр | Значення |
|---|---|
| Логін | +380990001015 |
| Пароль | Qwer1234 |
| OTP | 111111 |
Авторизація здійснюється через вебінтерфейс банку. Мобільний застосунок у тестовому середовищі не використовується
Тестові рахунки
| Валюта | IBAN |
|---|---|
| UAH | UA813071230000026201995516524 |
| USD | UA363071230000026200995516592 |
| EUR | UA363071230000026205995516616 |
Програма тестування
Тестування спеціалізованих інтерфейсів здійснюється у середовищі Sandbox та охоплює:
- створення, авторизацію, перевірку статусу та відкликання згод;
- отримання інформації щодо рахунків, залишків і історії операцій;
- ініціювання, авторизацію та перевірку статусу платіжних операцій.
Детальний опис сценаріїв тестування, параметрів запитів і моделей відповідей наведено у Swagger UI