Verificar las firmas de webhook
Qué enviamos
Cada webhook es un POST con JSON a la URL de webhook de tu tienda, con estos encabezados:
ArionPay-Event: uno deinvoice.pending,invoice.partial,invoice.paid,invoice.expiredoinvoice.needs_review.ArionPay-Event-Id: un ID único. Guárdalo e ignora las repeticiones.ArionPay-Signature:t=<timestamp>,v1=<hex>, donde v1 es el HMAC-SHA256 de<timestamp>.<raw body>firmado con el secreto de webhook de tu tienda.
Antes de completar un pedido
- Calcula la firma a partir del cuerpo sin procesar de la solicitud y compárala en tiempo constante.
- Rechaza las marcas de tiempo antiguas (sugerimos más de 5 minutos).
- Usa el ID del evento para que una entrega repetida no envíe un pedido dos veces.
- Busca el pedido por
data.invoice.id(guardado al crear la factura) y compruebaamountFiatycurrency. - Responde con un estado 2xx en menos de 10 segundos. Las demás respuestas, las redirecciones y los tiempos de espera agotados se reintentan durante unos 3 días.
Los webhooks de las facturas de prueba están marcados como prueba (livemode: false). En producción, actúa solo cuando sea livemode: true. El secreto de webhook (whsec_…) no es tu secreto de API: lo obtienes en la página Webhooks con “Replace secret”.
// Node.js
const crypto = require('crypto');
// rawBody: the request body exactly as received (a string), before any JSON parsing
function verifyArionPayWebhook(rawBody, header, secret, toleranceSec = 300) {
const parts = Object.fromEntries(header.split(',').map((p) => p.trim().split('=')));
const ts = parts.t || '';
const given = parts.v1 || '';
if (!/^\d+$/.test(ts) || Math.abs(Date.now() / 1000 - Number(ts)) > toleranceSec) return false;
if (!/^[0-9a-f]{64}$/.test(given)) return false;
const expected = crypto
.createHmac('sha256', secret)
.update(`${ts}.${rawBody}`)
.digest();
return crypto.timingSafeEqual(expected, Buffer.from(given, 'hex'));
}