foodticket/wolt

A Laravel client to integrate with the Wolt API

v0.0.1 2026-04-02 13:32 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->acceptOrder($orderId);
$api->rejectOrder($orderId);
$api->markOrderReady($orderId);
$api->markOrderDelivered($orderId);

// Venues
$api->getVenues($accessToken);

// Menu
$api->getMenu($venueId);
$api->updateMenu($venueId, $menuArray);
$api->updateItemAvailability($venueId, $itemId, enabled: true);