Уведомления эквайринга Т-Банка с проверкой контрольной суммы
Т-Банк подтверждает подлинность уведомления контрольной суммой Token, которую надо пересчитать по паролю терминала. HookPilot делает это за вас, отклоняет подделки и доставляет настоящие уведомления о статусах платежей в ваш бэкенд с повторами.
Бесплатный тариф без карты: одно подключение и 10 000 событий в месяц.
Как подключить
Источник Т-Банка считается одним подключением. Под второй терминал заводится второй источник.
- 1
Создайте источник с провайдером «Т-Банк» и введите пароль терминала из личного кабинета.
- 2
Скопируйте адрес приёма и укажите его как Notification URL в настройках терминала в личном кабинете Т-Банка.
- 3
Выберите эндпоинты-получатели и подпишите их на нужные статусы: tbank.confirmed, tbank.refunded или маску tbank.*.
- 4
Проведите тестовый платёж и проверьте, что уведомления о смене статуса появились в ленте принятого.
Что проверяется при приёме
Контрольная сумма Token
Все скалярные поля уведомления кроме Token дополняются паролем терминала, сортируются по имени, склеиваются и хешируются SHA-256. Результат сравнивается с полем Token за постоянное время.
Статус как тип события
Поле Status в нижнем регистре становится частью типа события: CONFIRMED превращается в tbank.confirmed. Так эндпоинт подписывается только на нужные статусы.
Идентификатор платежа
Поле PaymentId становится внешним идентификатором события. Повторное уведомление с тем же статусом не создаст второй вебхук.
Ответ сразу
Т-Банк получает 200 в момент сохранения. Доставка в ваш бэкенд идёт отдельно и повторяется по расписанию, если он не ответил.
Событие не пришло
Три причины, которые встречаются чаще остальных. Всё принятое видно в ленте принятого в кабинете вместе с типом и историей доставки.
Уведомления отклоняются
Пароль терминала в источнике не совпадает с паролем в кабинете Т-Банка. Пароль у каждого терминала свой, проверьте, что источник создан для нужного терминала.
Приходит только часть статусов
Эндпоинт подписан на конкретные типы. Подпишите его на маску tbank.*, если нужны все статусы, или добавьте недостающие.
Т-Банк сообщает об ошибке уведомления
Проверьте, что источник активен и адрес указан как Notification URL без изменений. Ответ отдаёт HookPilot, поэтому состояние вашего сервера на приём не влияет.
Хранится ли пароль терминала в открытом виде?
Пароль нужен только для проверки контрольной суммы и после сохранения в кабинете больше не показывается.
Можно ли получать уведомления от нескольких терминалов?
Да. Под каждый терминал заводится свой источник со своим паролем. Все они могут вести в один и тот же эндпоинт.
Что делать, если бэкенд обработал уведомление, но не успел ответить?
Доставка повторится, и бэкенд получит тот же вебхук ещё раз. Храните обработанные идентификаторы платежей и игнорируйте повтор.
Другие интеграции
Платёжные системы, маркетплейсы и любая система с подписанными вебхуками или HTTP API.