Mx Wolt Integrations Order Restaurant Guide

Introduction

This guide explains how to integrate Wolt's Order API using webhook notifications and pull order payloads, ensuring your system can accept, track, and acknowledge orders in real-time.

Order API is used in conjunction with our order management endpoints, which allow integration partners to ACCEPT, CONFIRM*, REJECT*, MARK-READY* and DELIVERED*. (*- if applicable)

Wolt utilises various order types, which affect the logic of the order flow. Find the following order types below:

  1. Instant Delivery - Order which is placed on Wolt's marketplace and delivered by a WOLT courier and expected to be delivered within the earliest time possible. 

  2. Take-Away Order - Order which is placed on Wolt's marketplace and collected by the consumer, who placed the order. 

  3. Scheduled Order - Order which is placed on Wolt's marketplace and has a targeted delivery date in the future, can be either later same day or up to 7-days ahead. 

  4. Self-Delivery - Order which is placed on Wolt’s marketplace and delivered by a courier employed by the merchants itself. Wolt does not operate the delivery or logistics about these order types. 

    These four different order types utilise distinct endpoints within the order flow of each order type. Please review the flow charts below to familiarise yourself.

Instant Delivery - Orderflow

Scheduled-Order

Confirm-Endpoint to be used for Scheduled order

A scheduled order requires to be "confirmed" by using "/orders/order_id/confirm-preorder" endpoint. The final accpet call will be conducted by WOLT, this accept call will trigger the PRODUCTION webhook to be sent.

Self-Delivery-Order

Attention: Different ACCEPT ENDPOINT MANDATORY CASH OBJECT

Takeaway - Orderflow

ATTN: no pick-up ETA after CREATED WEBHOOK - ONLY after PRODUCTION, as PREPARATION TIME DEFINES IT.