foodticket/wolt

A Laravel client to integrate with the Wolt API

v0.0.13 2026-04-15 08:14 UTC

Requires

• php: ^8.2
• laravel/framework: ^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^9.0|^10.0

MIT

• Foodticket
• Rik

• php
• delivery
• api client
• wolt
• foodticket

README

A PHP client to integrate with the Wolt POS Integration API for Laravel.

Installation

composer require foodticket/wolt

The service provider is auto-discovered and registers itself automatically.

Publish the config file:

php artisan vendor:publish --tag=wolt-config

Configuration

Add the following variables to your .env file:

WOLT_CLIENT_ID=
WOLT_CLIENT_SECRET=
WOLT_WEBHOOK_SECRET=
WOLT_REDIRECT_URI=https://your-app.com/wolt/oauth/callback

Routes

Register the Wolt routes in your RouteServiceProvider:

use Illuminate\Support\Facades\Route;

Route::woltWebhooks();       // POST /wolt/orders
Route::woltOAuthCallback();  // GET  /wolt/oauth/callback

Both macros accept an optional URI argument to override the default path:

Route::woltWebhooks('custom/wolt/orders');
Route::woltOAuthCallback('custom/wolt/oauth/callback');

Webhooks

The webhook endpoint accepts incoming order notifications from Wolt and dispatches a wolt-webhooks.order_notification Laravel event with a WoltWebhook instance. Register a listener to handle it:

use Foodticket\Wolt\WoltWebhook;

Event::listen('wolt-webhooks.order_notification', function (WoltWebhook $webhook) {
    // $webhook->orderId()
    // $webhook->venueId()
    // $webhook->payload()
});

OAuth

The OAuth callback endpoint handles the authorization code redirect from Wolt and dispatches an OAuthCallbackReceived event. Register a listener to exchange the code for tokens:

use Foodticket\Wolt\Events\OAuthCallbackReceived;

Event::listen(OAuthCallbackReceived::class, function (OAuthCallbackReceived $event) {
    // $event->code  — authorization code from Wolt
    // $event->state — state parameter set when initiating the OAuth flow
});

To exchange the authorization code for tokens, inject WoltOauthClient:

use Foodticket\Wolt\WoltOauthClient;

$tokens = app(WoltOauthClient::class)->exchangeCode($event->code);
// $tokens['access_token']
// $tokens['refresh_token']
// $tokens['expires_in']

When initiating the OAuth flow, encode identifying information in the state parameter so the callback listener can resolve the correct resource:

use Illuminate\Support\Facades\Crypt;

$state = Crypt::encryptString($client->uuid);
$redirectUrl = 'https://pos.wolt.com/oauth/authorize?client_id='.config('wolt.client_id').'&state='.$state.'&redirect_uri='.urlencode(config('wolt.redirect_uri'));

API

Inject WoltApi to interact with the Wolt POS Integration API directly:

use Foodticket\Wolt\WoltApi;

$api = app(WoltApi::class);

// Orders
$api->getOrder($orderId);
$api->getOrderV2($orderId);
$api->acceptOrder($orderId);
$api->acceptSelfDeliveryOrder($orderId);
$api->rejectOrder($orderId);
$api->markOrderReady($orderId);
$api->markPickupCompleted($orderId);
$api->markCourierAtCustomer($orderId);
$api->markOrderDelivered($orderId);
$api->confirmPreorder($orderId);
$api->replaceItems($orderId, itemChanges: [...], itemAdditions: [...]);
$api->markSentToPos($orderId);
$api->markDepositsReturned($orderId);
$api->refundItems($orderId, $data);
$api->refundBasket($orderId, $data);
$api->updateDeliveryLocation($orderId, $location);
$api->updateDeliveryEta($orderId, $data);
$api->getDocumentUploadLink($orderId, 'INVOICE');

// Venues
$api->getVenueStatus($venueId);
$api->getDeliveryProvider($venueId);
$api->updateDeliveryProvider($venueId, 'WOLT'); // or 'SELF_DELIVERY'
$api->updateOnlineStatus($venueId, 'ONLINE');
$api->updateOnlineStatus($venueId, 'OFFLINE', until: '2026-04-11T08:00:00Z');
$api->updateOpeningTimes($venueId, $availability);
$api->setSpecialOpeningTimes($venueId, $data);

// Menu
$api->createMenu($venueId, $menuArray);  // POST /v1/restaurants/{venueId}/menu
$api->getMenu($venueId);                 // GET  /v2/venues/{venueId}/menu
$api->updateItemInventory($venueId, $data);
$api->updateItems($venueId, $data);
$api->updateOptions($venueId, $data);