Webhook-Signaturen prüfen
Was wir senden
Jeder Webhook ist ein JSON-POST an die Webhook-URL Ihres Shops mit diesen Headern:
ArionPay-Event: einer der Werteinvoice.pending,invoice.partial,invoice.paid,invoice.expiredoderinvoice.needs_review.ArionPay-Event-Id: eine eindeutige ID. Speichern Sie sie und ignorieren Sie Wiederholungen.ArionPay-Signature:t=<timestamp>,v1=<hex>, wobei v1 der HMAC-SHA256 von<timestamp>.<raw body>ist, signiert mit dem Webhook-Secret Ihres Shops.
Bevor Sie eine Bestellung ausführen
- Berechnen Sie die Signatur aus dem unveränderten (rohen) Request-Body und vergleichen Sie sie in konstanter Zeit.
- Lehnen Sie alte Zeitstempel ab (wir empfehlen: älter als 5 Minuten).
- Nutzen Sie die Event-ID, damit eine wiederholte Zustellung eine Bestellung nicht doppelt ausliefert.
- Finden Sie die Bestellung über
data.invoice.id(beim Erstellen der Rechnung gespeichert) und prüfen SieamountFiatundcurrency. - Antworten Sie innerhalb von 10 Sekunden mit einem 2xx-Status. Bei anderen Antworten, Weiterleitungen und Zeitüberschreitungen wird die Zustellung etwa 3 Tage lang wiederholt.
Webhooks von Testrechnungen sind als Test markiert (livemode: false). Reagieren Sie im Live-Betrieb nur auf livemode: true. Das Webhook-Secret (whsec_…) ist nicht Ihr API-Secret: Sie erhalten es auf der Seite „Webhooks“ mit „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'));
}