Webhooks and API
Connect a restaurant to the rest of your stack
Subscribe an HTTPS endpoint to the events you care about. Every delivery is signed, logged and retried, so your system can trust it and you can see what happened.
Webhooks
A restaurant adds an endpoint in the dashboard and picks its events. Restro posts JSON to it as things happen.
Events
| order.created | A new order from any channel |
|---|---|
| order.status_changed | An order moved to a new status |
| order.completed | An order was completed |
| order.cancelled | An order was cancelled |
| payment.captured | A payment was captured |
| payment.refunded | A payment was refunded |
| reservation.created | A table was booked |
| reservation.cancelled | A booking was cancelled |
| customer.created | A new customer record |
| review.created | A guest left a review |
| inventory.low_stock | A stock item reached its reorder point |
| subscription.updated | The restaurant’s plan changed |
Signed, logged, retried
Signature
X-Restro-Signature: t=<unix seconds>,v1=<HMAC-SHA256 of “t.body”> with your endpoint secret. Reject anything that does not verify.
Headers
X-Restro-Event names the event and X-Restro-Delivery identifies the delivery, so a retry can be recognised.
Retries and log
A failed delivery is retried with back-off, up to six attempts, and every attempt is visible in the dashboard’s delivery log.
Safe targets
Endpoints must be public HTTPS addresses; redirects are not followed, so a delivery cannot be bounced to an internal address.
The API
Developer API keys (rtd_…) carry explicit scopes — today the theme platform’s: themes:read, themes:submit and themes:withdraw. The REST API under /api/v1 is the one the dashboard, the till and the owner app use; API access and the daily call allowance are plan features.
Need wider API access for an integration — accounting, a delivery app, a loyalty provider? Tell us what you are connecting and we will work through it with you.
Put the whole thing on one system
Start on the free plan and see it with your own menu — the offline till included. Nothing to cancel if it is not for you.
- No card needed
- Arabic and English, built in
- Sells offline on every plan