Aller au contenu
ArionPay

Base de connaissances · 4 min de lecture

Vérifier les signatures des webhooks

Vérifiez l’en-tête ArionPay-Signature de chaque webhook avant de traiter une commande.

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 valeurs invoice.pending, invoice.partial, invoice.paid, invoice.expired ou invoice.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

  1. Calculez la signature à partir du corps brut de la requête et comparez-la en temps constant.
  2. Rejetez les horodatages trop anciens (nous suggérons au-delà de 5 minutes).
  3. Utilisez l’ID d’événement pour qu’un envoi répété n’expédie pas une commande deux fois.
  4. Retrouvez la commande grâce à data.invoice.id (enregistré lors de la création de la facture) et vérifiez amountFiat et currency.
  5. 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'));
}