Выпустить токен

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

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

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

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

Выпуск

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

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

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

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

   

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

   

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

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

Доступы

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

Пример

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

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

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

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

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

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

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

• Зарплатный проект — Создать черновик платежного реестра, Оплатить реестр.
• Счета — Получить счета v3, Получить счета v4.

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

• Директор:

• Сотрудник:

Отзыв токена

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

   

2. На плашке Безопасность нажмите Настроить.

   

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