Zum Inhalt springen
ArionPay

Wissensdatenbank · 4 Min. Lesezeit

Webhook-Signaturen prüfen

Prüfen Sie den Header ArionPay-Signature bei jedem Webhook, bevor Sie eine Bestellung ausführen.

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 Werte invoice.pending, invoice.partial, invoice.paid, invoice.expired oder invoice.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

  1. Berechnen Sie die Signatur aus dem unveränderten (rohen) Request-Body und vergleichen Sie sie in konstanter Zeit.
  2. Lehnen Sie alte Zeitstempel ab (wir empfehlen: älter als 5 Minuten).
  3. Nutzen Sie die Event-ID, damit eine wiederholte Zustellung eine Bestellung nicht doppelt ausliefert.
  4. Finden Sie die Bestellung über data.invoice.id (beim Erstellen der Rechnung gespeichert) und prüfen Sie amountFiat und currency.
  5. 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'));
}