Вебхуки Chaingateway — это HTTPS-уведомления, которые сообщают вашему серверу о событиях блокчейна, например о депозитах и переводах токенов. Вы регистрируете адрес и URL, Chaingateway следит за цепочкой, а каждая доставка несёт подпись HMAC. Неудачные уведомления попадают в список, и их можно отправить заново через API.

События блокчейна в реальном времени доставляются на ваш бэкенд

Поддержка основных блокчейнов

Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon, Arbitrum.

Простая настройка

Быстрая и простая настройка под любой сценарий использования.

Безопасно и масштабируемо

Создано для больших объёмов с учётом требований безопасности.

Удобно для разработчиков

Подробная документация и поддержка для беспроблемной интеграции.

Запускайте с уверенностью

Как работают мгновенные уведомления о платежах?

Chaingateway отправляет HTTP POST на ваш эндпоинт, когда транзакция совпадает с зарегистрированным вами вебхуком. Payload содержит отправителя, получателя, сумму, контракт токена и ID транзакции, поэтому платёж можно сверить без опроса цепочки.

Можно отслеживать входящие и исходящие транзакции и фильтровать их по адресу, контракту токена, ID токена или типу. Вебхуку нужен url и хотя бы одно из полей from или to.

1. Создайте приёмник вебхуков

Создайте защищённый эндпоинт на своём сервере для приёма и обработки уведомлений вебхуков.

Показать руководство по приёмнику

Добавьте вебхук

Добавьте вебхук в своё приложение, чтобы получать уведомления о событиях блокчейна в реальном времени.

Показать документацию по API

Получайте уведомления

Получайте уведомления о событиях блокчейна в реальном времени, чтобы всегда быть в курсе важных обновлений.

Посмотреть демо

Добавьте защиту

Защитите свои вебхуки подписями и аутентификацией, чтобы предотвратить несанкционированный доступ.

Руководство по безопасности
Ончейн-событие перевод пришёл на отслеживаемый адрес POST на ваш URL JSON payload + заголовок X-Signature Ваш сервер проверяет HMAC, зачисляет платёж Доставка не принята? Автоматически не повторяется. В списке неудачных; повтор вызовом retry.
  1. Chaingateway следит за зарегистрированным вами адресом и реагирует на подходящие переводы.
  2. Каждое уведомление — один HTTP POST. Заголовок X-Signature — это HMAC SHA-256 в кодировке Base64 от ID транзакции и вашего секрета.
  3. Проверьте подпись, затем зачислите платёж один раз на ID транзакции, потому что повтор доставляет то же событие снова.
От ончейн-события до вашей базы данных, включая путь ручного повтора.

Какие функции вебхуков есть в Chaingateway?

Вебхуки охватывают Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon и Arbitrum. Можно фильтровать по адресу и токену, просматривать каждое уведомление в личном кабинете и проверять каждую доставку по подписи HMAC.

Открыть документацию

Некастодиальная доставка

Вебхуки срабатывают в Ethereum, Bitcoin, TRON, BSC, Polygon и Arbitrum, при этом наша система никогда не хранит ваши ключи или средства.

Ручной повтор

Неудавшиеся уведомления можно повторить по запросу через API.

Расширенная фильтрация

Легко фильтруйте вебхуки, чтобы получать только нужные вам данные.

Поддержка основных блокчейнов

Мы поддерживаем большинство основных блокчейнов для вашего удобства.

Логирование

Наша система логирует все события вебхуков и отображает их в интерфейсе.

Повторы

Неудавшиеся доставки попадают в список ваших уведомлений и готовы к повтору через API в любой момент.

Высокая производительность

Наши вебхуки созданы для скорости и надёжности.

Безопасная подпись

Все вебхуки надёжно подписываются для подтверждения подлинности.

Оперативная поддержка

Каждый тариф включает поддержку по email и в чате для помощи с интеграцией вебхуков.

Удобство использования

Наш интуитивно понятный API делает управление вебхуками простым и приятным.

Что можно построить на уведомлениях о событиях?

