Ir al contenido
ArionPay

Base de conocimiento · 4 min de lectura

Verificar las firmas de webhook

Comprueba el encabezado ArionPay-Signature de cada webhook antes de completar un pedido.

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 de invoice.pending, invoice.partial, invoice.paid, invoice.expired o invoice.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

  1. Calcula la firma a partir del cuerpo sin procesar de la solicitud y compárala en tiempo constante.
  2. Rechaza las marcas de tiempo antiguas (sugerimos más de 5 minutos).
  3. Usa el ID del evento para que una entrega repetida no envíe un pedido dos veces.
  4. Busca el pedido por data.invoice.id (guardado al crear la factura) y comprueba amountFiat y currency.
  5. 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'));
}