Hybrid Delivery
Use case
Wolt provides merchants an end-to-end experience as a delivery platform. This experience includes the Wolt Delivery service, with our Courier Partners picking up and delivering your orders to the customers.
For some merchants, delivering the orders is something they do themselves, but still want to appear on the Wolt platform, get more orders from Wolt users, leverage Wolt’s other services and more.
These merchants are called “Self-delivery” merchants. In order to self-deliver using integrations, merchants are expected to have an integration that supports a set of APIs, as described in this page.
Some of these Self-delivery merchants, still experience their own logistics issues - be it a courier that didn’t show up to work, bikes that are out of order or any other reason, sometimes the merchant can’t deliver by themselves.
In such cases, merchants can leverage Wolt’s Hybrid Delivery option and stay in business for delivery, even when they have issues providing their own delivery.
Leveraging Hybrid delivery also requires a suitable commercial agreement by the merchant and the local Wolt team. Reach out to your Wolt Account Manager for more information on that.
Scope of this integration
This integration allows a merchant to switch between Wolt delivery and Self-delivery methods of fulfillment. These changes are expected to happen periodically, not more than a couple of times a day.
This integration currently does not allow management of delivery areas, reductions in delivery radius or changes to pricing.
APIs to use for this integration
To leverage Hybrid Delivery directly from your own system, you can use these APIs:
If you want to manage all orders’ fulfillment from your system, and have Hybrid Delivery working properly, you also need to make sure you support Wolt delivery order flows and Self-delivery order flows.
Using these APIs will not change the delivery provider for any order in-flight. Only new orders will be impacted. Each order has its delivery provider finalized when created by the user.
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.