Product Glossary
Purpose
Shared vocabulary so "campaign," "commission," and "payout" mean the same thing in every doc, in code, and in conversations with users.
| Term | Definition |
|---|---|
| Merchant / Brand / Business Owner | A user selling a product (digital or physical) who lists it with a commission attached. Pakistan-based only for MVP, on Shopify. |
| Creator | A user with an audience who promotes a merchant's product in exchange for commission. |
| Offer / Product | The thing being sold, and its commission listing in one entity. Has a price (PKR), category (digital/physical), a merchant-set commission rate, and a lifecycle status (draft/live/paused/ended). Open for creators to apply to. There is no separate "Campaign" — see Note below. |
| Application | A creator's request to promote a specific offer. States: pending, approved, rejected (see State Machines). |
| Affiliate Link | The unique, trackable URL generated for an approved creator–offer pair (e.g. sellvia.link/mia-glow per the live site example). Carries the creator's attribution "fingerprint." |
| Click / Attribution Event | A tracked interaction (click, cart add, purchase) tied to a specific affiliate link, timestamped, visible to both merchant and creator. |
| Sale / Order | A verified purchase attributed to an affiliate link. Triggers commission calculation. |
| Commission | The creator's share of a sale, set as a percentage by the merchant at offer creation (10–50% typical, per raw data doc; 20% shown in the live site's Glow Serum example). |
| Payout | The transfer of a creator's earned commission to them, released once the merchant's billing cycle for that sale settles (bill-first-then-pay via Swich) — not triggered instantly on a verified sale. |
| Wallet / Balance | A creator's running total of earned-but-not-yet-paid-out commission. |
| Receipt | The shared, identical record of a sale shown to both merchant and creator (amount, commission split, timestamps). |
| Waitlist | Pre-launch signup; current validation-stage entry point. |
Notes
Terms here should be treated as the canonical names used in the database schema (03. Database) and API (07. API) — avoid renaming these mid-build.
Update (2026-08-23): "Campaign" Retired as a Term
"Campaign" no longer names a distinct entity — merged into Offer, per founder decision ("offer is offer, it is not turning into any campaign at all") and 01. Domain Model's 2026-08-23 revision. Any doc still using "Campaign" as a noun for the commission-bearing listing should be read as "Offer." Also: commission and price are PKR only for MVP (Pakistan-only market), and the merchant's own checkout is Shopify specifically, not any e-commerce platform — see 02. Architecture Decision Log.