Spring til indholdet

POS-API · Webhooks

Få nye ordrer skubbet til jer

I stedet for at spørge efter nye ordrer kan I få dem skubbet til jer. Her er hændelserne, hvad de indeholder, og hvordan I tjekker, at de kommer fra os.

Webhooks

I stedet for at polle kan I få nye ordrer skubbet til jer. Webhooks sættes op af WalletPlus: skriv til os med jeres URL (https) og hvilke hændelser I vil have, så får I en signing secret tilbage.

HændelseHvornår
order.createdEn ny ordre: kontant ved oprettelsen, kort og MobilePay når betalingen er gået igennem
order.status_changedOrdrens status er ændret, fx til confirmed eller ready
order.cancelledOrdren er annulleret

Payloaden er tynd med vilje: den bærer id og status, ikke ordrens indhold. Hent ordren med GET /orders/{orderId} — det kald håndhæver adgangen, så en webhook aldrig bliver en vej uden om den.

Payload
{
  "event_id": "b2b7c1d0-3e4f-4a5b-8c6d-7e8f9a0b1c2d",
  "event_type": "order.created",
  "created_at": "2026-09-24T10:00:02.512Z",
  "company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
  "data": {
    "order_id": "7c1f2a90-4b1e-4e0a-9c6d-2f8e1a3b5c7d",
    "order_number": "1042",
    "status": "pending",
    "order_type": "pickup"
  }
}
Verificér signaturen (Node)
import crypto from 'node:crypto';

// rawBody: bodyen præcis som den kom ind — ikke parset og serialiseret igen.
export function verifyWalletPlusSignature(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.trim().split('=')));
  const t = Number(parts.t);
  // Afvis gamle leverancer, så en opsnappet besked ikke kan afspilles igen.
  if (!t || !parts.v1 || Math.abs(Date.now() / 1000 - t) > 300) return false;

  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${parts.t}.${rawBody}`)
    .digest('hex');
  return (
    expected.length === parts.v1.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1))
  );
}
  • Signaturen står i X-WalletPlus-Signature: t=…,v1=…, hvor v1 er HMAC-SHA256 af "<t>.<rå body>" med jeres signing secret, i hex.
  • Svar 2xx inden for 10 sekunder. Ellers prøver vi igen efter 1 min, 5 min, 25 min, 2 timer og 10 timer.
  • Svar direkte. Vi følger ikke redirects; en 3xx tæller som en fejlet leverance.
  • Hændelser kommer kun med adgangen orders:read, og de stopper med det samme, hvis adgangen trækkes tilbage.
  • Dedupliker på event_id (også i headeren X-WalletPlus-Event-Id) — samme hændelse kan komme mere end én gang.
  • Fejler 20 leverancer i træk, slår vi endpointet fra.
  • Polling er stadig jeres sikkerhedsnet: en tabt webhook findes ved næste hentning.