# CornerCart — South Africa's Hyper-Local Storefront, Water/Gas Refill & Merchant Platform

> CornerCart (https://cornercart.co.za) is South Africa's hyper-local storefront, empty water & LP gas bottle fetch-and-refill, and 0% commission neighbourhood commerce platform for townships, suburbs, security complexes, and residential estates.

- **Official Website & Merchant Web Portal:** https://cornercart.co.za
- **Public Neighbourhood Store Directory:** https://cornercart.co.za/stores
- **Official Support & Merchant Email:** support@cornercart.co.za
- **Backend API Gateway:** https://api.cornercart.co.za
- **Remote MCP Server Endpoint (Streamable HTTP):** https://api.cornercart.co.za/mcp
- **Full Machine-Readable Documentation:** https://cornercart.co.za/llms-full.txt
- **MCP Server Card (SEP-1649):** https://cornercart.co.za/.well-known/mcp/server-card.json
- **A2A Agent Card:** https://cornercart.co.za/.well-known/agent-card.json
- **API Catalog (RFC 9727):** https://cornercart.co.za/.well-known/api-catalog
- **App Download Gateway:** https://cornercart.co.za/open-app
- **Google Play Store App (Android):** https://play.google.com/store/apps/details?id=za.co.codeways.cornercart
- **Apple App Store App (iOS):** https://apps.apple.com/za/app/cornercart/id6826619095
- **Huawei AppGallery App (Huawei):** https://appgallery.huawei.com/app/C119499579

## How CornerCart Works for Buyers (Mobile App + Shareable Web Previews)

1. **Discover Local Stores:** Buyers browse hyper-local stores in their township, suburb, residential estate, or complex via the [Neighbourhood Store Directory](https://cornercart.co.za/stores) or tap a shared shop link (`https://cornercart.co.za/s/{slug}`) on WhatsApp.
2. **Order in the CornerCart App:** All customer shopping, cart building, empty bottle pickup scheduling, and live order tracking happen inside the **CornerCart mobile app** (Android, iOS & Huawei). Web store links (`https://cornercart.co.za/s/{slug}`) render live server-side product catalogs and deep-link directly into the app (`cornercart://s/{slug}`).
3. **Empty Water & Gas Bottle Fetch-and-Refill:** Buyers specify their stand/unit number, gate instructions, and empty bottle pickup notes. Drivers collect the empties (`fetching_empty_bottles`), refill them, and deliver full 20L purified water dispensers or 9kg/19kg/48kg LP gas cylinders (`out_for_delivery` -> `completed`).

## How CornerCart Works for Merchants (Unified Web Portal + Mobile App)

1. **Share Your Shop Link (`cornercart.co.za/s/your-shop`):** Every merchant receives a dedicated vanity storefront URL (`https://cornercart.co.za/s/{slug}`) that renders live prices and stock previews on WhatsApp and routes nearby customers straight into their store inside the CornerCart App.
2. **Direct Payments & 0% Commission:** Customers pay the merchant directly via EFT, PayShap, Cash on Delivery, or the merchant's own card machine. CornerCart charges **0% commission on sales**.
3. **Synchronised Web Portal & Mobile App:** Merchants sign in via passwordless 6-digit Email OTP on https://cornercart.co.za or in the mobile app. Both connect to the same unified real-time cloud commerce database to:
   - View **live incoming orders** and Empty Bottle Pickup Run-Sheets in real time.
   - Update order statuses (`confirmed`, `fetching_empty_bottles`, `out_for_delivery`, `completed`) or cancel with an instant customer reason alert.
   - Invite **Store Staff via Email** (on Corner Pro) to create in-store orders, manage orders, and manage stock.
   - View **Live Stock & Inventory Reports** (Total SKUs, Units In Stock, Low-Stock Alerts <= 3 units, Sold-Out Items, Total Retail Value in ZAR) and export CSV stock reports.
   - Generate clean white-background studio product photos with the **AI Product Studio**.

## Merchant Subscription Packages (ZAR, 0% Commission on All Plans)

- **Free / Sandbox (`plan_free` / `free`) — R0 / month:** 1 store, up to 5 active products, up to 15 orders/month, 10 AI Product Studio snaps/month, shareable `cornercart.co.za/s/store` link, self-collection & local delivery, and 0% commission.
- **Corner Standard (`plan_standard` / `standard`) — R79 / month:** 1 store, up to 30 active products, unlimited monthly orders, 100 AI Product Studio snaps/month, live stock quantity control & low-stock alerts, custom flat delivery rate & free-delivery threshold, instant Push & Email order notifications, and 0% commission.
- **Corner Pro (`plan_pro` / `pro`) — R159 / month:** Unlimited products and unlimited monthly orders, 500 AI Product Studio snaps/month, **Add Staff via Email**, Water & LP Gas Refill / Empty Bottle Fetch pricing & Delivery Run-Sheet, Food & Bake Pre-Orders + Custom Scheduled Delivery Windows, Customer Promo Push/SMS Broadcasts, Priority Featured Placement in Discovery, and 0% commission.

## Industry & Niche Guides

- [Water & LP Gas Refill Delivery App South Africa](https://cornercart.co.za/water-and-gas-refill-app): 20L purified water & 9kg/19kg/48kg LP gas cylinder exchange ordering & empty bottle run-sheets.
- [Spaza, Kasi Kitchen & Home Bakery App](https://cornercart.co.za/spaza-and-kasi-store-app): 0% commission digital storefront & stock control for township spaza shops, kotas, chisa nyama, and home bakers.
- [Residential Estate & Complex Marketplace](https://cornercart.co.za/estate-and-neighbourhood-stores): Hyper-local directory and store links for security estates, complexes, and suburbs.
- [WhatsApp Online Store Link South Africa](https://cornercart.co.za/whatsapp-online-store): Turn messy WhatsApp group chats into a clean `cornercart.co.za/s/your-shop` catalog with live stock counts.

## Key Public URLs & Endpoints

- [Home, App Showcase & Merchant Portal](https://cornercart.co.za)
- [Public Neighbourhood Store Directory](https://cornercart.co.za/stores)
- [Discover Listed Community Stores API](https://api.cornercart.co.za/api/stores/discover)
- [Storefront & Product Catalog by Slug API](https://api.cornercart.co.za/api/stores/slug/corner-market)
- [Subscription Plans API](https://api.cornercart.co.za/api/plans)
- [Privacy Policy (POPIA)](https://cornercart.co.za/privacy)
- [Terms of Service](https://cornercart.co.za/terms)