5. Запит на отримання інформації по рахунку (Read Data)

Цей розділ описує запити AIS API для отримання інформації по рахунках PSU: список доступних рахунків (ідентифікатори), баланси та транзакції, за умови що відповідна згода PSU вже надана та збережена в ASPSP.

5.1. Отримання ідентифікаторів рахунків

Виклик

GET /v2/accounts {query-parameters}

Дозволяє отримати ідентифікатори рахунків з додатковою інформацією, яка описана у цьому розділі нижче. Передбачається, що згода PSU для цього доступу вже надана та збережена в системі ASPSP, вона визначає список рахунків, по яких можуть бути отримані ідентифікатори.

Query Parameters

Request Header

Request Body

Немає.

Response Code

HTTP Response Code = 200

Response Header

Response Body

Приклад

Response body (приклад 1)

Відповідь у випадку, коли згоду PSU на отримання відомостей з рахунків надано на два різних IBAN:

{
  "accounts": [
    {
      "resourceId": "abd2f95f-0d4b-4dc1-9f2b-62cfcadda6fc",
      "iban": "UA233077700000026205011558000",
      "currency": "UAH",
      "balances": [
        {
          "balanceAmount": {
            "amount": "0.00",
            "currency": "UAH"
          },
          "balanceType": "interimAvailable",
          "referenceDate": "2024-12-25"
        }
      ],
      "_links": {
        "balances": {
          "href": "/v2/accounts/abd2f95f-0d4b-4dc1-9f2b-62cfcadda6fc/balances"
        },
        "transactions": {
          "href": "/v2/accounts/abd2f95f-0d4b-4dc1-9f2b-62cfcadda6fc/transactions"
        }
      }
    }
  ]
}

Response body (приклад 2)

Відповідь у випадку, коли згоду PSU на отримання відомостей з рахунків надана до мультивалютного рахунку по двох валютах мультивалютного рахунку.

5.2. Отримання балансу

Виклик

GET /v2/accounts/{account-id}/balances

Повертає баланс по рахунку відповідно до вказаного account-id.

Path Parameters

Query Parameters

Відсутні.

Response Code

HTTP Response Code = 200.

Request Header

Request Body

Немає.

Response Header

Response Body

Деталізація атрибуту balances

Більше опціональних атрибутів можна знайти у yaml файлі.

Приклад

Response body

{
  "account": {
    "iban": "UA233077700000026205011558000",
    "currency": "UAH"
  },
  "balances": [
    {
      "balanceAmount": {
        "amount": "0.00",
        "currency": "UAH"
      },
      "balanceType": "interimAvailable",
      "referenceDate": "2025-01-20"
    }
  ]
}

5.3. Отримання списку транзакцій

Виклик

GET /v2/accounts/{account-id}/transactions {query-parameters}

Повертає список транзакцій по вказаному account-id.

Примітка: ASPSP може використовувати стандартні методи стиснення на рівні application для повідомлення відповіді, як зазначено в кодуванні header. У разі повернення форматів camt.05x, кілька файлів camt.05x можуть міститися в одній відповіді.

Path Parameters

Query Parameters

ПРИМІТКА: У випадку bookingStatus = information, параметри dateFrom, dateTo, withBalance будуть проігноровані і не вплинуть на результат.

Request Header

Request Body

Немає.

Response Code

HTTP Response Code = 200.

Response Header

Response Body (JSON)

Деталізація атрибуту transactions

Примітка: атрибути у таблиці нижче, які вказані як опціональні, є рекомендованими для повернення ASPSP у відповіді на запит AISP про список транзакцій.