Платежи
C помощью платежных методов API вы можете:
- выполнять массовые платежи по реквизитам своим контрагентам — юридическим и физическим лицам;
- оплачивать налоги и иные платежи в бюджет;
- совершать оплату на карту T‑Банка;
- создать черновик платежного поручения для выплат в бюджет и контрагентам.
Отправить платеж
Чтобы отправлять платежи:
Убедитесь, что у пользователя есть доступы для совершения платежей.
Для этого в личном кабинете перейдите в Профиль → Компании и выберите нужного пользователя в разделе Доступы → Пользователи. Проверьте наличие подписи на вкладке Право подписи. Как добавить сотрудника и дать право подписи.
Выпустите токен с разрешениями:
Для метода Выполнить платеж — Совершение платежей с рублевого расчетного счета компании с ИНН {inn} и КПП {kpp}.
Для метода Выполнить платеж на карту T‑Банка — Совершение платежей физическим лицам с рублевого расчетного счета компании с ИНН {inn} и КПП {kpp} на карту T‑Банка.
Подробнее о выпуске токена
Выпустите сертификат. Подробнее о выпуске сертификата.
Токен и сертификат привязываются после первого успешного запроса. Если вы хотите перевыпустить токен, вам также нужно перевыпустить сертификат.
Чтобы обезопасить платежи, установите два вида лимитов:
- Лимиты ЭЦП — распространяются на все платежи вне зависимости от интерфейса: веб, мобильное приложение, API. Можно настроить несколькими способами:
- Пользователь с ролью «Генеральный директор» изменяет лимиты самостоятельно в личном кабинете T‑Бизнеса в разделе Лимиты.
- Через персонального менеджера.
- Лимиты T‑API — распространяются только на платежи через интерфейс T‑API и входят в лимиты ЭЦП. Их также можно изменить в личном кабинете T‑Бизнеса в разделе Лимиты.
- Лимиты ЭЦП — распространяются на все платежи вне зависимости от интерфейса: веб, мобильное приложение, API. Можно настроить несколькими способами:
Платежи по реквизитам юридических и физических лиц и в бюджет
Используйте метод Выполнить платеж.
ID — уникальный идентификатор для всех платежей вашей компании, отправленных через T‑API. Для каждого запроса используется свой 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.
Подписать отправленный черновик
Примеры ошибок при вызове методов
Посмотреть примеры часто встречающихся ошибок можно также в документации T‑API.
400
401
403
Ошибки доступов — права пользователя, сертификаты, токены
errorCode: FORBIDDEN