Webhook (API)

Actualizado el 21 de octubre de 2025

¿Qué es un Webhook (API)?

Definición breve: Un webhook es una notificación HTTP que un servicio envía a tu endpoint cuando ocurre un evento (por ejemplo, “pago completado” o “issue creada”).

Ejemplo rápido

// Ejemplo en Node.js (Express) recibiendo un webhook
app.post('/webhooks/pagos', express.json(), (req, res) => {
  const evento = req.body;
  // 1) Validar firma del proveedor (cabecera)
  // 2) Procesar el evento (idempotencia: evita duplicados)
  // 3) Responder 2xx rápidamente
  res.sendStatus(200);
});
Receptor básico de webhook con validación e idempotencia.

¿Por qué importa?

Permiten integraciones reactivas sin polling continuo, reduciendo latencia y consumo. Debes implementar verificación de firma, reintentos y idempotencia para que el sistema sea robusto.

Mini-FAQ

¿Qué pasa si mi servidor está caído?

Muchos proveedores reintentan varias veces. Implementa colas y registros para re-procesar cuando vuelva el servicio.

¿Cómo valido que el webhook es auténtico?

Los proveedores envían una firma (HMAC) en cabeceras. Recalcula la firma con tu secret y compárala de forma constante.

Términos relacionados

Scroll al inicio