Webhooks
Univooz sends each order event to your endpoint, with a signature.
Webhooks need a plan with features_advancedApi. On Standard, Univooz sends nothing and
you cannot add an endpoint. See Plans and payment.
Add endpoints in the dashboard, in Developers → Webhooks. Test and live have different URLs and different secrets. A test event can never go to your production receiver.
The message
{
"id": "evt_01J8ZQ4M7X",
"type": "order.picked_up",
"created": "2026-07-29T14:32:00+02:00",
"livemode": true,
"data": { }
}data is the full order object at the time of the event, not the current
order. To get the current order, read it with its reference.
request_id is not in data. Use id for the event and data.reference for the order.
Three rules for your receiver
Check every signature
Three details decide if your check operates correctly.
Accept repeats
Univooz can send an event more than one time. Use id to find repeats.
Answer in 10 seconds
A slower answer is a failure, and Univooz sends the event again.
Webhooks or polling
| Webhooks | Polling | |
|---|---|---|
| Plan | Advanced | Standard |
| Speed | Immediate | Your interval, 30 seconds minimum |
| You must supply | A public endpoint with security | A loop, and rate limit capacity |
Use both. Webhooks give speed. A regular read of GET /v1/orders finds anything a failed
delivery lost. See Page through lists.