DEVSDESIGN — DEVELOPERS & DESIGN

Cómo verificar la firma de un webhook

Comprueba que cada evento proviene de la plataforma antes de procesarlo.

Webhooks · Actualizado el

Cada entrega incluye tres encabezados: webhook-id, webhook-timestamp y webhook-signature. La firma es un HMAC-SHA256 en base64, con el prefijo "v1,".

  1. Lee el cuerpo de la solicitud tal como llegó, sin volver a serializar el JSON.
  2. Une webhook-id, webhook-timestamp y el cuerpo, separados por un punto.
  3. Calcula el HMAC-SHA256 de esa cadena con el secreto del endpoint y codifícalo en base64.
  4. Compara el resultado con el valor que sigue a "v1," usando una comparación de tiempo constante.
  5. Rechaza el evento si la firma no coincide o si la marca de tiempo es demasiado antigua.

Los SDK de JavaScript y PHP incluyen esta verificación en Webhook.verify().