/fintech/api/v2/statement/transactions
Ресурс позволяет получить выписку по счету (рублевому или валютному) за выбранную дату. Необходимо запрашивать постранично данные операции, начиная с первой страницы.
Для получения выписки по счету необходимо отправить GET-запрос /fintech/api/v2/statement/transactions
с токеном доступа (access_token) пользователя в параметре Authorization заголовка, номером счета (accountNumber), датой выписки (statementDate) и номером запрашиваемой страницы (page) в query-параметрах.
- Максимальное количество операций, возвращаемых на одной странице выписки, равно 100 операций для промышленного контура.
- Дата запрашиваемой выписки не может быть ранее 1.01.2017.
- В получаемой выписке внутри каждой операции сначала отображается информация по плательщику, а затем информация по получателю.
В параметре scope ссылки авторизации пользователя должен быть указана операция GET_STATEMENT_ACCOUNT
для получения доступа к этому ресурсу.
Для обращения к ресурсу необходимо отправлять запрос на:
- Тестовый контур
https://iftfintech.testsbi.sberbank.ru:9443
- Промышленный контур
https://fintech.sberbank.ru:9443
Request
/fintech/api/v2/statement/transactions
- Модель
- Пример
Наименование | Тип | Формат | Regexp | Обязательность | Описание |
---|---|---|---|---|---|
HEADER | |||||
Authorization | string | string | ^[a-zA-Z0-9]38$ | required | Access token пользователя собственной организации, полученный через SSO. |
Accept | string | string | ^(application/json|application/jose) | optional | Указывает на формат данных, который вы готовы принять от Банка. Если ответ не требуется в зашифрованном виде, то может быть не указан или передан со значением application/json. Если н еобходимо получить ответ на запрос токена в зашифрованном виде, то необходимо передать параметр со значением application/jose. |
Query-parameters | |||||
accountNumber | string | string | ^[0-9]20$ | required | Номер счета. |
statementDate | DateTime | ISO 8601 YYYY-MM-DD | ^([0-9]4)-([0-9]2)-([0-9]2)$ | required | Дата запрашиваемой выписки. |
page | integer | integer | ^\d+$ | required | Номер запрашиваемой страницы. По умолчанию 100 операций на странице. |
curFormat | string | string | ^(curTransfer|swiftTransfer)$ | optional | Формат операции по валютному счету. Если поле curFormat не заполнено, то в ответе на запрос по валютному счету будет передан объект swiftTransfer в формате МТ103. |
GET /fintech/api/v2/statement/transactions?accountNumber=40802810706000000087&statementDate=2023-11-14&page=1 HTTP/1.1
Accept: application/json
Authorization: Bearer a80e9443a795e34c7dvb707z3bd97f80b1e053
Responses
200 (ОК)
На запрос первой страницы в ответе вернется список операций (если существуют операции за выбранную дату и счет) и контейнер links с параметром (href) на следующую страницу и признаком "rel": "next".
На запрос второй страницы в ответе вернется список операций и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Получение последующих страниц производится по аналогии.
Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
- Модель
- Пример (рублевый)
- Пример (валютный)
Наименование |
---|