Ordering and booking on any website
The restaurant's own Taventi site (restaurant.taventi.app) is built on the same SDK and API, so nothing here is second-class: a restaurant can move from its Taventi site to your custom site without losing its menu, orders or bookings.
Before you start
- The restaurant has a Taventi account, with its menu filled in and takeaway or reservations turned on (Settings → Locations).
- You know its location slug, e.g.
beastie-antwerp. The restaurant finds it, with ready-made code, under Website & widgets in its dashboard. - Every public endpoint works without a key. Keys with permissions for agencies come later.
How it works
Money
Every amount is an integer number of cents in euros: 1250 is €12.50. Taventi computes every price and total on the server from the restaurant's menu; prices sent by a website are never trusted. Show the totals the API returns.
Languages
Restaurant content (names, descriptions) comes in Dutch, French and English as { "nl": "…", "fr": "…", "en": "…" }; a language can be missing, so fall back to another. Orders and bookings take a locale for the guest's emails.
Times
Times are ISO 8601 with an offset (2026-12-04T19:30:00+01:00); dates are YYYY-MM-DD in the location's time zone (Europe/Brussels).
Payment
Guests pay at pickup for now: say so clearly at checkout. There is no online payment in the API yet.
Placing an order twice
Creating an order or a booking needs an Idempotency-Key header: a new random value per checkout, sent again unchanged when you retry. A retry with the same key returns the first order instead of a second one, so a double click or a lost connection never makes two orders.
Errors
Every error has the same shape, with a stable code to act on:
{
"error": {
"code": "pickup_time_unavailable",
"message": "That pickup time isn't available anymore. Choose another one."
}
}| Status | Meaning |
|---|---|
| 400 | The request doesn't match the schema; details lists each field. |
| 404 | No such location, order or booking. |
| 409 | It can't be done now: closed, sold out, the time was just taken… |
| 422 | A cart line can't be ordered as sent (cart_invalid). |
| 429 | Too many requests from this IP address: wait and retry. |