At a glance
Manages discounts, coupons and promotion rules, and validates them at checkout.
Key data
Receives from
- Marketing
- Product catalog
Sends to
- Cart
- CPQ
- Billing
How it works
The main steps, end to end.
- 1Create promotion and discount rules
- 2Generate or import coupons
- 3Validate eligibility at checkout
- 4Apply the discount
- 5Record redemption and limits
Core Capabilities
What Promotion Management provides
Discount Definition
- Define discount rules: percentage, fixed amount, free months
- Set discount applicability: plan, device, add-on or cart-level
- Configure discount duration: one-time, recurring N months, lifetime
- Link discounts to eligibility conditions from Campaign Management
- Supports stacking rules — which discounts can combine
Coupon Management
- Create coupon batches with unique codes for distribution
- Coupon types: single-use, reusable, prepaid, postpaid delivery
- Validates coupon code at point of quote creation
- Tracks coupon redemption count against batch limits
- Expires coupons automatically after validity period
Coupon Lifecycle
- Coupon batch states: Draft → Active → Exhausted → Expired
- Batch issuance: generated codes or subscriber-specific codes
- Supports bulk coupon generation for marketing distribution
- Coupon status per code: Available, Redeemed, Expired, Cancelled
Discount Validation
- Validates discount applicability at CPQ quote creation
- Checks eligibility: account type, existing plan, channel
- Prevents duplicate discount application on same quote item
- Returns applied discount details for price breakdown display
Promotion Reporting
- Tracks discount application rates per promotion
- Monitors coupon redemption against issuance
- Reports promotion financial impact: total discount amount applied
- Feeds into billing reporting for revenue assurance
Plan-level Promotions
- Manages promotions embedded in plan pricing (e.g. first 3 months free)
- Tracks promotional period per subscriber subscription
- Transitions pricing from promotional to standard on promotion end
- Handles missed-billing edge cases during promotional periods
Storage & Persistence
How and where PromotionManagement stores its data
Document Data Store
- Discount rule documents: type, amount, validity, eligibility
- Coupon batch documents: codes, issue counts, redemption counts
- Individual coupon state: Available, Redeemed, Expired, Cancelled
- Stacking rule configurations
Async Event Bus
- Coupon redeemed events to billing and reporting
- Batch exhausted alerts
- Discount applied events for revenue assurance
Search Index
- Coupon code validation at quote time
- Redemption history for audit
- Campaign coupon usage reporting
Design Principles
Key architectural decisions behind Promotion Management
Separation of Discount and Coupon
A discount is a rule (e.g. 20% off plan fee). A coupon is a delivery mechanism (a code the subscriber uses). Keeping these separate allows any discount to be delivered via multiple coupon types — or applied automatically without a code — without duplicating the discount definition.
Validate-first Approach
Discounts are only applied after eligibility validation at quote time. An expired coupon, already-redeemed code or ineligible subscriber is rejected before the quote is created — not after the order is placed, preventing downstream billing corrections.
Revenue Assurance Tracking
Every applied discount is recorded with the quote, order and billing account it belongs to. This audit trail enables finance teams to reconcile total discount liability against plan revenue and identify unexpected promotion over-application.
Detect coupon and referral abuse patterns.
Forecast cost and uptake before launch and track it after.
More in 30 AI & ML use cases and AIOps for BSS.