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, your own food delivery app (merchant-facing); direct ordering web app (internal docs) | Bare “link”; bare “app” (confuses with DoorDash) |
| Free tier product | direct ordering link | Direct Link (code name); bare “link” without context |
| Free tier competitor | link in bio / Linktree | Generic “link-in-bio tool” (jargon) |
| Paid competitor | third-party food delivery apps (Grab/Foodpanda as local examples only) | Bare “third-party apps” to merchants |
| Guest URL | Storefront URL /store/{slug} | “Marketplace URL” |
| Competitor apps (internal) | Third-party delivery marketplace app or marketplace app (playbooks) | 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 lanes:
- Free tier: link in bio / Linktree → direct ordering link (INTRO Phase 0).
- Paid: third-party food delivery apps → your own food delivery app (phone SSOT).
- Playbooks (trainer): marketplace app math (pain) · direct ordering web app (solution docs).
See apps/crm2/docs/kb/shared/merchant-contrast-terminology.md and apps/crm2/docs/kb/field/mas-your-docs.md.