I webhook di Chaingateway sono notifiche HTTPS che segnalano al tuo server eventi blockchain, come depositi e trasferimenti di token. Registri un indirizzo e un URL, Chaingateway osserva la chain e ogni consegna porta una firma HMAC. Le notifiche fallite sono elencate e si possono rinviare tramite l'API.

Eventi blockchain in tempo reale, consegnati al tuo backend

Supporto per le principali blockchain

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

Configurazione semplice

Configurazione rapida e semplice per qualsiasi caso d'uso.

Sicuro e scalabile

Progettato per gestire volumi elevati con la sicurezza in mente.

Pensato per gli sviluppatori

Documentazione completa e assistenza per un'integrazione senza intoppi.

Lancia con fiducia

Come funzionano le notifiche di pagamento istantanee?

Chaingateway invia una richiesta HTTP POST al tuo endpoint quando una transazione corrisponde a un webhook che hai registrato. Il payload contiene mittente, destinatario, importo, contratto del token e ID della transazione, così puoi riconciliare il pagamento senza interrogare la chain a intervalli.

Puoi tracciare transazioni in entrata e in uscita e filtrare per indirizzo, contratto del token, ID del token o tipo. Un webhook richiede un url e almeno uno tra from e to.

1. Crea un receiver per i webhook

Crea un endpoint sicuro sul tuo server per ricevere ed elaborare le notifiche webhook.

Mostra il tutorial sul receiver

Aggiungi un webhook

Aggiungi un webhook alla tua applicazione per ricevere notifiche in tempo reale per gli eventi blockchain.

Mostra la documentazione API

Ricevi notifiche

Ricevi notifiche in tempo reale per gli eventi blockchain, così sei sempre informato sugli aggiornamenti importanti.

Vedi demo

Aggiungi sicurezza

Proteggi i tuoi webhook con firme e autenticazione per prevenire accessi non autorizzati.

Guida alla sicurezza
Evento on-chain un trasferimento raggiunge un indirizzo osservato POST al tuo URL payload JSON + header X-Signature Il tuo server verifica l'HMAC, accredita il pagamento Consegna non accettata? Non viene rinviata automaticamente. Elencata come fallita; la rinvii con la chiamata di retry.
  1. Chaingateway osserva l'indirizzo che hai registrato e reagisce ai trasferimenti corrispondenti.
  2. Ogni notifica è un singolo HTTP POST. L'header X-Signature è un HMAC SHA-256 in Base64 calcolato sull'ID della transazione e sul tuo secret.
  3. Verifica la firma, poi accredita il pagamento una sola volta per ID di transazione, perché un retry consegna di nuovo lo stesso evento.
Dall'evento on-chain al tuo database, compreso il percorso di retry manuale.

Quali funzionalità webhook include Chaingateway?

I webhook coprono Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon e Arbitrum. Puoi filtrare per indirizzo e token, rivedere ogni notifica nella dashboard e verificare ogni consegna con la sua firma HMAC.

Sfoglia la documentazione

Consegna non-custodial

I webhook si attivano su Ethereum, Bitcoin, TRON, BSC, Polygon e Arbitrum senza che il nostro sistema custodisca mai le tue chiavi o i tuoi fondi.

Retry manuale

Le notifiche fallite possono essere ripetute su richiesta tramite l'API.

Filtri estesi

Filtra facilmente i webhook per ricevere solo i dati di cui hai bisogno.

Supporto per le principali blockchain

Supportiamo la maggior parte delle principali blockchain per tua comodità.

Logging

Il nostro sistema registra tutti gli eventi webhook e li mostra in un'interfaccia.

Retry

Le consegne fallite finiscono nella tua lista notifiche, pronte per essere ripetute tramite API quando vuoi.

Prestazioni elevate

I nostri webhook sono progettati per velocità e affidabilità.

Firma sicura

Tutti i webhook sono firmati in modo sicuro per verificarne l'autenticità.

Assistenza reattiva

Ogni piano include assistenza via email e chat per aiutarti con l'integrazione dei webhook.

Facile da usare

La nostra API intuitiva rende la gestione dei tuoi webhook un gioco da ragazzi.

Cosa puoi costruire con le notifiche di evento?

