Seller Orchestra Internal API Mapping

Coupons & Promotions

Coupon rules, validity, usage limits, and promotional campaigns

3-Layer Architecture

Seller API Gateway Seller Promotions Promotions Service

Create Coupon

Define coupon code, rules, validity, and usage limits

POST
POST /merchant/api/v1/domains/:domain_id/coupons
POST /api/coupons

Flow:

  1. Validate code uniqueness within domain
  2. Validate discount rules and limits
  3. Create coupon in Promotions Service
  4. Index for promotion engine
1 POST /api/coupons Promotions Service · Core Microservices

List Coupons

List all coupons with filters and pagination

GET
GET /merchant/api/v1/domains/:domain_id/coupons
1 GET /api/coupons?domain_id=:domain_id Promotions Service · Core Microservices

Update Coupon

Update coupon rules, limits, and validity

PATCH
PATCH /merchant/api/v1/domains/:domain_id/coupons/:id
1 PATCH /api/coupons/:id Promotions Service · Core Microservices

Delete Coupon

Deactivate or delete a coupon

DELETE
DELETE /merchant/api/v1/domains/:domain_id/coupons/:id
1 DELETE /api/coupons/:id Promotions Service · Core Microservices

Documentation Notes

Coupons support percentage discounts, fixed amounts, BOGO, and product-specific rules.

Open full text mapping