Цей розділ містить специфікацію AIS (Account Information Service) для отримання інформації по рахунку (Read Data) у межах ініціативи Відкритий банкінг в Україні. Документ є українською адаптацією Специфікації Berlin Group, підготовленою та супроводжуваною Open API Group (OAG) Асоціації «ЄМА», і поширюється за ліцензією CC BY-ND 4.0.
AIS API
Специфікація доступу до інформації по рахунках, балансах та транзакціях.
1. Вступ
Розділ описує походження AIS API, необхідність згоди PSU та визначає перелік рахунків і обов’язкові сценарії використання.
2. Прикладний рівень: керівні принципи
Перелік обов’язкових endpoint’ів AIS API та методів доступу до них.
3. Огляд передачі даних
Описує технічну модель передачі даних AIS, умовні позначення та вимоги до атрибутів у request/response для позитивних відповідей (HTTP 2xx).
4. Специфіка надання інформації по мультивалютному рахунку
Інформація щодо мультивалютних рахунків надається відповідно до параметрів згоди PSU: або по всіх валютах рахунку, або лише по тих, на які надано згоду.
5. Запит на отримання інформації по рахунку (Read Data)
Опис endpoint-ів AIS API для отримання списку рахунків (ідентифікаторів), балансів та транзакцій за згодою PSU.
6. Use Case 5. Отримання балансу по рахунку або списку транзакції (до 31 календарного дня)
Сценарій взаємодії PSU, AISP та ASPSP для отримання балансу по рахунку або списку транзакцій (до 31 календарного дня) за наявної згоди consentId у статусі valid.
7. Документи і посилання
Посилання на документи OpenFinance API Framework та репозиторій YAML, використані при розробці специфікації.
Додатки
Діаграма активності для UC 5 (баланс/транзакції до 31 дня) та приклад тест-кейсів для контрактного тестування.
Додаток 3. Приклад тест-кейсів для контрактного тестування
Приклади тест-кейсів для контрактного тестування AIS API: отримання ідентифікатора рахунку (resourceId), балансу та списку транзакцій.