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

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

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

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

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

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

   
   

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

   
   

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

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

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

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

   
   

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

   
   

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

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

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

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

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

• Создать черновик платежного реестра
• Оплатить реестр

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

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

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

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

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

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

Доступы

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

Пример

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

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

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

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

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

   
   

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

   
   

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