Skip to main content

Getting Started with Kadaikodi

This guide walks you through setting up Kadaikodi quickly — whether you're shopping, selling, or building.

The whole process takes about five minutes.

Quick start as a customer​

  1. Sign up at app.kadaikodi.com and verify your email
  2. Browse merchants and offerings; filter by category, search by name
  3. Add products and bookable services to one cart, with per-item customizations
  4. Check out — pick fulfillment (pickup, delivery, on-location, home service), an address, and a payment method; see server-computed totals
  5. Place the order, track it through its lifecycle, and leave a review when it completes

See the Customer Guide for the full walkthrough.

Quick start as a merchant (cart owner)​

  1. Register as a merchant; set category, offering type, location, and business hours
  2. Move through verification toward active/verified status
  3. List offerings — products with stock, services with duration — set prices, media, and tags
  4. Receive orders and advance them through the lifecycle from the back office
  5. Assign workers and dispatch fulfillment tasks; respond to reviews

See the Cart Owner Guide for the full walkthrough.

Quick start as a developer​

Kadaikodi is API-first. Everything is reachable through a single authenticated GraphQL API over HTTPS.

# Create an offering
mutation {
  createOffering(input: {
    name: "Cold Brew Coffee"
    category: FOOD_AND_BEVERAGE
    price: 180.00
    stock: 40
    fulfillmentTypes: [PICKUP, DELIVERY]
  }) {
    id
    name
    slug
  }
}

# Place an order with server-computed pricing
mutation {
  placeOrder(input: {
    items: [{ offeringId: "off_123", quantity: 2 }]
    fulfillmentType: DELIVERY
    paymentMethod: UPI
  }) {
    id
    orderNumber
    status
    paymentStatus
    total
  }
}

Authenticate with OAuth (device-code for apps/CLIs, client credentials for service-to-service). See the GraphQL API and API Reference for the full set of operations.

Install the CLI​

npm install -g @kadaikodi/cli
# or
bun add -g @kadaikodi/cli
kadaikodi auth login
kadaikodi workspace set <id>
kadaikodi kadaikodi offerings list

Use the Node SDK​

bun add @kadaikodi/sdk
import { KadaikodiSDK } from '@kadaikodi/sdk';

const sdk = new KadaikodiSDK();
await sdk.auth.signIn({ username: '[email protected]', password: 'secret' });
const orders = await sdk.kadaikodi.orders.list();

Use the Python SDK​

pip install kadaikodi-sdk
from kadaikodi_sdk import KadaikodiSDK

sdk = KadaikodiSDK()
await sdk.auth.sign_in(email="[email protected]", password="secret")
orders = await sdk.kadaikodi.orders.list()

All tools default to production Burdenoff gateways. Switch environments with BURDENOFF_ENV=local|alpha|prod. See Environment Selection.

Next Steps​

Explore the platform

For help, contact [email protected].