Получить выписку по счёту
https://business.tinkoff.ru/openapi/api/v1/statement
Метод для получения списка операций по счёту за определённый период по указанным критериям поиска. Данные доступны с июня 2023 года.
Чтобы оперативно отслеживать статус оплаты, вы также можете воспользоваться вебхуком Операция по счёту.
Поля с датой и временем в запросе и ответе передаются в формате ISO 8601 по UTC.
Операции получаются порциями. Максимальный размер порции регулируется параметром limit. Если в текущем запросе не удаётся вернуть все операции, в ответе будет заполнено поле nextCursor с указателем на последнюю операцию в ответе. Чтобы получить очередную порцию операций, повторите запрос — в поле cursor укажите значение, полученное из nextCursor.
Чтобы в ответе вернулись балансы, передайте параметр withBalances со значением true. Они вернутся только для первого запроса — для следующих запросов очередной порции операций при заполнении поля cursor балансы не возвращаются.
RPS
Ограничение — 20 запросов в секунду
Scopes
Счета и выписки → Информация об операциях компании с инн {inn} и кпп {kpp}
Header parameters
X-Request-Id
String<uuid>
Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.
Query parameters
Required
accountNumber
String
Requirements: Value must match regular expression ^(\d{20})$
Номер счёта.
categories
Array
Requirements: <= 50 items
Категории операций. Подробнее о категориях.
cursor
String
Requirements: <= 100 characters
Указатель на последнюю операцию, полученную в предыдущем запросе.
Максимальное количество операций в запросе — 5000, значение по умолчанию — 1000. Если количество операций больше лимита, этот параметр вернётся в последней строке ответа — его нужно передать в следующем запросе.
Required
from
String<date-time>
Дата начала периода, включительно.
inns
Array
Requirements: <= 50 items
ИНН контрагентов.
limit
Integer<int32>
Requirements: >= 1 and <= 5000
Default: 1000
Максимальное количество операций, которое нужно получить за один вызов метода.
operationStatus
String
Requirements: [All, Authorization, Transaction]
Статус операции для фильтрации: все операции, только авторизации или только подтвержденные транзакции.
to
String<date-time>
Дата окончания периода, не включительно.
ucid
Integer<int64>
UCID карты — её уникальный идентификатор. Его можно получить через метод Получить список карт компании.
withBalances
Boolean
Если передан true, возвращаются балансы.
Ответ
Это полезный материал?
