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

Шаг 1. Выпустить токен

Токен — это уникальный ключ доступа, который позволяет использовать методы TAPI.

Для работы с песочницей используйте токен Bearer TBankSandboxToken.

С помощью H2H-интеграции TAPI вы можете выпустить Access Token — он нужен только для прямой интеграции. Токен действует 90 дней с последнего использования. При постоянном использовании токен активен бессрочно.

Чтобы использовать защищенные методы , выпустите mTLS-сертификат.

  1. В личном кабинете выберите Интеграции и на вкладке TAPI нажмите Выпуск токена.


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


    Требования к IP-адресам:

    • IP-адрес должен быть статичным.
    • Поддерживаются протоколы IPv4 и IPv6.
    • Нельзя указывать диапазон IP-адресов.
    • Максимально можно указать девять IP-адресов.

Вы можете отключить проверки IP-адресов — для этого отправьте запрос с ИНН вашей компании на openapi@tbank.ru или обратитесь в чат или на горячую линию Т-Бизнеса. После отключения проверки введите любой IP в форму, например 0.0.0.0 или 1.1.1.1.

  1. В блоке Выберите, к чему будет доступ через API выберите операции, к которым хотите дать доступ. Для части операций доступен функционал ограничения счетов — напротив них есть плашка «Доступно ограничение счетов».


  2. Нажмите Выпустить токен и скопируйте его.


После этого вы можете использовать токен для подключения ваших сервисов к ТБанку.

Отредактировать токен не получится. Чтобы изменить IP-адрес или доступы, выпустите новый токен.

Ограничение счетов

Ограничение счетов — это функционал, который позволяет вам как директору компании ограничить своим сотрудникам доступ к определенным счетам компании на токене для продуктов Зарплатный проект и Счета.

Методы, для которых действует функционал ограничения счетов:

Когда это нужно

Например, у вашей компании есть несколько счетов для ведения бизнеса: один для выплат контрагентам, другой — для выплаты зарплат сотрудникам, и еще один — для прибыли.

Как директор вы хотите, чтобы ваши сотрудники, которые используют токен для работы с T-API, имели доступ только к тем счетам, которые нужны для их работы.

Как пользоваться

Если вы — директор:


Если вы — сотрудник:


Доступы

Доступ нужен, чтобы использовать методы TAPI. В описании каждого метода есть шаблон доступа.

Пример

Чтобы использовать метод Получить список этапов сделки, в личном кабинете нужно выбрать доступ opensme/inn/{inn}/kpp/{kpp}/nominal-accounts/manage — Управление номинальными счетами.

Чтобы получить или изменить доступ, перевыпустите токен в личном кабинете.

Как предоставить доступ к личному кабинету своим сотрудникам

Отозвать токен

  1. В личном кабинете перейдите в раздел Мой профиль.


  2. Выберите вкладку Безопасность.


  3. В блоке «Приложения, у которых есть доступ к данным для входа» выберите токен, который хотите удалить, и нажмите Удалить доступ.


openapi@tbank.ru

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