Quattro schemi coprono la maggior parte degli usi: monitoraggio dei pagamenti in uscita, regolamenti in entrata, aggiornamenti di proprietà degli NFT e avvisi cross-chain.

Tracciamento di payout ad alto valore

Caso d'uso

Monitora i trasferimenti in uscita filtrando sul tuo hot wallet tramite from + type (ETH/ERC20), così il team finanziario viene avvisato prima che i fondi arrivino a destinazione.

Regolamenti in entrata

Caso d'uso

Monitora il tuo indirizzo ricevente usando to e opzionalmente contractaddress per confermare i depositi in pochi secondi invece di aspettare il polling.

Monitoraggio attività NFT

Caso d'uso

Iscriviti a token_id + contractaddress (opzionalmente filtrato per from) per aggiornare le tabelle di proprietà subito dopo mint o trasferimenti.

Avvisi di rischio cross-chain

Caso d'uso

Combina type con webhook specifici per chain per inoltrare i risultati da Bitcoin, Tron, Arbitrum o Polygon al tuo stack di compliance.

FAQ

Domande e risposte comuni

Scopri tutti i dettagli essenziali sulla nostra piattaforma e su come può soddisfare le tue esigenze.

Chaingateway Webhooks è un servizio che ti permette di ricevere notifiche in tempo reale per gli eventi blockchain, come transazioni in entrata e in uscita, inviando richieste POST al tuo endpoint specificato ogni volta che si verificano eventi rilevanti.

Una Instant Payment Notification (IPN) è un messaggio inviato da Chaingateway al tuo endpoint specificato ogni volta che si verifica un evento blockchain rilevante, come una transazione in entrata o in uscita. Questo ti permette di ricevere aggiornamenti in tempo reale e agire immediatamente in base ai dati dell'evento.

Per configurare un webhook devi creare un endpoint sicuro sul tuo server in grado di ricevere richieste POST. Poi puoi usare la dashboard o l'API di Chaingateway per creare un webhook e specificare l'URL del tuo endpoint insieme ai filtri desiderati per gli eventi di cui vuoi ricevere notifiche.

Devi fornire url (endpoint pubblico) e almeno uno tra from o to. Argomenti di filtro opzionali aggiuntivi sono contractaddress, token_id e type (ETH/ERC20/ERC721 per Ethereum, e in modo analogo per le altre chain).

Ogni richiesta POST include id, webhook_id, from, to, blocknumber, datetime, tokenid, type, contractaddress, txid, amount e altri campi di bookkeeping, così hai tutto per riconciliare i pagamenti.

Ogni consegna è firmata con X-Signature (HMAC SHA-256 su txid + il tuo secret, in Base64). Una notifica che il tuo server non accetta non viene reinviata automaticamente: l’API elenca le notifiche fallite (GET /webhooks/notifications/failed) e avvii una nuova consegna per ciascuna con POST /webhooks/notifications/{id}/retry.

No. Il servizio webhook chiama il tuo endpoint pubblico tramite internet — assicurati solo che il tuo firewall consenta il traffico in entrata senza whitelist di IP.

Usa la dashboard di Chaingateway per inviare eventi di test al tuo endpoint, così puoi verificare che il tuo handler elabori correttamente il payload prima di andare in produzione.

Usa l'header X-Signature per verificare che le richieste in entrata provengano davvero da Chaingateway. Questa firma è generata con HMAC SHA-256 usando la tua secret key, garantendo che solo eventi autorizzati vengano elaborati dal tuo endpoint.

Il nostro team di assistenza è qui per aiutarti con qualsiasi domanda o problema tu possa avere. Contattaci tramite la pagina di assistenza sul nostro sito, e saremo felici di aiutarti.

Hai ancora domande?

Siamo qui per fare chiarezza e aiutarti con qualsiasi richiesta tu possa avere.

Migliora la tua pipeline di dati

Pronto per le notifiche di eventi in tempo reale?

Smetti di fare polling e inizia a ricevere aggiornamenti istantanei con i webhook di Chaingateway. Ricevi notifiche sugli eventi blockchain in tempo reale, così puoi reagire più velocemente e costruire applicazioni più reattive.