Получить выписку с авторизациями за определенный период

/api/v1/account-operations

Метод устарел.

GET

https://business.tbank.ru/openapi/api/v1/account-operations

Необходимо согласие пользователя на доступ к информации об операциях компании. Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/account-operations/get — Информация о транзакциях и авторизациях по счетам компании с инн {inn} и кпп {kpp}.Запросы с количеством операций более 10 000 будут возвращать ошибку TOO_MANY_OPERATIONS. Ограничение на использование метода — 3 запроса в секунду.

Авторизация

Security

Bearer API Token

Query parameters

Required

accountNumber

String

Requirements: Value must match regular expression ^(\d{20}|\d{22})$

Расчетный счет организации.

ucid

Integer<int64>

UCID карты. Если не указан, вернутся все операции по счету.

operationStatus

String (AccountOperationStatus)

Requirements: [authorization, transaction]

Статус операции. Если не указан, вернутся как транзакции, так и авторизации.

Required

from

String<date-time>

Дата начала периода, включительно.

Required

till

String<date-time>

Дата конца периода, исключительно.

Ответ

200

OK

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции

Пример запроса

cURL

Go

Java

NodeJs

PHP

Python

Content type

curl --location 'https://business.tbank.ru/openapi/api/v1/account-operations?accountNumber=40702810110011000000&from=2021-11-03T11:3A00:3A00+03:3A00&till=2021-11-03T11:3A00:3A00+03:3A00' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <TOKEN>'

Пример ответа

200

400

401

403

422

429

500

Content type

application/json

{

"0": { ... }

"accountNumber":

"40702810110011000777",

"authDateTime":

"2021-11-17T12:10+03:00",

"trxnDateTime":

"2021-11-17T12:11+03:00",

"authId":

"123456789",

"trxnId":

"123456789",

"authStatus":

"succeed",

"operationType":

"debit",

"operationStatus":

"transaction",

"amount":

100,

"currency":

"RUB",

"accountAmount":

100,

"description":

"Нужно совершить платеж",

"card": {

"ucid":

"12345678901234567890",

"mcc":

"1234",

"number":

"1111********9999"

},

"merch": { ... },

"id":

"123456",

"name":

"Лучший Банк",

"address":

"ул. Уличная, д. 666",

"city":

"MOSCOW",

"country":

"RUS"

},

"rrn":

"123456789012",

"acquirerId":

"010455"

}

}