Retail Order Guide

Order Guide for Retail

Wolt's order integration for retailers, meaning all merchants besides restaurants, makes use of webhook notifications to inform you when the order is in its final state. Retail orders can have substitutions or missing items, making it important to pull the order details in once the order has been complete.

The integration begins either when the order is marked READY (recommended) or DELIVERED. There is only one API call expected.

Retail Order Flow Overview

Getting Final Order Details

Use the information in the webhook notification to pull the final order details in.

• Webhook Guide

• Get Order API

Notification examples

Order Ready

Triggered after venue staff completes order collection and marks the order as ready for pickup.

payload example

{
  "id": "90f5c25cbbfb3d131a46e643",
  "type": "order.notification",
  "order": {
    "id": "90f5be47fc97e11107f8a480",
    "venue_id": "9a5c7e3102fe6a000c4b562b",
    "status": "READY",
    "resource_url": "https://pos-integration-service.wolt.com/orders/90f5be47fc97e11107f8a480"
  },
  "created_at": "2021-07-19T18:20:12.378509Z"
}

Order Delivered

Sent when the courier marks the order as delivered. The order is now in its final state.

payload example

{
  "id": "90f5c25cbbfb3d131a46e643",
  "type": "order.notification",
  "order": {
    "id": "90f5be47fc97e11107f8a480",
    "venue_id": "9a5c7e3102fe6a000c4b562b",
    "status": "DELIVERED",
    "resource_url": "https://pos-integration-service.wolt.com/orders/90f5be47fc97e11107f8a480"
  },
  "created_at": "2021-07-19T18:20:12.378509Z"
}

Important Notes

• Order modifications (substitutions, missing items) are reflected in the API response when you pull order details after the READY status.

• Treat webhook notifications as triggers and always pull full order data before processing internally.

• Ensure your system handles out-of-order events, retries, order cancelations, and validates against duplicate processing.