Les webhooks Chaingateway sont des notifications HTTPS qui signalent à votre serveur des événements blockchain, comme des dépôts et des transferts de tokens. Vous enregistrez une adresse et une URL, Chaingateway surveille la chaîne, et chaque livraison porte une signature HMAC. Les notifications échouées sont listées et peuvent être renvoyées par l'API.

Événements blockchain en temps réel livrés à votre backend

Compatible avec les principales blockchains

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

Configuration simple

Configuration rapide et simple pour tout cas d'usage.

Sécurisé et évolutif

Conçu pour gérer des volumes élevés en toute sécurité.

Pensé pour les développeurs

Documentation complète et support pour une intégration fluide.

Démarrez en toute confiance

Comment fonctionnent les notifications de paiement instantanées ?

Chaingateway envoie un HTTP POST à votre endpoint quand une transaction correspond à un webhook que vous avez enregistré. Le payload contient l'expéditeur, le destinataire, le montant, le contrat du token et l'identifiant de transaction, ce qui permet de rapprocher le paiement sans interroger la chaîne en continu.

Vous pouvez suivre les transactions entrantes et sortantes et filtrer par adresse, contrat de token, identifiant de token ou type. Un webhook demande une url et au moins un des champs from ou to.

1. Créer un receiver de webhook

Créez un endpoint sécurisé sur votre serveur pour recevoir et traiter les notifications de webhook.

Voir le tutoriel Receiver

Ajouter un webhook

Ajoutez un webhook à votre application pour recevoir des notifications en temps réel sur les événements blockchain.

Voir la documentation API

Être notifié

Recevez des notifications en temps réel pour les événements blockchain, afin d'être toujours informé des mises à jour importantes.

Voir la démo

Ajouter de la sécurité

Sécurisez vos webhooks avec des signatures et de l'authentification pour empêcher tout accès non autorisé.

Guide de sécurité
Événement on-chain un transfert atteint l'adresse POST vers votre URL payload JSON + en-tête X-Signature Votre serveur vérifie le HMAC, crédite le paiement Livraison non acceptée ? Pas de renvoi automatique. Listée comme échouée ; renvoi par l'appel retry.
  1. Chaingateway surveille l'adresse que vous avez enregistrée et réagit aux transferts correspondants.
  2. Chaque notification est un HTTP POST. L'en-tête X-Signature est un HMAC SHA-256 en Base64 calculé sur l'identifiant de transaction et votre secret.
  3. Vérifiez la signature, puis créditez le paiement une seule fois par identifiant de transaction, car un renvoi livre à nouveau le même événement.
De l'événement on-chain à votre base de données, avec le chemin de renvoi manuel.

Quelles fonctionnalités de webhook Chaingateway inclut-elle ?

Les webhooks couvrent Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon et Arbitrum. Vous pouvez filtrer par adresse et par token, consulter chaque notification dans le tableau de bord et vérifier chaque livraison avec sa signature HMAC.

Voir la documentation

Livraison non-custodial

Les webhooks se déclenchent sur Ethereum, Bitcoin, TRON, BSC, Polygon et Arbitrum sans que notre système ne détienne jamais vos clés ou vos fonds.

Nouvelle tentative manuelle

Les notifications échouées peuvent être renvoyées à la demande via l'API.

Filtrage avancé

Filtrez facilement les webhooks pour ne recevoir que les données dont vous avez besoin.

Prise en charge des principales blockchains

Nous prenons en charge la plupart des principales blockchains.

Journalisation

Notre système journalise tous les événements de webhook et les affiche dans une interface.

Nouvelles tentatives

Les livraisons échouées apparaissent dans votre liste de notifications, prêtes à être relivrées via l'API quand vous le souhaitez.

Performance rapide

Nos webhooks sont conçus pour la rapidité et la fiabilité.

Signature sécurisée

Tous les webhooks sont signés de façon sécurisée pour garantir leur authenticité.

Support réactif

Chaque offre inclut le support par e-mail et par chat pour votre intégration de webhooks.

Facile à utiliser

Notre API intuitive rend la gestion de vos webhooks très simple.

