Skip to main content

mTLS

Типы шифрования

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

Для некоторых методов можно использовать сертификат любого типа шифрования — они также помечены . Убедитесь, что при использовании сертификата вы вызываете корректный домен: gost или secured.

В зависимости от правовой формы организации, сертификат может выпустить:

  • Для ИП — из соображений информационной безопасности — только сам ИП со своей учетной записи в личном кабинете.
  • Для остальных правовых форм (ООО, АО и других) — владелец компании и сотрудники.

ГОСТ-сертификат

Выпуск

  • Для выпуска сертификата с ГОСТ-шифрованием нужен плагин КриптоПро версии не ниже 5.0.12000 — без него не получится сгенерировать приватный ключ. Плагин доступен только в браузерах Яндекс и Chromium GOST.

  • Перед выпуском убедитесь, что у вас есть КЭП и плагин. Если вы начали попытку выпуска сертификата и вышли из нее, вернуться в нее не получится — придется начать новую попытку.

  1. В браузере Яндекс или Chromium GOST войдите в личный кабинет T‑Бизнеса и перейдите в раздел Интеграции → T‑API. На плашке Сертификаты нажмите Выпустить сертификат.

    Обратите внимание — каждой попытке выпуска присваивается свой порядковый номер.

  2. Выберите сервис, для которого будете использовать сертификат, и тип сертификата mTLS (аутентификация).

  3. Выберите тип шифрования ГОСТ и нажмите Дальше.

    Если вы выбираете сервисы H2H, 1С ДиректБанк и Транзит, по умолчанию
    выпускается ГОСТ-сертификат — это связано с требованиями безопасности. Блок Шифрование не отобразится.

  4. Проверьте данные сотрудника и компании. Если всё верно, нажмите Дальше.

  5. Сгенерируйте приватный ключ, перемещая курсор мыши.

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

    Посмотреть контейнер можно через Инструменты КриптоПро.

  6. Придумайте и подтвердите пароль.

  7. Подпишите и отправьте заявку:

    По закону РФ, подписать заявку на выпуск mTLS-сертификата любого типа шифрования можно с помощью:

    Процесс выпуска сертификата может начать сотрудник компании, прикрепив заявку, подписанную КЭПом юридического лица.

    Отслеживать статус выпуска сертификата можно на странице Сертификаты. Выпуск занимает до 10 минут.

  8. Чтобы использовать сертификат, установите его на устройство, с которого он был выпущен. Перейдите в раздел Сертификаты → Действуют и на карточке ГОСТ-сертификата нажмите Установить на это устройство.

    Если вы собираетесь использовать сертификат на другом устройстве, экспортируйте его. Для этого экспортируйте контейнер, в котором уже содержатся приватный и публичный ключи, в формате pfx или p7s из системы-криптопровайдера — например, «КриптоПро», и установите его на новое устройство. Подробнее про экспорт и импорт сертификата.

Если у вас не получается выпустить сертификат через личный кабинет, напишите в чат поддержки Т-Бизнеса или воспользуйтесь ручным выпуском. Мы можем отказать в ручном выпуске, если не было попыток выпуска через личный кабинет.

Использование

Подставляйте только свои значения в параметры запроса.

Пример запроса с ГОСТ-сертификатом:

/opt/cprocsp/bin/curl -iv --cert SHA1 --url https://gost-openapi.tbank.ru/api/v3/sc/partner/schools -H "Accept: application/json" -H "Authorization: Bearer TOKEN"

Параметры запроса:

  • /opt/cprocsp/bin/curl — путь до curl в пакете КриптоПро.
  • SHA1 — SHA1-отпечаток вашего ГОСТ-сертификата в инструментах КриптоПро. Чтобы его посмотреть, на вкладке Сертификаты выберите нужный и внизу нажмите Свойства сертификата.
  • url — адрес вызываемого метода.
  • TOKEN — токен, выпущенный в личном кабинете Т-Бизнеса.

RSA-сертификат

