medusa-pricing

Medusa v2 Pricing and Promotions

Before writing code

Fetch live docs:

1. Web-search site:docs.medusajs.com pricing module for pricing data model and service methods
2. Web-search site:docs.medusajs.com price list rules for conditional pricing configuration
3. Web-search site:docs.medusajs.com promotion module for promotion types and rules
4. Fetch https://docs.medusajs.com/resources/references/pricing and review the IPricingModuleService interface
5. Web-search medusajs v2 tax module region 2026 for latest tax calculation and region setup

Pricing Module Architecture

Entity Relationships

PriceSet
├── Prices[]
│   ├── amount (integer, minor units)
│   ├── currency_code
│   ├── min_quantity, max_quantity
│   └── Rules[] (region_id, customer_group_id)
└── MoneyAmounts[]

Module Links

Product Module (variant) ──link──> Pricing Module (price set)
Region Module ──link──> Pricing Module (price context)
Customer Group ──link──> Pricing Module (group pricing)

Fetch live docs for exact link definitions and how price sets connect to product variants.

Price Calculation

Resolution Flow

Customer Request
  └─> Context: { region_id, currency_code, customer_group_id }
        └─> Pricing Module: find best matching price
              ├── Check price lists (sale/override) with rules
              ├── Check variant prices with matching rules
              └─> Return lowest applicable price

Pricing Context

Context Field	Source	Effect
region_id	Cart region	Filters by region-specific prices
currency_code	Region default	Determines currency
customer_group_id	Customer profile	Enables group-specific pricing
quantity	Line item qty	Enables quantity-based tiers

Price Lists

Types

Type	Description	Use Case
sale	Discounted price (lower than default)	Seasonal sales, flash deals
override	Replaces default price entirely	B2B/wholesale pricing