Glossario · ThinkClouds

Webhook

Richiesta HTTP con cui un servizio avvisa un altro sistema che è successo qualcosa, come un pagamento riuscito, senza che questo debba chiederlo.

Un webhook è una richiesta HTTP che un servizio invia a un indirizzo stabilito quando succede un evento: un pagamento riuscito, un rimborso, un abbonamento annullato, un nuovo ordine. È il contrario del controllo periodico: invece di chiedere ogni minuto “è successo qualcosa?”, il sistema riceve la notizia nel momento in cui accade. Il destinatario espone un indirizzo, detto endpoint, e il servizio vi invia un messaggio, di solito in JSON, con i dettagli dell’evento.

Perché servono nei pagamenti

Quando una persona paga online, il passaggio dal sito al servizio di pagamento e ritorno non è affidabile come sembra: chi paga può chiudere la finestra prima del ritorno, la connessione può cadere, alcuni pagamenti vengono confermati solo dopo ore o giorni. Se il sito si fidasse solo del ritorno del browser, perderebbe conferme o, peggio, accetterebbe come pagati ordini mai pagati. Il webhook arriva direttamente dal servizio di pagamento al server del sito, indipendentemente dal browser, ed è quindi la fonte affidabile dello stato del pagamento.

Sicurezza

Un endpoint di webhook è un indirizzo pubblico, e chiunque potrebbe inviargli un messaggio falso. Per questo i servizi firmano i messaggi: Stripe, per esempio, aggiunge un’intestazione con una firma HMAC calcolata con un segreto condiviso e con l’ora dell’invio, e la documentazione chiede di verificarla e di rifiutare i messaggi troppo vecchi. Un webhook va inoltre gestito come idempotente: lo stesso evento può arrivare più volte, e non deve produrre due ricevute o due iscrizioni.

Nei plugin ThinkClouds

ThinkDonate riceve le conferme dei pagamenti dai webhook di Stripe e di PayPal, a indirizzi dedicati della sua REST API, con verifica della firma; la scheda dei pagamenti elenca gli eventi da attivare nel pannello del fornitore, e i controlli di salute del plugin verificano la configurazione dei webhook. SkiTour Manager usa un webhook firmato di Stripe per l’esito dei pagamenti online. Lo stesso principio, con la direzione invertita, regola gli avvisi immediati che ThinkWatch invia a ThinkRepo quando un sito ha un errore fatale.

Fonti

Serve aiuto?

Installiamo, configuriamo e colleghiamo il plugin al tuo sito, con i template Elementor già pronti.