Integration model

The ownership boundary between a custom host site and Lockerverse commerce.

Responsibility map

Host site owns	Lockerverse owns
Product cards and page layout	Live catalog and availability
Cart controls and navigation	Pricing and discount rules
Copy and custom brand presentation	Authoritative totals
When checkout appears	Stripe Elements and confirmation
Success-page presentation	Payment and fulfillment state

Store a selection, not copied product data. Lockerverse resolves products and prices again before payment.

Supported selection shapes

type LockerversePaymentSelectionItem =
  | { productSlug: string; quantity: number }
  | { productSlug: string; amountCents: number }
  | { productSlug: string };

Product	Selection
Fixed one-time	`{ productSlug, quantity }`
Custom one-time	`{ productSlug, amountCents }`
Fixed recurring	`{ productSlug }`

Rules

Combine fixed and custom one-time products in one selection.
Do not combine recurring and one-time products.
Do not combine multiple recurring products.
Read quantity limits, custom-amount minimums, and display data from the catalog.
Treat the checkout quote as authoritative.

useLockerverseWidget returns the complete catalog. The host can filter or group it and pass the final selection to payment.