Sviluppatori

Webhook

I tuoi sistemi sanno cosa succede nel tuo workspace: chiamate firmate per gli eventi che scegli, ritentate e registrate.

Gli eventi

  • Partner: creato, aggiornato, eliminato, stato cambiato, livello cambiato, gestore cambiato.
  • Metodi di pagamento: creato, aggiornato.
  • Richieste da modulo: creata, aggiornata, eliminata.
  • Conversioni: creata, aggiornata, stato cambiato.
  • Liquidazioni e pagamenti: liquidazione creata, stato del pagamento cambiato.
  • Offerte: creata, aggiornata, eliminata; accesso concesso, accesso revocato.
  • Postback: non riuscito.
  • White label: creato, aggiornato, eliminato.

Crearne uno

  1. Impostazioni › Sviluppatori › Webhook › Nuovo webhook: l’URL del tuo endpoint e gli eventi.
  2. Invia solo se (facoltativo): regole sui campi del record, tutte o almeno una, confrontando con un valore, un elenco o un altro campo.
  3. Cosa inviare: Compatibile (forme brevi che un’integrazione esistente si aspetta) o Record completo (ogni campo, con i valori prima e dopo per le modifiche). L’esempio si aggiorna mentre scegli.
  4. Intestazioni extra, se il tuo endpoint ne ha bisogno.

Controllare la firma

Ogni chiamata ha un’intestazione Signature: l’HMAC-SHA256 del corpo con il segreto di firma del tuo webhook. Il segreto viene mostrato una volta alla creazione del webhook; Nuovo segreto lo sostituisce.

Invii

  • Una chiamata a cui il tuo server non risponde bene viene ritentata.
  • Il registro degli invii mostra ogni chiamata, i suoi tentativi e cosa è stato inviato; Invia di nuovo ne ripete una.
  • Invia prova manda un evento con il tuo ultimo record reale (o un esempio).
  • Dopo 20 errori di fila il webhook si mette in pausa da solo e ricevi un avviso. Sistema l’endpoint, poi Riprendi.

Verificato con l’app il 18 ottobre 2026