Вебхуки
Через вебхуки мы сообщаем вам о событиях на нашей стороне — например, новой операции по счету или изменении статуса платежа.
Преимущества:
- повышение эффективности;
- упрощение автоматизации;
- усиление специфичности.
Перед подключением ознакомьтесь с информацией на странице нужного вебхука.
Подключение
Есть два варианта подключения вебхуков:
- Самостоятельно — через метод Добавить вебхук.
- Через поддержку — по электронной почте.
Через метод
Сделайте метод API, который мы будем вызывать, чтобы отправить вебхук. Требования:
- Протокол — HTTPS.
- Порт — 443.
- Метод — POST.
- Авторизация необязательна. Если она нужна, мы поддерживаем -basic и -bearer авторизацию.
Выпустите токен с доступом «Управление вебхуками».
В запросе метода Добавить вебхук передайте нужный тип события, адрес электронной почты и URL метода для уведомлений, который вы сделали на шаге 1.
В ответе вернется ID созданного вебхука.
Посмотреть список всех подключенных вебхуков компании можно через метод Получить список вебхуков компании, удалить ненужные вебхуки — через Удалить вебхук.
Через поддержку
Подключение вебхука занимает до двух рабочих дней.
Уведомления банка приходят с IP 212.233.80.7, 91.218.132.2, 91.194.226.234, 91.194.226.235, 91.194.226.250 и 91.194.226.251.
Сделайте метод API, который мы будем вызывать, чтобы отправить вебхук. Требования:
- Протокол — HTTPS.
- Порт — 443.
- Метод — POST.
- Авторизация необязательна. Если она нужна, мы поддерживаем -basic и -bearer авторизацию.
Напишите на openapi@tbank.ru с любой почты, которая привязана к компании, или направьте запрос через чат Т-Бизнеса в личном кабинете или приложении.
В письме укажите:
- ИНН вашей компании.
- Какой вебхук подключаете — например, статус платежа или новая операция по счету.
- Адрес метода API из пункта 1.
- Данные для авторизации, если она есть.
Шаблон письма:
• ИНН — 12345678901
• Вебхук — Статус платежа
• Адрес вашего метода
• Данные для авторизации — Bearer t.wFHqh3g2UwAl3CUSQqq_deCf201Qp0BY2mxFWQTggcc2g0uJxHPdNYD_yqZJFUjQ53YUeIb4Xr66jcfiMe7D8A
После получения вебхука отправляется ответ. Вебхук считается корректно полученным, если приходит ответ формата 2ХХ.
Лимит на повторные отправки в случае ошибки — от 30 секунд до 10 минут между попытками. Максимальное количество попыток — 5.