Большинство случаев покрывают четыре шаблона: мониторинг выплат, входящие расчёты, обновления владения NFT и кросс-чейн-оповещения.

Отслеживание крупных выплат

Сценарий использования

Отслеживайте исходящие переводы, фильтруя по вашему hot wallet через from + type (ETH/ERC20), чтобы финансовый отдел получал оповещение до поступления средств.

Входящие расчёты

Сценарий использования

Отслеживайте свой принимающий адрес через to и опционально contractaddress, чтобы подтверждать депозиты за секунды, а не ждать опроса (polling).

Мониторинг активности NFT

Сценарий использования

Подпишитесь на token_id + contractaddress (опционально с фильтром по from), чтобы сразу обновлять таблицы владения после минта или переводов.

Оповещения о кросс-чейн рисках

Сценарий использования

Комбинируйте type с вебхуками для конкретных блокчейнов, чтобы передавать результаты из Bitcoin, Tron, Arbitrum или Polygon в ваш комплаенс-стек.

FAQ

Частые вопросы и ответы

Узнайте все важные детали о нашей платформе и о том, как она может удовлетворить ваши потребности.

Chaingateway Webhooks — это сервис, который позволяет получать уведомления о событиях блокчейна в реальном времени, таких как входящие и исходящие транзакции, отправляя POST-запросы на указанный вами эндпоинт при каждом релевантном событии.

Instant Payment Notification (IPN) — это сообщение, которое Chaingateway отправляет на указанный вами эндпоинт при каждом релевантном событии блокчейна, например при входящей или исходящей транзакции. Это позволяет получать обновления в реальном времени и немедленно реагировать на основе данных события.

Чтобы настроить вебхук, нужно создать защищённый эндпоинт на своём сервере, способный принимать POST-запросы. Затем можно использовать панель управления или API Chaingateway, чтобы создать вебхук и указать URL своего эндпоинта вместе с желаемыми фильтрами для событий, о которых вы хотите получать уведомления.

Необходимо указать url (публичный эндпоинт) и хотя бы один из параметров from или to. Дополнительные опциональные фильтры — contractaddress, token_id и type (ETH/ERC20/ERC721 для Ethereum и аналогично для других блокчейнов).

Каждый POST-запрос включает id, webhook_id, from, to, blocknumber, datetime, tokenid, type, contractaddress, txid, amount и другие служебные поля, чтобы у вас было всё для сверки платежей.

Каждая доставка подписывается заголовком X-Signature (HMAC SHA-256 от txid + вашего секрета, в Base64). Уведомление, которое ваш сервер не принял, автоматически повторно не отправляется: API показывает неудачные уведомления (GET /webhooks/notifications/failed), и вы запускаете повторную доставку каждого через POST /webhooks/notifications/{id}/retry.

Нет. Сервис вебхуков обращается к вашему публичному эндпоинту через открытый интернет — просто убедитесь, что ваш файрвол пропускает входящий трафик без белого списка IP.

Используйте панель управления Chaingateway, чтобы отправить тестовые события на свой эндпоинт и убедиться, что ваш обработчик корректно обрабатывает payload перед запуском в продакшн.

Используйте заголовок X-Signature, чтобы убедиться, что входящие запросы действительно от Chaingateway. Эта подпись формируется с помощью HMAC SHA-256 с использованием вашего секретного ключа, гарантируя, что вашим эндпоинтом обрабатываются только авторизованные события.

Наша служба поддержки готова помочь с любыми вопросами или проблемами. Свяжитесь с нами через страницу поддержки на нашем сайте, и мы будем рады помочь.

Остались вопросы?

Мы готовы всё прояснить и помочь с любыми вашими вопросами.

Улучшите свой пайплайн данных

Готовы к уведомлениям о событиях в реальном времени?

Прекратите опрашивать API и начните получать мгновенные обновления с вебхуками Chaingateway. Получайте уведомления о событиях блокчейна в реальном времени, чтобы реагировать быстрее и создавать более отзывчивые приложения.