01
Catalogue
Three-level categories, brands, attributes and a variation builder, bulk import and export, and a minimum-margin rule.
Hyperlocal marketplace with multi-level referral engine
Multi-Vendor Marketplace with Referral Commissions
A marketplace where local stock points fulfil orders nearby and customers earn multi-level commissions on what their referrals buy.
AT A GLANCERETAIL & E-COMMERCE
- Apps
- Web storefront, Android and iOS apps, seller panel with POS, delivery app, admin
- Fulfilment
- Nearest stock point by distance; pickup or delivery
- Commissions
- Unlimited admin-configured levels, released on delivery
- Built with
- Express 5, React 19, PostgreSQL, Capacitor
12 MODULESBUILT AND SHIPPED
The problem
What it replaces
Referral-led selling needs two systems that rarely talk: a marketplace that routes orders to the nearest vendor, and a commission engine that pays every level of the referral chain correctly. Doing commissions by spreadsheet invites disputes, fraud and late payouts.
This platform combines a multi-vendor storefront, nearest-stock-point fulfilment and delivery, seller POS, KYC, wallets with withdrawal rules, and an engine for unlimited referral levels with commissions released on delivery and weekly rank promotion — with fraud rules watching it all.
Who uses it
Customers
Web and mobile storefront: shop, choose pickup or delivery, refer others and track earnings.
Referral agents
A dashboard for their network, commissions, rank, milestones and withdrawals.
Stock points and sellers
Inventory, restock requests, POS and order fulfilment.
Delivery partners
Zones, assignments, cash collection and earnings.
Admins
Catalogue rules, commission levels, KYC review, fraud flags and reports.
Features
What the system does
02
Merchandising
Flash deals, deal of the day, featured and clearance pricing, coupons, banners, new arrivals and best sellers.
03
Nearest stock point
The closest vendor is found by distance; delivery is charged per kilometre or the customer picks up.
04
Vendor inventory
Map-pinned stock points, restock requests, a warehouse ledger and admin reassignment of orders.
05
Seller POS
Walk-in sales at stock points with server-side pricing and commission.
06
Referral engine
Unlimited levels, referral chains and differential commissions, held until delivery and then released through a queue and ledger.
07
Ranks and rewards
Weekly rank promotion, milestones and rewards.
08
Wallets and withdrawals
Shopping and commission wallets, withdrawal windows, minimums, holding periods and tax deductions.
09
KYC
Document upload and admin review that decides account status.
10
Delivery partners
Zones, assignment, cash-on-delivery collection, earnings and withdrawals.
11
Fraud rules
A rules engine that raises fraud flags for review.
12
After-sale and support
Refunds, reviews, wishlists, support tickets and customer–seller chat.
Architecture
How the pieces fit together
One API with versioned groups for customers, sellers and stock points; the same React app ships to the web and, wrapped natively, to the app stores. Commission release and ranks run on scheduled jobs.
Apps
- StorefrontReact · web
- Mobile appsCapacitor · iOS / Android
- Seller & POS panel
- Delivery app
- Admin back office
Platform
- Orders & fulfilment
- Commission enginequeue + ledger
- Wallets & withdrawals
- Fraud rules
- Scheduled jobsrelease, ranks
Data
- PostgreSQL~70 tables
- Generated API clientOpenAPI → typed hooks
Connected services
- Payment gatewaystwo, with webhooks
- SMS
- Push notifications
- Open maps
- OrderA customer orders; the nearest stock point is assigned.
- FulfilThe stock point packs it, and a delivery partner or the customer collects it.
- ReleaseOn delivery, commissions for every referral level move to wallets.
- WithdrawAgents withdraw within the rules, with tax deducted and KYC checked.
Built with
- TypeScript
- Express 5
- Drizzle
- PostgreSQL
- React 19
- Capacitor
- Tailwind
Built before, fitted to you
Start from an architecture that has already shipped
We have delivered this kind of system, so yours starts from a design that is known to work, not a blank page. Your workflow, your terminology and your approval chain shape what we build on top of it.
More in Retail & e-commerce
Point of sale, inventory and purchasing for store chains
Retail POS & Store Operations
Point of sale, cash drawers, inventory, purchasing, receiving, transfers and tax invoicing for chains with many stores and subsidiaries.
View product →Fulfilment, courier dispatch and corporate-order CRM
Order, Inventory & B2B Sales System
For brands that sell online and take bulk corporate orders: stock, fulfilment, courier dispatch and complaints, plus a B2B pipeline from lead to printed order to payment.
View product →