Glossary
Merchant — a business that integrates TBBN's Trade Engine (marketplace, ecommerce platform, thrift/consignment business, classifieds site, social-commerce app). Merchants currently own payments, taxes, fulfillment, and their seller relationships.
Seller — an individual who lists and trades items; also called a Marketplace profile. Every registered user gets exactly one. A seller may separately be linked to one or more merchants via merchant-fed listings — see "Identity federation" below.
Listing — an item a seller has listed for trade. For a merchant-fed listing, the original price is always merchant-supplied and never set or discounted by TBBN. An individual can also list something of their own directly, without going through a merchant.
Wants — a structured array on a listing ({category, subcategory, brand}) describing what
the seller would accept in trade. Turns search into matching.
Offer — a proposal from one seller (offering one or more of their own listings) to trade for one or more of another seller's listings.
Trade Session — the stateful record that exists once an offer is accepted; tracks both sides' sellers, listings, reservations, and payments through to completion. See Trade session states.
Trade sessions store symmetric sellerA/sellerB fields — neither side is ever required to
act first, and once an offer is accepted, both sides may check out immediately and independently.
Don't build any workflow logic that requires a trade to go in one direction.
Identity federation — the process by which one person, verified separately by two or more
merchants, is recognized as a single seller across those merchants. A merchant sends
{name, verified email, verified phone} after it verifies the seller; this either matches an
existing account or creates one on the spot. name here means whatever the merchant is legally
able to share — a name, nickname, or username, never assumed to be a legal name. If that email or
phone already matches a different merchant's link, TBBN confirms it's the same person via
sequential one-time codes (email first, then phone, both required) before attributing the new
merchant's reference to the existing account.
Global / Private / Both / Enterprise (listing visibility)
PRIVATE: visible only within the originating merchant's own platform.GLOBAL: visible on TBBN Marketplace and to all other Global-tier-or-above merchants.BOTH: merchant-configurable; the merchant decides per-listing or as a platform default.ENTERPRISE: visible only to the merchant's explicitly-selected enterprise trading merchants — not globally visible, not just internal.
Trade Value — OriginalPrice + RequestedAmount − WillingToPay.
Checkout orchestration — TBBN reserving items and redirecting each seller to the other seller's merchant checkout with the trade amount. TBBN does not process the payment itself.
