Webhooks firmados para cada evento de reserva y pago
Transmite cada evento de reserva y pago a tus propios sistemas: CRM, data warehouse, Slack, integraciones a medida. Firmados con HMAC, reintentos con backoff exponencial y registro completo de entregas. Pensados para equipos de ingeniería que se niegan a hacer polling de una API.
Por qué los equipos de ingeniería eligen los webhooks de Triviyo
Patrones estándar, comportamiento predecible y un registro de entregas que de verdad te ayuda a depurar.
Firmas HMAC en cada payload
Cada webhook se firma con HMAC-SHA256 usando el secreto de tu endpoint. Verifica la firma antes de actuar sobre el payload: el mismo patrón que Stripe, GitHub y cualquier otro webhook en el que ya confías.
Reintentos con backoff exponencial
Si tu endpoint no responde a tiempo o devuelve 408, 429 o un 5xx, Triviyo reintenta la entrega automáticamente, hasta 6 intentos en total. Cualquier otra respuesta 4xx se considera definitiva y no se reintenta.
Nombres de eventos estándar
BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Suscríbete exactamente a los eventos que necesita tu integración; ignora el resto.
Clave de firma por endpoint
Cada endpoint tiene su propia clave de firma, que puedes regenerar en cualquier momento en Ajustes → Webhooks.
Registro completo de entregas
Cada intento de entrega queda registrado en el panel con su estado HTTP, respuesta y hora.
Webhooks de Triviyo vs. polling a una API REST
Cómo es la transmisión de eventos en tiempo real frente a machacar un endpoint REST.
| Qué incluye la API de webhooks | Triviyo | Without Triviyo |
|---|---|---|
| Disponibilidad | Desde Professional | Solo con acceso API Enterprise |
| BOOKING_CREATED | ||
| BOOKING_UPDATED | ||
| BOOKING_CANCELED | ||
| PAYMENT_SUCCEEDED | ||
| Firmas HMAC-SHA256 | Add-on Enterprise | |
| Estrategia de reintentos | Hasta 6 intentos | Un intento o ninguno |
| Registro de entregas | ||
| Soporte | Soporte prioritario | Cola de tickets por email |
Patrones estándar: nada exótico, nada propietario.
Preguntas frecuentes
¿A qué eventos puedo suscribirme?
BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Suscríbete por endpoint exactamente a lo que necesita tu integración.
¿Cómo verifico que el webhook viene realmente de Triviyo?
Cada payload se firma con HMAC-SHA256 usando el secreto único de tu endpoint. Verifica la cabecera X-Webhook-Signature contra el cuerpo de la petición antes de actuar: el mismo patrón que los webhooks de Stripe y GitHub. Hay ejemplos de código en nuestra documentación.
¿Qué pasa si mi endpoint está caído?
Triviyo realiza hasta 6 intentos de entrega en total. Tras el último, la entrega se marca como fallida en el registro de entregas. Una respuesta 4xx distinta de 408 y 429 marca la entrega como fallida de inmediato, sin reintentos.
¿Puedo probar los webhooks en un entorno de staging?
Sí. Envía una entrega de prueba a cualquier endpoint desde Ajustes → Webhooks para comprobar tu integración antes de publicarla.
¿Qué plan necesito para los webhooks?
Desde Professional.
Crea integraciones en tiempo real que no hacen polling
Firmado, reintentado, registrado: exactamente como esperan los equipos de ingeniería que funcionen los webhooks.
14 días de prueba gratis. Sin tarjeta de crédito. Cancela cuando quieras.