Marketplace · Use case 1

A creator marketplace for digital products

Independent makers sell downloadable products on your storefront; you take commission on every sale.

The scenario

You run a storefront and want independent makers to sell downloadable products on it — Notion templates, Lightroom presets, ebooks, icon packs, sample packs. You keep a percentage of every sale; the maker keeps the rest and withdraws it. This is the classic creator marketplace, and it rides on the shop vertical.

Role	Who	Does what
Vendor	The maker	Becomes a vendor, lists products, sets prices, uploads images.
Buyer	Your audience	Buys through the normal shop checkout.
Operator	You	Approves vendors, sets commission, approves payouts.

', '

What powers it

Switch vendor-mode on for the shop (marketplace_enabled: true in the shop plugin config). The shop then serves per-vendor product CRUD and stamps each sold line with the vendor\'s id. Products support images, tags, custom fields and stock, so a maker\'s listing looks first-class. See the fe-user plugin for the create/edit flow and the backend plugin for the stamp contract.

Creating a listing — the vendor picks a type from the registry-driven dropdown (only verticals with vendor-mode on appear).

', '

The money flow

A buyer purchases a maker\'s product through the shop checkout.
The shop stamps the invoice line with the maker\'s vendor id.
On invoice.paid, the marketplace writes one earning row: gross, your commission (snapshotted), and the maker\'s net credit.
The maker watches the balance grow in My earnings and withdraws to real money.

The vendor\'s My sales view — each paid invoice grouped with its gross and net-credit totals.

', '

Set-up checklist

Enable marketplace + withdraw + shop.
Set default_commission_rate (e.g. 0.15 for 15%).
Turn on the shop\'s marketplace_enabled flag.
Decide auto_approve_vendors vs. manual approval.