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,".
- Lee el cuerpo de la solicitud tal como llegó, sin volver a serializar el JSON.
- Une webhook-id, webhook-timestamp y el cuerpo, separados por un punto.
- Calcula el HMAC-SHA256 de esa cadena con el secreto del endpoint y codifícalo en base64.
- Compara el resultado con el valor que sigue a "v1," usando una comparación de tiempo constante.
- 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().