Webhook firmati per ogni evento di prenotazione e pagamento
Porta ogni evento di prenotazione e pagamento nei tuoi sistemi — CRM, data warehouse, Slack, integrazioni custom. Firmati in HMAC, ritentati con backoff esponenziale e completamente tracciati. Pensati per team di ingegneria che rifiutano di interrogare un’API a polling.
Perché i team di ingegneria scelgono i webhook di Triviyo
Pattern standard, comportamento prevedibile e un log delle consegne che aiuta davvero a fare debug.
Firme HMAC su ogni payload
Ogni webhook è firmato con HMAC-SHA256 usando il segreto del tuo endpoint. Verifica la firma prima di agire sul payload — stesso pattern di Stripe, GitHub e di ogni altro webhook di cui ti fidi già.
Retry con backoff esponenziale
Se il tuo endpoint non risponde in tempo o restituisce 408, 429 o un 5xx, Triviyo ritenta automaticamente la consegna, fino a 6 tentativi in totale. Qualsiasi altra risposta 4xx è considerata definitiva e non viene ritentata.
Nomi evento standard
BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Iscriviti esattamente agli eventi che serve alla tua integrazione; ignora il resto.
Chiave di firma per ogni endpoint
Ogni endpoint ha la propria chiave di firma, che puoi rigenerare in qualsiasi momento da Impostazioni → Webhook.
Registro completo delle consegne
Ogni tentativo di consegna viene registrato nella dashboard con stato HTTP, risposta e orario.
Webhook Triviyo vs. polling di un’API REST
Come si presenta lo streaming di eventi in tempo reale rispetto al martellare un endpoint REST.
| Cosa porta con sé l’API webhook | Triviyo | Without Triviyo |
|---|---|---|
| Disponibilità | Dal piano Professional in su | Solo con accesso API enterprise |
| BOOKING_CREATED | ||
| BOOKING_UPDATED | ||
| BOOKING_CANCELED | ||
| PAYMENT_SUCCEEDED | ||
| Firme HMAC-SHA256 | Add-on enterprise | |
| Strategia di retry | Fino a 6 tentativi | Un tentativo o nessuno |
| Registro delle consegne | ||
| Assistenza | Supporto prioritario | Coda di ticket via e-mail |
Pattern standard — niente di esotico, niente di proprietario.
Domande frequenti
A quali eventi posso iscrivermi?
BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Iscriviti per endpoint esattamente a ciò che serve alla tua integrazione.
Come verifico che il webhook sia davvero da Triviyo?
Ogni payload è firmato con HMAC-SHA256 usando il secret univoco del tuo endpoint. Verifica l’header X-Webhook-Signature rispetto al body grezzo della richiesta prima di agire — stesso pattern dei webhook di Stripe e GitHub. Nella nostra documentazione trovi esempi di codice.
Cosa succede se il mio endpoint è giù?
Triviyo effettua fino a 6 tentativi di consegna in totale. Dopo l'ultimo, la consegna viene segnata come non riuscita nel registro delle consegne. Una risposta 4xx diversa da 408 e 429 segna subito la consegna come non riuscita, senza ulteriori tentativi.
Posso testare i webhook in un ambiente di staging?
Sì. Invia una consegna di prova a qualsiasi endpoint da Impostazioni → Webhook per verificare l'integrazione prima di andare live.
Quale piano mi serve per i webhook?
Piano Professional e superiori.
Costruisci integrazioni in tempo reale senza polling
Firmato, ritentato, loggato — esattamente come i team di ingegneria si aspettano che funzionino i webhook.
Prova gratuita di 14 giorni. Nessuna carta di credito richiesta. Annulla quando vuoi.