Skip to main content

Merchants

A merchant (also called a service provider) is a seller on Kadaikodi — a brand, store, supplier, or operator. Merchants are first-class workspace-scoped entities with a full lifecycle, branding, and configuration.

Lifecycle​

Merchants move through a governed status machine:

DRAFT → ACTIVE → VERIFIED → PAUSED → SUSPENDED → ARCHIVED
StatusMeaning
DRAFTJust created, not yet visible to customers
ACTIVELive and visible; can receive orders
VERIFIEDPassed platform verification (identity, address, compliance)
PAUSEDTemporarily not accepting orders
SUSPENDEDPlatform-enforced stop; violates policy
ARCHIVEDPermanently closed; read-only history

Attributes​

  • Category — FOOD_AND_BEVERAGE, RETAIL, HEALTH_AND_WELLNESS, HOME_SERVICES, PROFESSIONAL_SERVICES, EDUCATION, ENTERTAINMENT, TRANSPORTATION, OTHER
  • Offering type — PRODUCTS, SERVICES, BOTH
  • Location — address + lat/lng for map display and delivery radius
  • Business hours — weekly schedule with open/close times
  • Branding — logo, banner, accent color, description
  • Rating — computed from customer reviews

GraphQL​

query {
  listServiceProviders {
    id
    name
    category
    status
    rating
    offeringType
  }
}

mutation {
  kadaikodiCreateServiceProvider(input: {
    name: "Anbu's Kitchen"
    category: FOOD_AND_BEVERAGE
    offeringType: BOTH
  }) {
    id
    name
    status
  }
}

Next steps​