Vérifier les signatures des webhooks
Ce que nous envoyons
Chaque webhook est une requête POST en JSON vers l’URL de webhook de votre boutique, avec ces en-têtes :
ArionPay-Event: l’une des valeursinvoice.pending,invoice.partial,invoice.paid,invoice.expiredouinvoice.needs_review.ArionPay-Event-Id: un ID unique. Conservez-le et ignorez les doublons.ArionPay-Signature:t=<timestamp>,v1=<hex>, où v1 est le HMAC-SHA256 de<timestamp>.<raw body>, signé avec le secret de webhook de votre boutique.
Avant de traiter une commande
- Calculez la signature à partir du corps brut de la requête et comparez-la en temps constant.
- Rejetez les horodatages trop anciens (nous suggérons au-delà de 5 minutes).
- Utilisez l’ID d’événement pour qu’un envoi répété n’expédie pas une commande deux fois.
- Retrouvez la commande grâce à
data.invoice.id(enregistré lors de la création de la facture) et vérifiezamountFiatetcurrency. - Répondez avec un statut 2xx dans les 10 secondes. Les autres réponses, les redirections et les délais dépassés donnent lieu à de nouveaux envois pendant environ 3 jours.
Les webhooks des factures test sont marqués comme test (livemode: false). En production, n’agissez que sur livemode: true. Le secret de webhook (whsec_…) n’est pas votre secret API : vous l’obtenez sur la page Webhooks avec « 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'));
}