Letting other sellers list and sell products in one store: applying and approval, the seller's products and shop, splitting each order between sellers and the store, and paying sellers what they are owed.
36 parts and 16 phrases. Apps in this area include Webkul Multi Vendor Marketplace, Shipturtle, Sharetribe, Mirakl, Amazon Seller Central.
marketplace.moneyShowHow each sale is split, what the store owes each seller and how sellers are paid.marketplace.money.splitShowHow each sold line is divided between the store and the seller.How to extend
| Part | Litestore today | How to extend |
|---|---|---|
Platform fee marketplace.money.split.platform_feeA platform fee is the percentage of each sold line's net amount the store keeps, set as a store default and changeable per seller. | Core platform/config/marketplace.ts | Core only |
Line split marketplace.money.split.line_splitA line split divides each seller line's net amount, after its share of the order discount, into the platform fee and the seller's share and stores both on the line. | Core modules/vendors/vendor-shares.ts | Core only |
Fee by category or product marketplace.money.split.fee_by_categoryA category or product commission sets a different platform fee for one category, product or variant. | Plugin | Core only |
marketplace.money.ledgerShowThe running record of what the store owes each seller.How to extend
getVendorsgetVendorEarningsSeller balances are read through the assistant's vendor read tools.| Part | Litestore today | How to extend |
|---|---|---|
Sale entry marketplace.money.ledger.sale_entryA sale entry adds the seller's share of a line to their balance when the order is paid. | Core modules/vendors/vendor-ledger.ts | Core onlyAssistant tool · many |
Refund entry marketplace.money.ledger.refund_entryA refund entry takes back the seller's share of a refunded, cancelled or lost-dispute line. | Core modules/vendors/vendor-ledger.ts | Core onlyAssistant tool · many |
Clawback marketplace.money.ledger.clawbackA clawback records the part of a refund larger than the seller's balance, which their next sales repay. | Core modules/vendors/vendor-ledger.ts | Core onlyAssistant tool · many |
Seller balance marketplace.money.ledger.balanceA seller balance is the sum of all ledger entries for that seller, shown in their portal and on the admin seller page. | Core app/vendor/earnings/page.tsx | Core onlyAssistant tool · many |
marketplace.money.payoutShowMoving the money owed to each seller.How to extend
payout providerAutomatic transfers go through one payout provider, such as Stripe Connect.proposeVendorPayoutThe assistant proposes a payout that an operator with financial permission approves.| Part | Litestore today | How to extend |
|---|---|---|
Recorded manual payout marketplace.money.payout.manualA manual payout records money staff sent outside the store, by bank transfer or PayPal, with its reference, and subtracts it from the seller's balance. | Core modules/vendors/vendor-payout-schema.ts | Provider · oneAssistant tool · many |
Automatic transfer marketplace.money.payout.automatic_transferAn automatic transfer sends the seller's share to their connected payment account after the buyer's charge succeeds. | Planned | Provider · oneAssistant tool · many |
Payout request marketplace.money.payout.payout_requestA payout request is a seller asking from their portal to be paid their available balance. | Plugin | Provider · oneAssistant tool · many |
Payout hold period marketplace.money.payout.hold_periodA hold period keeps a sale's share out of the payable balance for a set number of days in case of refunds. | Plugin | Provider · oneAssistant tool · many |
Seller tax report marketplace.money.payout.tax_reportA seller tax report lists each seller's yearly sales for a tax authority, such as a 1099-K in the US or a DAC7 report in the EU. | Plugin | Provider · oneAssistant tool · many |
marketplace.onboardingShowHow a seller applies, is checked and is approved or rejected.How to extend
identity verification providerIdentity and business checks come from one verification service.| Part | Litestore today | How to extend |
|---|---|---|
Seller application marketplace.onboarding.applicationA seller application is a form a signed-in customer fills in with a shop name and description to ask to sell in the store. | Core modules/vendors/storefront/vendor-application-form.tsx | Provider · one |
Seller approval marketplace.onboarding.approvalSeller approval records staff's approve or reject decision with its time, emails the seller, and shows or hides the seller's products. | Core modules/vendors/vendor-approvals.ts | Provider · one |
Revoke or reconsider marketplace.onboarding.reconsiderStaff revoke an approved seller, which takes their products off the storefront, or approve a rejected seller later, which brings them back. | Core modules/vendors/transitions.ts | Provider · one |
Identity check marketplace.onboarding.identity_checkAn identity check verifies a seller's identity, business details and bank account before they are paid. | Plugin | Provider · one |
Seller agreement marketplace.onboarding.seller_agreementA seller agreement is the terms a seller accepts when applying, stored with the time of acceptance. | Plugin | Provider · one |
marketplace.catalogShowProducts a seller owns and where shoppers see who sells them.How to extend
| Part | Litestore today | How to extend |
|---|---|---|
Seller-listed product marketplace.catalog.seller_listingA seller-listed product is a product a seller adds from their portal with a name, price, stock, category and photo, owned by that seller. | Core modules/vendors/portal/actions.ts | Event · manySlot · many |
Seller name on product marketplace.catalog.sold_byThe seller name on a product page names the seller and links to their shop, or names the store for its own products. | Core modules/products/storefront/product-details-section.tsx | Event · manySlot · many |
Seller shop page marketplace.catalog.seller_shopA seller shop page lists only one seller's products, shown in Litestore as the product feed filtered to that seller. | Core modules/storefront/feed/feed-filters.tsx | Event · manySlot · many |
Visible while approved marketplace.catalog.approved_onlyThis rule shows a seller's products on the storefront only while the seller is approved. | Core modules/products/visibility.ts | Event · manySlot · many |
Assign a seller marketplace.catalog.assign_sellerStaff set or change which seller owns a product from the product form. | Core modules/products/admin/cards/status-card.tsx | Event · manySlot · many |
Product approval marketplace.catalog.product_approvalProduct approval holds each new seller product as a draft until staff approve it. | Plugin | Event · manySlot · many |
Seller profile marketplace.catalog.seller_profileA seller profile page shows the seller's logo, banner, description and policies. | Plugin | Event · manySlot · many |
Seller rating marketplace.catalog.seller_ratingA seller rating is the average score buyers give a seller after an order, shown on their shop and products. | Plugin | Event · manySlot · many |
marketplace.orderShowHow one cart with several sellers' products becomes work for each seller.How to extend
| Part | Litestore today | How to extend |
|---|---|---|
Mixed cart marketplace.order.mixed_cartA mixed cart holds products from several sellers and the store, paid in one checkout. | Core modules/vendors/vendor-shares.ts | Event · many |
Seller order view marketplace.order.seller_linesThe seller order view lists only the seller's own lines on each paid order, with the ship-to address. | Core modules/vendors/portal/queries.ts | Event · many |
Seller ships own lines marketplace.order.seller_shippingA seller marks their lines on an order shipped with a carrier and tracking number, and the order's fulfilment status follows from all sellers' shipments. | Core modules/vendors/portal/actions.ts | Event · many |
Separate order per seller marketplace.order.order_per_sellerSeparate seller orders split one checkout into one order per seller, each with its own number and status. | Plugin | Event · many |
Shipping rates per seller marketplace.order.seller_shipping_ratesSeller shipping rates charge shipping by each seller's own rates and location instead of the store's. | Plugin | Event · many |
Buyer and seller chat marketplace.order.buyer_seller_chatBuyer and seller chat is a message thread between a shopper and one seller about a product or order. | Plugin | Event · many |
marketplace.portalShowThe signed-in area where a seller manages their part of the store.How to extend
| Part | Litestore today | How to extend |
|---|---|---|
Seller home marketplace.portal.homeThe seller home shows the seller's balance, orders to ship, product count and platform fee. | Core app/vendor/page.tsx | Slot · many |
Seller-scoped access marketplace.portal.scoped_accessSeller-scoped access limits every portal read and action to the signed-in seller's own products, lines and ledger. | Core platform/permissions/vendor.ts | Slot · many |
Admin seller page marketplace.portal.admin_seller_pageThe admin seller page shows a seller's earnings, ledger, products and fee, with buttons to approve, reject and record a payout. | Core app/admin/vendors/[slug]/page.tsx | Slot · many |
Seller staff accounts marketplace.portal.seller_staffSeller staff accounts let several people sign in to one seller's portal with their own logins. | Plugin | Slot · many |
Seller bulk upload marketplace.portal.bulk_uploadSeller bulk upload creates or updates many of a seller's products from one CSV file. | Plugin | Slot · many |
The words apps use for a feature, and the plain parts the feature is made of, in the order they happen.
| Phrase | Made of |
|---|---|
| vendor onboarding | |
| seller verification | |
| KYC | |
| vendor storefront | |
| product approval | |
| commission | |
| platform fee | |
| vendor payouts | |
| automated payouts | |
| separate charges and transfers | |
| split orders | |
| vendor fulfillment | |
| vendor dashboard | |
| seller ratings | |
| 1099-K reporting | |
| DAC7 |
These phrases mean different things at different apps, so the glossary doesn't map them.
The app documentation these parts were checked against.