Seller Orchestra Internal API Mapping

Products

Product lifecycle: create, update, inventory and pricing management for seller storefronts

3-Layer Architecture

Seller API Gateway Seller Admin (Orchestra Layer) Catalogue Service (Core Microservices)

Create Product

Create a new product with variants, pricing, and metadata

POST
POST /merchant/api/v1/domains/:domain_id/products
POST /api/products Seller Admin · Orchestra Layer
1 POST /api/products Catalogue Service · Core Microservices

List Products

Retrieve all products for the domain with pagination

GET
GET /merchant/api/v1/domains/:domain_id/products
GET /api/products?domain_id=:domain_id Seller Admin · Orchestra Layer
1 GET /api/products?domain_id=:domain_id Catalogue Service · Core Microservices

Get Product

Retrieve single product with variants and pricing

GET
GET /merchant/api/v1/domains/:domain_id/products/:id
GET /api/products/:id Seller Admin · Orchestra Layer
1 GET /api/products/:id Catalogue Service · Core Microservices

Update Product

Update product details, variants, and metadata

PATCH
PATCH /merchant/api/v1/domains/:domain_id/products/:id
PATCH /api/products/:id Seller Admin · Orchestra Layer
1 PATCH /api/products/:id Catalogue Service · Core Microservices

Delete Product

Delete a product

DELETE
DELETE /merchant/api/v1/domains/:domain_id/products/:id
DELETE /api/products/:id Seller Admin · Orchestra Layer
1 DELETE /api/products/:id Catalogue Service · Core Microservices

Update Inventory

Update product stock and inventory levels

POST
POST /merchant/api/v1/domains/:domain_id/products/:id/inventory
POST /api/products/:id/inventory Seller Admin · Orchestra Layer
1 POST /api/products/:id/inventory Catalogue Service · Core Microservices

Update Pricing

Update product pricing and discounts

PATCH
PATCH /merchant/api/v1/domains/:domain_id/products/:id/pricing
PATCH /api/products/:id/pricing Seller Admin · Orchestra Layer
1 PATCH /api/products/:id/pricing Catalogue Service · Core Microservices

Documentation Notes

Products support variants, multiple pricing tiers, inventory tracking, and search indexing for storefront display.

Open full text mapping