Manva.ai Storefront API Documentation

{
  "products": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Organic Cotton T-Shirt",
      "slug": "organic-cotton-t-shirt",
      "description": "Soft, breathable organic cotton tee.",
      "price": 799,
      "sale_price": 599,
      "currency": "INR",
      "images": ["https://res.cloudinary.com/.../tshirt.jpg"],
      "category": "Clothing"
    }
  ]
}

{
  "products": [
    {
      "id": "uuid",
      "name": "Product Name",
      "price": 999,
      "sale_price": 799,
      "currency": "INR",
      "images": ["https://..."]
    }
  ]
}

{
  "items": [
    {
      "id": "product-uuid",
      "qty": 2,
      "variant": { "Size": "L", "Color": "Blue" }
    }
  ],
  "buyer": {
    "name": "Jane Doe",
    "phone": "9876543210",
    "email": "jane@example.com",
    "address": "123 Main St, Mumbai 400001",
    "notes": "Leave at door"
  },
  "discountCode": "SAVE10",
  "loyaltyPoints": 100
}

{
  "orderId": "uuid",
  "orderNo": "ORD1A2B3C",
  "razorpayOrderId": "order_abc123",
  "amount": 119800,          // in paise (INR subunits)
  "currency": "INR",
  "keyId": "rzp_live_XXXXXX",  // Razorpay public key
  "businessName": "My Store",
  "breakdown": {
    "subtotal": 1398,
    "discount": 100,
    "loyaltyDiscount": 50,
    "loyaltyPointsUsed": 100,
    "loyaltyPointsEarned": 12,
    "shipping": 50,
    "tax": 0,
    "gstInclusive": false,
    "total": 1198
  }
}

{
  "razorpay_order_id": "order_abc123",
  "razorpay_payment_id": "pay_xyz789",
  "razorpay_signature": "hmac_sha256_hex_string"
}

{
  "success": true
}

{
  "name": "Jane Doe",
  "phone": "9876543210",
  "email": "jane@example.com",
  "password": "securepass123",
  "address": "123 Main St, Mumbai",
  "refCode": "REF1A2B3C"
}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "customer": {
    "name": "Jane Doe",
    "phone": "9876543210",
    "email": "jane@example.com",
    "address": "123 Main St, Mumbai",
    "referral_code": "REF4D5E6F"
  }
}

{
  "phone": "9876543210",
  "password": "securepass123"
}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "customer": {
    "name": "Jane Doe",
    "phone": "9876543210",
    "email": "jane@example.com",
    "address": "123 Main St, Mumbai"
  }
}

{
  "customer": {
    "id": "uuid",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone": "9876543210",
    "address": "123 Main St, Mumbai",
    "referral_code": "REF4D5E6F"
  }
}

{
  "orders": [
    {
      "order_no": "ORD1A2B3C",
      "items": [{ "name": "T-Shirt", "price": 599, "qty": 1 }],
      "subtotal": 599,
      "shipping_fee": 50,
      "discount_amount": 0,
      "total": 649,
      "currency": "INR",
      "status": "confirmed",
      "payment_status": "paid",
      "created_at": "2026-04-10T09:15:00.000Z"
    }
  ]
}

{
  "reviews": [
    {
      "id": "uuid",
      "reviewer_name": "Jane D.",
      "rating": 5,
      "title": "Amazing quality!",
      "body": "Very soft fabric and great fit.",
      "verified": true,
      "created_at": "2026-04-08T14:30:00.000Z"
    }
  ],
  "count": 12,
  "average": 4.3
}

{
  "rating": 5,
  "title": "Excellent product!",
  "body": "Loved the quality and fast delivery.",
  "name": "John"
}

{
  "success": true,
  "id": "uuid",
  "created_at": "2026-04-13T10:00:00.000Z",
  "verified": false
}

{
  "wishlist": [
    {
      "id": "product-uuid",
      "name": "Organic T-Shirt",
      "price": 799,
      "sale_price": 599,
      "currency": "INR",
      "images": ["https://..."]
    }
  ]
}

{ "success": true }

{ "success": true }

{
  "enabled": true,
  "earn_rate": 5,          // 5% of order value earned as points
  "redeem_rate": 1,       // 1 point = 1 currency unit discount
  "points": 250
}

{
  "email": "subscriber@example.com",
  "name": "Jane",
  "source": "popup"
}

{ "success": true }

{
  "orderNo": "ORD1A2B3C",
  "phone": "9876543210"
}

{
  "order": {
    "order_no": "ORD1A2B3C",
    "buyer_name": "Jane Doe",
    "items": [...],
    "subtotal": 1198,
    "shipping_fee": 50,
    "discount_amount": 100,
    "total": 1148,
    "currency": "INR",
    "status": "shipped",
    "payment_status": "paid",
    "created_at": "2026-04-10T09:15:00.000Z",
    "updated_at": "2026-04-11T14:30:00.000Z"
  },
  "businessName": "My Store"
}

{
  "name": "Jane Doe",
  "email": "jane@example.com",
  "phone": "9876543210",
  "message": "I am interested in your services."
}

{
  "success": true,
  "message": "Thank you! We will get back to you soon."
}

{
  "message": "What are your shipping options?",
  "history": [
    { "role": "user", "content": "Hi there" },
    { "role": "assistant", "content": "Hello! How can I help?" }
  ]
}

{
  "reply": "We offer free shipping on orders above INR 999..."
}

{
  "password": "secret123"
}

{
  "success": true,
  "access_token": "hex_random_token_string"
}