FAQ

How often should I call /ping? There is no requirement. Call it at start-up and when you need the connection's state. Everything that changes reaches you as a webhook event.

I lost my copy of the menu. How do I get it again? Download it from menuUrl (in GET /ping) or from the last menu.updated's url. There is no resend: the URL always serves the current menu.

What happens if my menu is out of date when an order comes in? The order is accepted. Deleted products arrive with your name, price and tax rate; switched-off products are matched as usual. Your prices are always used.

Can a customer's price differ from the menu file's price? Yes. We take your price as sent and only check that your own sums add up. The menu file's prices are the restaurant's list prices for your shop.

Why is my order answered 409 STORE_OFFLINE? The restaurant has paused orders through this connection. You get store.status_changed when it goes back online; then send the order again unchanged, if it is still wanted.

Do I need an Idempotency-Key? No. Retry with the same externalId and the same body; we answer the first receipt with duplicate: true.