Webhook-Events

Webhooks sind HTTP-POST-Requests, die platzeo an Ihre Endpoints sendet, sobald etwas passiert.

Registrieren

Unter Admin → Webhooks → Neu:

1. Ziel-URL (https://...)
2. Events abonnieren (Multi-Select)
3. Secret auto-generiert – mit HMAC-SHA256 signieren wir jeden Payload.

Events

• reservation.created
• reservation.confirmed
• reservation.cancelled
• reservation.seated
• reservation.completed
• reservation.no_show
• loyalty.stamp_added
• loyalty.reward_redeemed

Signaturprüfung

Header X-Platzeo-Signature enthält den HMAC. Verify in Node:

const expected = crypto
  .createHmac("sha256", secret)
  .update(rawBody)
  .digest("hex");
const ok = crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(received),
);

Retry

Nicht-2xx-Antworten werden mit exponentiellem Backoff bis zu 5 Mal wiederholt. Danach landet der Delivery-Attempt als failed im Webhook-Log.