Last verified: 2026-05-30
Merchant channel terminology
Purpose: One vocabulary for SaaS2 operator docs, merchant-facing UI, and alignment with CRM field training (MAS).
Do not rename code modules such asdelivery-marketplacein a docs pass — that is the driver job board subsystem.
Three meanings of “marketplace” (do not mix)
| Term | What it is | Examples |
|---|---|---|
| Bumi consumer marketplace | BumiSoft technology that connects guests ↔ merchants on your stack; basis for Marketplace Terms | Checkout on /store/{slug}, MoR food orders |
| Third-party delivery marketplace app | Competitor aggregators the merchant already uses | DoorDash, Uber Eats, GrabFood, Foodpanda, ShopeeFood |
| Delivery job marketplace (internal) | Driver broadcast / tiered job offers for delivery_ondemand tenants | /driver, /api/delivery/marketplace/* — not DoorDash |
What to say to merchants (preferred)
| Concept | Preferred term | Avoid |
|---|---|---|
| Your product (guest ordering) | Storefront, direct ordering web app | Bare “link”; bare “app” (confuses with DoorDash) |
| Guest URL | Storefront URL /store/{slug} | “Marketplace URL” |
| Competitor apps | Third-party delivery marketplace app or marketplace app (when context is clear) | Calling Bumi a “marketplace app” in sales copy |
| Your subscription payment mode | Commission billing | “Marketplace commission” (that is the competitor fee) |
| Legal consumer orders | Bumi consumer marketplace / consumer ordering terms (Marketplace Terms) | Rewriting binding “Marketplace Terms” doc titles without counsel |
Dual label (UI + checkout)
Use one string everywhere users click before an order. Legal H1 on /legal/marketplace-terms stays Marketplace Terms; UI adds the product-friendly name in parentheses.
| Surface | Exact copy |
|---|---|
| Footer / ToS / checkbox link | Consumer ordering terms (Marketplace Terms) |
| Checkout intro | Please review and accept our Consumer ordering terms (Marketplace Terms) before placing your order. |
| Dialog title | Consumer ordering terms (Marketplace Terms) |
| Read-full control | Read full Consumer ordering terms (Marketplace Terms) |
| Legal page subtitle (non-binding) | Consumer ordering terms for {app} — binding document title: Marketplace Terms |
Public /legal/marketplace-terms body | Consumer summary (numbered sections; no entity diagrams or inter-company fee splits) |
Constants: apps/saas2/lib/legal/consumer-ordering-terms-labels.ts
CRM field alignment
Extreme Scaling MAS playbooks use the same contrast:
- Pain: marketplace app math (DoorDash/Uber-style fees).
- Solution: direct ordering web app on the MDM offer sheet.
See apps/crm2/docs/kb/field/mas-your-docs.md (Field terminology).
