Integrate correctly with Wolt to ensure that orders are received

Common causes and how to check them

If your Wolt orders are not appearing correctly in the POS, the following steps may help. Please note: many aspects are outside of our direct control – Wolt manages the technical delivery of orders.

1. Check the connection in the MERGEPORT Controller

• Open controller.mergeport.com and select your restaurant.
• Open Configuration and check that Wolt is still linked to the correct shop. If the platform is missing, incoming orders can no longer be assigned correctly to the restaurant. Do not remove Wolt as the first troubleshooting step.
• If Confirmation pending appears, first check that the Wolt login was completed. Waiting does not complete a missing login.
• Access verified means access was checked. Also check Orders to see whether the specific order arrived and was processed by the POS.

The following image shows the older Online display. Existing connections may still show it; it does not replace checking the order flow.

Open full-size image

2. Restaurant login / Wolt account

The integration is based on an OAuth login with the operator’s Wolt account.

• Verify that the correct account is logged in.
• If login was not completed or access is missing, open the Wolt connection in the Controller and complete the process using Authorize.

3. Menu & item mapping

The required item mapping depends on your POS system and the agreed matching method.

• If your POS requires Wolt-side POS item IDs, check them in the Wolt Merchant Dashboard.
• If you map through MERGEPORT, check the links in the Controller. Update mappings if IDs have changed after a menu update.
• Confirm with your POS provider whether alternative matching or handling of unknown items is supported. See the related item-mapping article for further steps.

4. Align the Wolt tablet and order workflow

Decide whether orders should go directly to the POS or whether the Wolt tablet remains part of the workflow. Settings must match in MERGEPORT and Wolt.

• The direct order workflow uses the “Without Tablet” option. Confirm with your POS provider that the POS supports the intended status flow.
• If you keep using the Wolt tablet, “iPadLess” and “Auto Accept” must be disabled in both systems. Coordinate any required Wolt-side changes with Wolt Support.
• Remove or disable the Wolt tablet only after the tablet-free workflow is fully configured and a first order has been checked successfully through to the POS.

These Wolt settings are separate from Tablet Mode in the MERGEPORT Controller, which controls manual acceptance within MERGEPORT.

5. Integration activation / approval by Wolt

Even if Wolt shows “Access verified” or the older “Online” display in the MERGEPORT Controller, Wolt-side approval or configuration steps may still be outstanding.

• Check whether Wolt has confirmed the POS integration for the intended order workflow. Contact Wolt Support for outstanding approvals or routing settings.
• After setup, check a first order to verify that it appears in the Controller and that the POS receives and processes it correctly.