Skip to main content

Платежи

C помощью платежных методов API вы можете:

  • выполнять массовые платежи по реквизитам своим контрагентам — юридическим и физическим лицам;
  • оплачивать налоги и иные платежи в бюджет;
  • совершать оплату на карту TБанка;
  • создать черновик платежного поручения для выплат в бюджет и контрагентам.

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

Отправить платеж

Чтобы отправлять платежи:

  1. Убедитесь, что у пользователя есть доступы для совершения платежей.

    Для этого в личном кабинете перейдите в Профиль → Компании и выберите нужного пользователя в разделе Доступы → Пользователи. Проверьте наличие подписи на вкладке Право подписи. Как добавить сотрудника и дать право подписи.

  2. Выпустите токен с разрешениями:

  3. Выпустите сертификат. Подробнее о выпуске сертификата.

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

  1. Чтобы обезопасить платежи, установите два вида лимитов:

    • Лимиты ЭЦП — распространяются на все платежи вне зависимости от интерфейса: веб, мобильное приложение, API. Можно настроить несколькими способами:
      • Пользователь с ролью «Генеральный директор» изменяет лимиты самостоятельно в личном кабинете TБизнеса в разделе Лимиты.
      • Через персонального менеджера.
    • Лимиты TAPI — распространяются только на платежи через интерфейс TAPI и входят в лимиты ЭЦП. Их также можно изменить в личном кабинете TБизнеса в разделе Лимиты.

Платежи по реквизитам юридических и физических лиц и в бюджет

Используйте метод Выполнить платеж.

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

Примеры запросов:

Платеж на карту TБанка

Используйте метод Выполнить платеж на карту TБанка.

Платеж считается отправленным, если в ответ на вызов метода вы получаете ответ 201 с указанием X-Request-Id в headers. Сохраните этот идентификатор — по нему банк сможет провести анализ, если у вас возникнут вопросы по отправке платежа.

Уточните номер договора у получателя. Как посмотреть реквизиты и номер договора.


Количество запросов в секунду (RPS (requests per second)) для метода — 10. Если вам нужно увеличить количество, напишите нам на openapi@tbank.ru.

Проверить статус отправленного платежа

Используйте метод Получить статус платежа, передав уникальный ID операции. При успешном запросе возвращается ответ 200.


Количество запросов в секунду (RPS (requests per second)) для метода — 20. Если вам нужно увеличить количество, напишите нам на openapi@tbank.ru.

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


Публичная ручка должна быть без авторизации. Фильтровать события можно по IP-адресу, который мы вам сообщим. По всем вопросам обращайтесь на openapi@tbank.ru

Черновики платежных поручений

Чтобы создавать черновики платежных поручений, выпустите токен с разрешением Создание черновиков платежей в компании с ИНН {inn} и КПП {kpp} для метода Создать черновик платежного поручения.


Подробнее о выпуске токена

Создать черновик на оплату по реквизитам юридических и физических лиц и в бюджет

Используйте метод Создать черновик платежного поручения.

Черновик считается созданным, если в ответ на вызов метода возвращается ответ 200 с указанием X-request-id в headers. Сохраните идентификатор — по нему банк сможет провести анализ, если у вас возникнут вопросы по отправке черновика.

Примеры запросов:


Количество запросов в секунду (RPS (requests per second)) для метода — 10. Если вам нужно увеличить количество, напишите нам на openapi@tbank.ru.

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


Примеры ошибок при вызове методов

Посмотреть примеры часто встречающихся ошибок можно также в документации TAPI.

400

401

403

Ошибки доступов — права пользователя, сертификаты, токены

errorCode: FORBIDDEN

422

Ошибки, связанные с некорректными реквизитами

429

500


FAQ

openapi@tbank.ru

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