Выпуск

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

  1. В личном кабинете T‑Бизнеса перейдите в раздел Интеграции → T‑API. На плашке Сертификаты нажмите Выпустить сертификат.

    Обратите внимание — каждой попытке выпуска присваивается свой порядковый номер.

  2. Выберите сервис, для которого будете использовать сертификат, и тип сертификата mTLS.

  3. Выберите тип шифрования RSA и нажмите Дальше.

  4. Проверьте данные сотрудника и компании. Если всё верно, нажмите Дальше.

  5. Подпишите и отправьте заявку:

    По закону РФ, подписать заявку на выпуск mTLS-сертификата любого типа шифрования можно с помощью:

    Процесс выпуска сертификата может начать сотрудник компании, прикрепив заявку, подписанную КЭПом юридического лица.

    Отслеживать статус выпуска сертификата можно на странице Сертификаты. Выпуск занимает до 10 минут.

  6. Чтобы использовать сертификат, установите его на устройство, с которого он был выпущен. Перейдите в раздел Сертификаты → Действуют и на карточке сертификата нажмите Скачать.

Если у вас не получается выпустить сертификат через личный кабинет, напишите в чат поддержки Т-Бизнеса или воспользуйтесь ручным выпуском.

Использование

С сертификатом open-api-cert.pem вы можете использовать защищенные методы , которые расположены на https://secured-openapi.tbank.ru. Для таких запросов нужен сертификат и сгенерированный приватный ключ.

Перед отправкой запроса убедитесь, что у вас:

  • выпущен токен с указанным внешним IP вашего устройства;
  • есть приватный ключ;
  • есть подписанный сертификат;
  • установлена утилита cURL.

Если вы делаете запрос, для которого нужен сертификат, без сертификата или с неверным сертификатом, возвращается ошибка HTTP 400.

Запросы

Сделать запрос можно несколькими способами:

Используйте сертификат и приватный ключ:

curl --cert open-api-cert.pem --key private.key https://secured-openapi.tbank.ru/...

Примеры

  1. Метод Выполнить платеж. Введите запрос в командной строке:

    curl -i -XPOST
    --cert open-api-cert.pem --key private.key
    -H 'Authorization: Bearer t.wFHqh3g2UwAl3CUSQqq_deCf201Qp0BY2mxFWQTggcc2g0uJxHPdNYD_yqZJFUjQ53YUeIb4Xr66jcfiMe7D8A'
    https://secured-openapi.tbank.ru/api/v1/payment/ruble-transfer/pay
    -d '{"id":"123456", "from":{"accountNumber":"12345678900987654321"}, "to":{"name":"ООО "Название компании"", "inn":"719351678037", "kpp":"111222333", "bik":"444555666", "bankName":"Чемпион", "corrAccountNumber":"12345678901234567890", "accountNumber":"11122233344455566677"}, "purpose":"Оплата по договору №123. НДС не облагается", "amount":10}'

  2. Метод Получить статус платежа. Введите запрос в командной строке, используя свой токен:

    curl -i -XGET
    --cert open-api-cert.pem --key private.key
    -H 'Authorization: Bearer t.wFHqh3g2UwAl3CUSQqq_deCf201Qp0BY2mxFWQTggcc2g0uJxHPdNYD_yqZJFUjQ53YUeIb4Xr66jcfiMe7D8A'
    https://secured-openapi.tbank.ru/api/v1/payment/123456

Отследить статус выпуска и посмотреть все сертификаты

Чтобы посмотреть все сертификаты и статус выпуска, перейдите в раздел Интеграции → T‑API и на плашке Сертификаты нажмите Все сертификаты. Процесс выпуска занимает около 10 минут.

Также вы можете:

  • На вкладке Действуют — скачать сертификат, посмотреть срок действия, перевыпустить его или выпустить новый.

  • На вкладке Не действуют — посмотреть невыпущенные сертификаты или выпустить новый.

  • На вкладке Выпускаются — посмотреть ваши незавершенные заявки на выпуск сертификата, перейти к подписанию заявки, отменить ее и выпустить новый сертификат.

Посмотреть порядковый номер сертификата можно на всех вкладках.

openapi@tbank.ru

APIСценарииПодключение
Все сервисы T-API

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