Skip to content

WooCommerce Wolt Shipping Method

Documentation for the Plug and Pay WooCommerce Wolt Shipping Method plugin.

Requirements

Technical Requirements

  • PHP: 8.1, 8.2, or 8.3
  • ionCube Loader: Required. For more details, check the ionCube Manual.
  • WooCommerce: 3.6 or higher

Store Setup Prerequisites

  • Google Maps API Key: Required for the interactive map selection.
  • Wolt Credentials: A Venue ID and Merchant Key provided by Wolt.

Technical Specification & Feature Support

FeatureSupported
HPOS✅
Shipping Zones✅
Real-time Rates✅
Interactive Map✅
Parcel RegistrationManual or Automatic
Tracking✅
Test Mode✅
Configurable Map Position✅

Setup

Global Settings

Go to WooCommerce > Settings > Shipping > Wolt to configure the global API settings:

  1. Venue Id: Provided by Wolt.
  2. Merchant Key: Your Wolt Merchant Key.
  3. Google Map Key: Required to display the map for point selection.
  4. Customer Support Email & Phone: Contact details for delivery support.
  5. SMS Notifications: Customize the text for "Received" and "Picked up" SMS alerts. Use TRACKING_LINK placeholder.
  6. Min Preparation Time: Set how many minutes the venue needs to prepare the order (Max 60 min).
  7. Registration Mode: Choose between Manual or Automatic registration.
  8. Map Position: Choose where the interactive map appears on the checkout page — after address line 1, after city, or after postcode.

Shipping Zones

After configuring the global settings, add the Wolt delivery method to your desired shipping zones under WooCommerce > Settings > Shipping > Shipping zones.

Debugging

WooCommerce Shipping Debug Mode

When setting up or troubleshooting shipping rates, it is highly recommended to enable WooCommerce Shipping Debug Mode. This prevents WooCommerce from caching shipping rates, ensuring that every change you make to settings or the interactive map is reflected immediately.

To enable it:

  1. Go to WooCommerce > Settings > Shipping > Shipping options.
  2. Check the Enable debug mode box.
  3. Save changes.

Note: Remember to disable this once your store is live, as it can impact performance.

Features

Interactive Map

Customers can select their precise delivery location using an interactive Google Map during checkout. The shipping rate is calculated in real-time based on Wolt's API response for the selected coordinates.

Parcel Registration

The plugin supports two registration modes:

  • Manual (Default): Store administrators manually register the parcel from the WooCommerce order details page.
  • Automatic: Parcels are automatically registered with Wolt as soon as the order payment is completed.

Shipment Tracking

Tracking links are generated and sent to customers via SMS notifications, allowing them to monitor their delivery in real-time.