Shop¶
The Shop module is a standalone storefront: a catalog of items (with optional add-ons), a cart, Stripe checkout, and QR-code-based fulfillment at the event.
For shoppers¶
Browse the catalog on the shop page.
Open an item to see its details and any add-ons (with quantity limits).
Add to cart with your chosen add-ons.
Checkout with Stripe.
Receive an order confirmation with a QR code for each line item.
Your orders are listed under my orders.
Picking up your order¶
At the event, present your QR code(s) at the fulfillment terminal. Staff scan and validate each item, then hand it over.
For event organizers¶
Prerequisites¶
Before you can sell items, complete this third-party setup:
Mandatory |
Stripe — for shop item payments. |
|---|---|
Optional |
None. |
Requirements:
A valid Stripe API key, unrestricted, in LIVE mode, for shop item payments.
Catalog & settings¶
Create items (with images, descriptions, and pricing) and add-ons (each add-on can enforce a min/max quantity).
Configure shop settings — storefront options and fulfillment behavior.
Build the item form using the shop form-component registry.
Order management¶
Staff manage orders from staff orders (list + detail) and fulfill them on the fulfillment terminal, which scans and validates QR codes against the order.
For event technical staff¶
The fulfillment terminal is the device staff use to scan — open the correct URL on the scanning device.
Like Register and Vendor, payments go through Stripe; confirm the event is in the intended Stripe mode (test vs. live).