WAGERBABE DOCS
All Stories
9-5-1-promotion-management-apiBacklogEpic 9.5

Story 9.5.1: Promotion Management API

**Epic:** Epic 9.5 - Odds Boost & Promotions **Story ID:** 9.5.1 **Created:** 2025-12-08 **Status:** ready-for-dev **Priority:** P1 (High - Key competitive differentiator) **Effort:** 10-12 hours

Acceptance Criteria

  • [ ] **AC-9.5.1-1:** Agent can create promotion with type (odds_boost, bonus_credit, risk_free, profit_boost)
  • [ ] **AC-9.5.1-2:** Promotion includes: name, description, type, value, start/end dates, max_total_uses, max_per_user
  • [ ] **AC-9.5.1-3:** Promotion can target: all customers, new users only, specific users, high-volume users
  • [ ] **AC-9.5.1-4:** Agent can pause/resume/cancel active promotions via PATCH endpoint
  • [ ] **AC-9.5.1-5:** Validation prevents overlapping promotions of same type during same time period
  • [ ] **AC-9.5.1-6:** Promotion history retained for compliance and analytics (soft delete)
  • [ ] **AC-9.5.1-7:** Promotions support min/max stake limits and min odds requirements
  • [ ] **AC-9.5.1-8:** Promotions can be restricted to specific sports or market types
  • [ ] **AC-9.5.1-9:** List promotions endpoint includes usage stats (total uses, unique users, cost)
  • [ ] **AC-9.5.1-10:** Status transitions validated (active → paused/cancelled, paused → active/cancelled)
  • [ ] AC-9.5.1-11: Scheduled promotions (auto-activate at start_date)
  • [ ] AC-9.5.1-12: Promotion templates for quick creation

Progress

Tasks0/0
Acceptance Criteria12
Total Tasks0

Navigation

View Epic 9.5All Stories