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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

Работа с API

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

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

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

Прод

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

Токен выпускается через прямую интеграцию. На 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@tbank.ru

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