Webhooks

Sviluppatori

Gli endpoint che chiamiamo quando accade un evento da lei — un pagamento completato, un versamento fallito, una contestazione aperta.

Senza endpoint, la sua integrazione deve interrogare la piattaforma. Con uno, gli esiti le vengono inviati, firmati.

Aggiungere un endpoint

Un URL https e l'elenco degli eventi che le interessano. Nessun evento spuntato = tutti.

Il segreto di firma è mostrato una volta sola, alla creazione.

Rinnovare un segreto senza rompere nulla

È una manovra in due tempi, ed è voluto:

1. Rinnova aggiunge un secondo segreto. Entrambi sono validi — il suo endpoint ha tempo di accettare il nuovo.
2. Promuovi rende il nuovo l'unico valido.

Promuova solo quando il suo endpoint accetta il nuovo segreto. Le consegne firmate con il vecchio cessano di essere verificabili immediatamente.

Un segreto promosso non è più leggibile qui. Perso, si rinnova — non si recupera.

Verificare

Invia un evento di prova esegue una consegna reale ai suoi endpoint attivi e mostra il codice di risposta e la durata. Se nulla è abbonato all'evento, la schermata lo dice invece di lasciarle credere a un successo.

Metti in pausa ferma le consegne senza cancellare la configurazione.

Il dettaglio consegna per consegna è in Registri sviluppatore; il formato dei messaggi è descritto nella guida Webhook.

— /dashboard/webhooks