Seller Orchestra Internal API Mapping

Theme

Manage storefront themes, marketplace templates, and theme customization

3-Layer Architecture

Seller API Gateway Seller Admin (Orchestra Layer) Theme / Utility Service (Core Microservices)

1 Master Themes APIs

Fetch Master Themes

List all available themes from the marketplace

GET
GET /merchant/api/v1/themes?domain_id={{domain_id}} Gateway
Query: theme_plan=[free|premium], page, size
GET /api/themes Seller Admin

Returns themes with already_added flag per domain

1 GET /api/themes Theme Service
2 GET /api/storefront-themes?domain_id=:domain_id Theme Service

Get Master Theme

Get details of a specific master theme

GET
GET /merchant/api/v1/themes/:theme_id Gateway
GET /api/themes/:theme_id Seller Admin
1 GET /api/themes/:theme_id Theme Service

2 Storefront Themes APIs

List Storefront Themes

List all themes installed for a domain

GET
GET /merchant/api/v1/domains/:domain_id/themes Gateway
GET /api/storefront-themes?domain_id=:domain_id Seller Admin
1 GET /api/storefront-themes?domain_id=:domain_id Theme Service

Create Storefront Theme

Install a master theme to a domain

POST
POST /merchant/api/v1/domains/:domain_id/themes Gateway
POST /api/storefront-themes Seller Admin

Request Body:

{
  "theme_id": "6799ca2d2accf568166dd6dc",
  "default_theme_path": "../themes/theme-3",
  "status": "DRAFT",
  "is_active": true
}
1 GET /api/themes/:theme_id Theme Service
2 POST /api/storefront-themes Theme Service
3 POST /api/storefront-themes/:id/initialize Theme Service

Purchase Storefront Theme

Purchase a premium theme with payment processing

POST
POST /merchant/api/v1/domains/:domain_id/themes/purchase Gateway
POST /api/themes/purchase Seller Admin

Request Body:

{
  "theme_id": "6799ca2d2accf568166dd6dd",
  "client_redirect_url": "https://abc.com/callback"
}
1 GET /api/themes/:theme_id Theme Service
2 POST /api/theme-transactions Theme Service
3 POST /api/payments/initiate Payment Service (JUSPAY/Stripe)

Update Storefront Theme

Update theme configuration, path, or status

PUT
PUT /merchant/api/v1/domains/:domain_id/themes/:theme_id Gateway
PUT /api/storefront-themes/:theme_id Seller Admin
1 PUT /api/storefront-themes/:theme_id Theme Service
2 POST /api/cdn/invalidate CDN Service

Set Default Theme

Set a theme as the default active theme for domain

PUT
PUT /merchant/api/v1/domains/:domain_id/themes/:theme_id/default Gateway
PUT /api/storefront-themes/:theme_id/default Seller Admin
1 PUT /api/storefront-themes/unset-default Theme Service
2 PUT /api/storefront-themes/:theme_id/default Theme Service
3 POST /api/cdn/invalidate CDN Service

Delete Storefront Theme

Remove a theme from the domain

DELETE
DELETE /merchant/api/v1/domains/:domain_id/themes/:theme_id Gateway
DELETE /api/storefront-themes/:theme_id Seller Admin
1 DELETE /api/storefront-themes/:theme_id Theme Service
2 DELETE /api/cdn/assets/:theme_id CDN Service

3 Theme Transactions

Get Theme Transaction

Get theme purchase transaction details

GET
GET /merchant/api/v1/domains/:domain_id/theme_transactions/:id Gateway
GET /api/theme-transactions/:id Seller Admin
1 GET /api/theme-transactions/:id Theme Service
2 GET /api/payments/:payment_id Payment Service

Documentation Notes

1

Master vs Storefront: Master themes are global marketplace templates; storefront themes are domain-specific instances

2

Premium Themes: Require payment via JUSPAY/Stripe before installation

3

Status Values: DRAFT, PUBLISHED, ARCHIVED

4

Subscription Levels: FREE, STARTER, PROFESSIONAL, ENTERPRISE

Open full text mapping