Webhooks

A webhook tells another system the moment something happens in Kripos: an order is paid, stock runs low, a booking is made. Owners manage webhooks on Integrations.

Add a webhook

1. Open Integrations and choose New webhook.
2. Enter the address that receives it (it must start with https://) and a description.
3. Tick the events to send (for example pos.order.closed.v1, inventory.stock.low.v1). They come from the modules you have installed.
4. Save, then copy the signing secret: it’s shown once.

What the other system receives

Each event is a POST of JSON with id, type, occurred_at, tenant_id, outlet_id and data. The header X-Kripson-Signature: t=…,v1=… is an HMAC-SHA256 of "<t>.<body>" with your signing secret. The receiving system should check it, and that t is recent, before trusting the event.

Deliveries and retries

• An answer of 2xx within 10 seconds counts as delivered.
• Anything else is tried again after 1 minute, 5 minutes, 30 minutes, 2 hours and 8 hours, then marked failed.
• The delivery log shows the last 50 attempts with the answer each got. Choose Send again on any delivery.
• Send test sends a test event so you can check the receiving end.

Switch off or delete

Switch a webhook off to stop sending for a while, or delete it (its log goes too).