Que peut-on construire avec les notifications d'événements ?

Quatre schémas couvrent la plupart des usages : suivi des paiements sortants, règlements entrants, mises à jour de propriété de NFT et alertes entre chaînes.

Suivi des paiements de valeur élevée

Cas d'usage

Surveillez les transferts sortants en filtrant sur votre hot wallet via from + type (ETH/ERC20), pour que la finance soit alertée avant l'arrivée des fonds.

Règlements entrants

Cas d'usage

Surveillez votre adresse de réception avec to et éventuellement contractaddress pour confirmer les dépôts en quelques secondes au lieu d'attendre le polling.

Suivi de l'activité NFT

Cas d'usage

Abonnez-vous à token_id + contractaddress (éventuellement filtré par from) pour mettre à jour les tables de propriété immédiatement après les mints ou les transferts.

Alertes de risque inter-chaînes

Cas d'usage

Combinez type avec des webhooks spécifiques à une chaîne pour transmettre les résultats de Bitcoin, Tron, Arbitrum ou Polygon à votre stack de conformité.

FAQ

Questions et réponses fréquentes

Découvrez tous les détails essentiels sur notre plateforme et sa capacité à répondre à vos besoins.

Chaingateway Webhooks est un service qui vous permet de recevoir des notifications en temps réel pour les événements blockchain, comme les transactions entrantes et sortantes, via des requêtes POST envoyées à l'endpoint que vous avez indiqué dès qu'un événement pertinent survient.

Une Instant Payment Notification (IPN) est un message envoyé par Chaingateway à l'endpoint que vous avez indiqué chaque fois qu'un événement blockchain pertinent survient, comme une transaction entrante ou sortante. Cela vous permet de recevoir des mises à jour en temps réel et d'agir immédiatement en fonction des données de l'événement.

Pour configurer un webhook, vous devez créer un endpoint sécurisé sur votre serveur, capable de recevoir des requêtes POST. Utilisez ensuite le dashboard ou l'API Chaingateway pour créer un webhook et indiquer l'URL de votre endpoint, ainsi que les filtres souhaités pour les événements dont vous voulez être notifié.

Vous devez fournir url (endpoint public) et au moins l'un de from ou to. Les paramètres de filtre optionnels supplémentaires sont contractaddress, token_id et type (ETH/ERC20/ERC721 pour Ethereum, et de façon équivalente pour les autres chaînes).

Chaque requête POST inclut id, webhook_id, from, to, blocknumber, datetime, tokenid, type, contractaddress, txid, amount, et d'autres champs de suivi pour que vous ayez tout ce qu'il faut pour rapprocher les paiements.

Chaque livraison est signée avec X-Signature (HMAC SHA-256 sur txid + votre secret, en Base64). Une notification que votre serveur n’accepte pas n’est pas renvoyée automatiquement : l’API liste les notifications échouées (GET /webhooks/notifications/failed), et vous relancez la livraison de chacune avec POST /webhooks/notifications/{id}/retry.

Non. Le service de webhooks appelle votre endpoint public via l'internet ouvert — assurez-vous simplement que votre pare-feu autorise le trafic entrant sans liste blanche d'IP.

Utilisez le dashboard Chaingateway pour envoyer des événements de test à votre endpoint, afin de vérifier que votre handler traite correctement le payload avant la mise en production.

Utilisez l'en-tête X-Signature pour vérifier que les requêtes entrantes proviennent bien de Chaingateway. Cette signature est générée avec HMAC SHA-256 et votre clé secrète, garantissant que seuls les événements autorisés sont traités par votre endpoint.

Notre équipe support est là pour répondre à toutes vos questions ou résoudre vos problèmes. Contactez-nous via la page support de notre site, nous serons ravis de vous aider.

Encore des questions ?

Nous sommes là pour clarifier les choses et répondre à toutes vos questions.

Améliorez votre pipeline de données

Prêt pour des notifications d'événements en temps réel ?

Arrêtez le polling et recevez des mises à jour instantanées avec les Chaingateway Webhooks. Soyez informé des événements blockchain en temps réel, réagissez plus vite et développez des applications plus réactives.