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ændelse | Hvornår |
|---|---|
order.created | En ny ordre: kontant ved oprettelsen, kort og MobilePay når betalingen er gået igennem |
order.status_changed | Ordrens status er ændret, fx til confirmed eller ready |
order.cancelled | Ordren 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=…, hvorv1er 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 headerenX-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.