Retail lite API integration
APIs to use for this integration
Merchant App needed for picking products and in-store operations.
Authentication
The Wolt Marketplace APIs use the bearer token authentication method. To authenticate your requests, include your access token in the Authorization header of each request. Replace {{access_token}} in the example requests with the actual access token obtained through the OAuth 2.0 flow.
To retrieve the token, you need to setup OAuth 2.0 authentication.
Menu integration workflow
Get menu and items update API have a rate limit of 1 call every 15 minutes and inventory update API has a rate limit of 1 call every 5 minutes. All rate limits are at the venue level.
Get menu
Menu API allows integrated partners to pull menus from a Wolt venue. This allows our partners to keep track of what is being sold and mark items and options out of stock without needing to build a full fledged menu editor.
For details, refer to get menu endpoint.
Update item details
Items are products for sale on a menu. They are also called offerings on the Wolt platform. Items may experience outage or price changes over time. These changes can be pushed to a venue's menu using the items update endpoint. Discounted prices for items can also be set using this endpoint.
For details, refer to update menu items endpoint.
Update item inventory
Item inventory at a venue changes over time. To ensure that consumers on Wolt do not select an out of stock item, you can send store specific inventory updates from your ERP/POS.
For details, refer to update item inventory endpoint.
Venue integration workflow
Partner's Wolt venues can be managed directly from POS or a partner's back office.
Get venue status
You can pull a venue's statuses and put them onto a dashboard. This allows partners to track offline times and situations where a venue is offline and needs to be put back online.
The API also returns 3 latest order statuses which can be used to gauge the "health" of a venue. If orders are getting rejected, steps to remedy the situation can be taken.
For details, refer to get venue status endpoint.
Set venue offline or online
Venues can be set offline using the offline endpoint. The same endpoint can be used to set a venue online by specifying it in the payload.
For details, refer to update venue online status endpoint.
Update venue opening times
A venue's opening hours can be set directly from POS or from a partner's back office system.
For details, refer to update venue opening times endpoint.