Developer contract

Events & webhooks

Platform-neutral events let Joomla, payments, messaging and calendar adapters subscribe without changing the booking core.

Core events

Delivery rules

Signed payloads

HMAC signature and timestamp prevent spoofing/replay.

Required

Idempotency

Every event carries a stable event ID.

Required

Retry queue

Exponential retry with dead-letter inspection.

Specified

Example envelope

event_id: evt_01K...
type: booking.created
version: 1
occurred_at: 2026-09-26T09:00:00+01:00
business_id: biz_demo
aggregate_id: BK-1042
correlation_id: req_01K...
payload: { booking_id, customer_id, starts_at, status }