Bring your own storefront

Your design. Our commerce and merchant operations.

Build any webpage you like, then use the published storefront document and Vendure Shop API as stable integration hooks. The platform remains the source of truth for catalogue, cart and order data.

Resolve the shop

Read the public, cacheable storefront document by merchant slug.

GET /api/public/stores/:slug

Use the merchant channel

Send the published channel token with Vendure Shop API requests.

vendure-token: shop-example

Use Vendure cart primitives

Query products and use activeOrder mutations. Never invent totals in the browser.

POST /shop-api

Report minimal events

Send the public slug and allowed event name; the server resolves merchant ownership.

POST /api/public/events

Published document

A small contract designed for storefronts

{
  "slug": "lakshmi-home-foods",
  "businessName": "Lakshmi Home Foods",
  "category": "FOOD",
  "templateKey": "warm-kitchen",
  "themeColor": "#9a3412",
  "sectionOrder": ["intro", "catalogue", "fulfilment", "trust"],
  "products": [{ "variantId": "…", "pricePaise": 18000 }]
}

Integration rules

Amounts are integer paise.
Use server-returned Vendure product, variant, cart and order identifiers.
Never send merchant IDs as authorization.
Keep Admin API and merchant session endpoints server-side/private.
UPI success requires explicit merchant confirmation.

Inspect the live demo