Перейти к основному содержимому

Номинальные счета Т-Банка

Методы в документации

Презентация. Номинальный счёт — самозанятые

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

Если перевод с номинального счёта совершается в личном кабинете, это списание не будет отображаться в нашем биллинге.

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

Если логика сломалась:

Общее описание

Номинальный счёт — это счёт‑посредник. Он может открываться владельцу счёта для совершения операций с денежными средствами, права на которые принадлежат другому лицу-бенефициару или бенефициарам.

Для упрощения контроля того, кому в какой момент принадлежат деньги и совершения расчётов между бенефициарами, мы предоставляем методы API, которые позволят контролировать управление номинальным счётом.

Что мы выделяем:


Обязательная интеграция — с методами Бенефициары и реквизиты: Создать бенефициара и Получить результаты проверки бенефициаров в финансовом мониторинге.

Интеграция с остальным биллингом также обязательна, но мы можем дать срок на переход.

Подробнее про каждый блок

Работа с API

Тестирование

Для подключения к песочнице оформлять доступы не нужно. Авторизация происходит через Access Token.

Чтобы использовать Access Token, добавьте заголовок Authorization со значением Bearer TinkoffOpenApiSandboxSecretToken.

Прод

Если вы будете управлять счётом своей компании, смотрите инструкцию по подключению.

Токен выпускается через прямую интеграцию. На 4 шаге в блоке «Выберите, к чему будет доступ через API» выберите Управление номинальными счетами. Остальные доступы можно выбрать по необходимости.

  1. Если у вас не статичный API, обратитесь к нам, чтобы мы отключили проверку.
  2. Редактировать токен нельзя.
  3. Обязательно сохраняйте request-Id/error-Id, чтобы потом найти причину ошибки в логах у нас.
  4. Для работы с методами номинального счёта нужна роль sme.signer/sme.director.

Если нужно, при выпуске токена можно указывать несколько API-адресов.

Для работы с нашими методами нужен mTLS-сертификат. Он действует год. Подробнее в инструкции.

1 сертификат = 1 токен. Выпустить сертификат на несколько токенов не получится. Если меняется токен, нужно менять сертификат.

Наш Roadmap

Сейчас в рамках наших методов полноценно работают решение с выплатами по РКЦ, выплаты в налоговую, налоговые копилки, мгновенные выплаты (A2C) с заполнением формы банка на проде.

Для партнёров с PCI DSS мы готовы предложить интеграцию с передачей зашифрованных карточных данных.

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

T-ID для идентификации бенефициаров


Через сервис TID TБанк отправляет данные физических и юридических лиц. Вы сможете забирать данные по бенефициарам без идентификации данных на своей стороне.

TID для физических лиц

Как работает процесс:

  1. Вы интегрируете кнопку Войти с TID.

  2. Передаёте нам данные по вашим бенефициарам через метод Создать бенефициара.

  3. Через метод проверяете корректность данных.

TID для юридических лиц

Как работает процесс:

  1. Вы интегрируете кнопку Войти с TID.

  2. Передаёте нам данные по вашим бенефициарам через метод Создать бенефициара.

Регистрация чеков и интеграция с ФНС

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

Чеки можно будет формировать во время проведения выплаты с номинального счёта.

Если у вас есть пожелания к разработке, пишите нам.

У нас уже есть доступный сервис для проведения выплат через расчётные счета — «Выплаты самозанятым». В его рамках реализованы:

  • установка исполнителя на учёт в налоговой с его согласия;
  • проверка статусов исполнителей в налоговой;
  • проведение оплат;
  • формирование чеков;
  • удержание налога за самозанятого с его согласия.

Подробнее о сервисе

FAQ

openapi@tinkoff.ru

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