← Back to case studies

Surfacing In-Store Pickup Options

Click & Collect lets a customer pick up their order in store. The system automatically proposes candidate stores by combining two signals: stock availability (on hand, or via a transfer from the warehouse) and distance to the customer.

Rules: only stores with stock inside a configurable radius are shown, sorted nearest to farthest, each with an estimated pickup_eta. Confirming creates a stock reservation with an expiration. This console simulates the whole flow client-side.

Product and search radius

Type or pick a product from the simulated catalog. The radius_km bounds which stores are considered.

Catalog: 5584/041 · Relaxed Linen Shirt

Demo scenario
Radius (radius_km)

Pickup options

Stores with stock within 10 km, sorted by distance.

  • Downtown Store

    ST-DOWNTOWN

    Distance
    1.2 km
    Stock
    6 units on hand
    Pickup
    Ready in 2h
  • Central Station Store

    ST-CENTRAL

    Distance
    2.8 km
    Stock
    3 units on hand
    Pickup
    Ready in 2h
  • Westfield Mall Store

    ST-WESTFIELD

    Distance
    9.4 km
    Stock
    12 units on hand
    Pickup
    Ready in 2h

Discarded: 1 out of stock · 1 outside the radius.


Behind the scenes — stock reservation

On confirm, the API locks 1 unit at the chosen store (on_hand) or kicks off a warehouse_transfer. The reservation expires after 72h.

POST /click-and-collect/reservations
// Confirm a pickup above to generate the payload.