Skip to main content

Операции по счёту

Выписка по счёту — документ, который выдаётся банком и отражает операции по счёту за определённый период и итоговый баланс.

Операции по счёту можно получить двумя способами — через метод Получить выписку по счёту или вебхуки. Данные можно использовать, чтобы:

  • подгружать их в 1С и вести бухгалтерскую сверку;
  • анализировать финансовые показатели компании;
  • оперативно узнавать о списаниях и пополнениях.

Статусы операций

Операция может находиться в двух статусах:

  • Авторизация — неподтверждённая операция. Изменяет доступный остаток счёта, но не изменяет баланс счёта. Например, авторизацией списания воспользоваться не получится.
  • Транзакция — подтверждённая операция.

Авторизации можно использовать для контроля движений по счёту, но нельзя предоставлять в качестве бухгалтерской отчётности — например, отдавать в налоговую или подгружать в 1С.

У каждой операции есть свой уникальный operationId. Он не меняется на протяжении всего жизненного цикла операции — например, при переходе из статуса Авторизация в статус Транзакция или при отмене операции operationId останется тем же.

operationId в методе Получить выписку по счёту равен operationId в вебхуках.

Этапы операций

Операция может совершаться в четыре этапа. Каждый из них имеет собственное время:

  • Подписание плательщиком распоряжения на вывод средств — docDate, 4-е поле платёжного документа по 862-П ЦБ.

  • Авторизация — authorizationDate, холдирование средств на счёте.

  • Транзакция — trxnPostDate, изменение баланса договора.

  • Проведение по балансу банка — operationDate, дата операции. 71-е поле платёжного документа по 862-П ЦБ. Финальный статус операции, может являться только рабочим днём банка:

    • drawDate — дата поступило, для исходящих операций;
    • chargeDate — дата списано, для входящих операций.

При сдаче отчётности в налоговую или 1С в качестве основной даты операции можно использовать только дату проведения по балансу банка. Например, authorizationDate понадобится, если нужно понять, когда курьер оплачивал товар картой, привязанной к расчётному счёту.

Обычно все даты появляются по очереди — по мере прохождения операции по статусной модели. Иногда от момента появления операции до перехода в финальный статус может пройти 3–4 дня. Это зависит не только от Тинькофф, но и от платёжных систем, которые передают информацию о платеже в банк.

Примеры статусной модели

  • Авторизация — момент, когда карту прислонили к терминалу оплаты: понедельник, 10:00.
  • Транзакция — момент, когда платёжная система подтвердила, что операцию можно исполнить: четверг, 16:00.
  • Подписание плательщиком распоряжения на вывод средств: заполняется автоматически, равно дате транзакции.
  • Проведение по балансу банка: четверг.

Две последние даты будут заполнены до 12:00 пятницы в связи с обработкой на стороне банка.

Категории операций

  • cardOperation — оплата картой.

  • cashOut — снятие наличных.

  • fee — услуги банка.

  • penalty — штрафы.

  • contragentPeople — исходящие платежи:

    • selfIncomeOuter — перевод себе в другой банк;
    • selfTransferOuter — перевод между своими счетами в Тинькофф Бизнес;
    • salary — выплаты;
    • contragentOutcome — перевод контрагенту;
    • contragentRefund — возврат контрагенту.
  • budget — платежи в бюджет.

  • tax — налоговые платежи.

  • creditPaymentOuter — погашение кредита.

  • sme-c2c — с карты на карту.

  • otherOut — другое.

  • unspecifiedOut — без категории.

Метод Получить выписку по счёту

Для интеграции:

  1. Выпустите токен: перейдите в раздел Интеграции → Выпуск токена и выберите доступ Счета и выписки — «Информация о счетах компании» и «Информация об операциях компании».
  2. Настройте использование метода Получить выписку по счёту.
  3. Отправьте первый запрос.

Вебхуки

Мы рекомендуем вебхуки, если:

  • у вас больше 10 тысяч операций по счёту ежедневно;
  • вам нужно узнавать об операции сразу — например, чтобы контролировать расходы или отправлять заказ после оплаты клиентом.

Вебхук Операция по счёту

Для интеграции:

  1. Настройте URL, к которому будет обращаться вебхук с POST-запросом о новом событии. Он должен отвечать протоколу HTTPS. Авторизация необязательна, но мы поддерживаем -basic и -bearer авторизацию.

  2. Отправьте письмо на openapi@tinkoff.ru с почты, которая привязана к аккаунту в банке. В письме укажите:

    • какое событие нужно подключить — вебхук «Операция по счёту»,
    • URL, который вы настроили,
    • данные для авторизации — если есть,
    • ИНН компании.

В течение 1 рабочего дня мы подключим вебхук и пришлём уведомление.

Сейчас тестовый режим недоступен. Чтобы исключить ошибки и потерю важных событий, мы рекомендуем проверять точность данных через выписку — для этого настройте сверку операций раз в неделю или раз в день с помощью метода Получить выписку по счёту.

openapi@tinkoff.ru

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.