Глоссарий
Вебхук
Вебхук — HTTP-запрос, который платформа отправляет на настроенный мерчантом URL, когда с платежом что-то происходит: он оплачен, отклонён, возвращён, оспорен, выплата отправлена. Он несёт идентификатор платежа, ссылку мерчанта, новый статус и суммы и подписан, чтобы мерчант мог проверить, что он пришёл от платформы. Вебхуки заменяют опрос и ненадёжный редирект; поскольку сети сбоят, они повторяются и могут прийти больше одного раза.
Что делает хороший вебхук
Подписывает тело ключом, который мерчант может сменить; повторяет по расписанию, когда сервер мерчанта не отвечает успехом, часами или днями; сохраняет порядок событий или несёт достаточно состояния, чтобы порядок не имел значения; позволяет мерчанту видеть и повторно отправлять доставки; никогда не содержит номеров карт.
Что должен делать мерчант
Быстро отвечать успехом и обрабатывать асинхронно; проверять подпись; искать платёж по идентификатору, а не доверять одному телу; делать обработку идемпотентной, раз одно событие может прийти дважды; и держать запасной запрос статуса на случай, когда все доставки не удались.
На платформе
Tranzify отправляет вебхуки о каждом изменении платежа, возврата, чарджбэка и выплаты, подписывает их, повторяет по расписанию, показывает каждую доставку с ответом мерчанта в бэк-офисе и позволяет операционной команде переслать её вручную; те же события питают кабинет мерчанта.
Обновлено: 2026-11-08