WooCommerce Wolt Shipping Method

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

• PHP: 8.1, 8.2, or 8.3
• ionCube Loader: Required. For version requirements and installation details, see IonCube Loader.
• WooCommerce: 3.6 or higher

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

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.
9. Debug Log: Enable this to log API requests and rate calculation details.

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

Customers can select their precise delivery location using an interactive Google Map during checkout.

The shipping rate is calculated in real time from Wolt's API response for the coordinates selected by the customer.

The plugin supports two registration modes:

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

Tracking links are stored on the WooCommerce order after registration. If Wolt SMS notification text is configured, use the TRACKING_LINK placeholder in the received and picked-up message templates.

When configuring or troubleshooting rates, enable WooCommerce shipping debug mode so cached rates do not hide settings or interactive-map changes:

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

Disable WooCommerce shipping debug mode again after testing because it can affect checkout performance.

Enable Debug Log in the Wolt global or shipping-zone instance settings, then review entries under WooCommerce > Status > Logs using the wolt_shipping_method source.

Type: filter

When: Before Wolt delivery fee calculation — changes the Venue ID used for a package.

The returned Venue ID is used for both the Wolt fee request and the shipping-line metadata later used during registration. This makes the filter suitable for multi-warehouse routing.

add_filter(
    'plugandpay_woocommerce_wolt_shipping_method_calculate_delivery_fee_to_venue',
    function( $venue_id, $package ) {
        if ( 'Batumi' === ( $package['destination']['city'] ?? '' ) ) {
            return 'batumi-venue-id';
        }

        return $venue_id;
    },
    10,
    2
);

The WooCommerce method ID is wolt_shipping_method.

Use the standard woocommerce_package_rates filter to change the Wolt checkout cost or label. See General Shipping Hooks for examples based on cart total, destination city, or products.