Practical quantity pricing configurations with business context, setup details, and expected customer experience.
Example 1: Buy 5+, get 10% off
Scenario
Organic honey jars – encourage pantry stocking
Business goal
Increase units per order without changing catalog price
Configuration
Min 5, max empty, type percentage, price 10, currency usd, catalog $24
Customer experience
Qty 1-4 pays $24; qty 5+ pays $21.60 each
Calculation
$24 × 0.90 = $21.60/unit
Example 2: Buy 10+, fixed price
Scenario
Branded notebooks for corporate gifting
Business goal
Published case rate at 10 units
Configuration
Min 10, max empty, type fixed, price 8.50, currency usd
Customer experience
1-9 at catalog $12; 10+ at $8.50 flat
Calculation
Qty 15 → $8.50 × 15 = $127.50
Example 3: Buy 20+, wholesale price
Scenario
T-shirts for screen printers
Business goal
Wholesale breakpoint at 20 units
Configuration
Min 20, max empty, type fixed, price 6.25
Customer experience
Small orders at retail; bulk at $6.25/unit
Calculation
Qty 20 → $125.00 line total
Example 4: Multi-tier (3 levels)
Scenario
Premium olive oil – progressive savings
Business goal
Stair-step pricing
Configuration
Three rules on same product + currency
| Min | Max | Fixed price |
|---|---|---|
1 |
5 |
$18 |
6 |
20 |
$16 |
21 |
*(empty)* |
$14 |
| Customer experience | Price drops at 6 and 21 bottles |
| Calculation | Qty 25 → $14 × 25 = $350 |
Example 5: Variant-specific (48-pack only)
Scenario
Protein bars – single vs case SKU
Business goal
Case pricing without separate product
Configuration
Variant: 48-pack, min 2, fixed $38 (catalog $45)
Customer experience
Single bars at shelf price; multi-case cheaper
Calculation
2 cases → $76.00
Example 6: Fixed amount off – case of 12
Scenario
Wine by the bottle
Business goal
“Save $3 per bottle on a case of 12”
Configuration
Min 12, type fixed_discount, price 3, catalog $22
Customer experience
Case buyers save $3 per bottle
Calculation
$22 – $3 = $19/unit × 12 = $228
Example 7: Percentage tiers (graduated)
Catalog price $10:
| Min | Max | % off | Unit price |
|---|---|---|---|
5 |
9 |
5% |
$9.50 |
10 |
24 |
10% |
$9.00 |
25 |
*(empty)* |
15% |
$8.50 |
Qty 25 → $8.50/unit, line total $212.50
Example 8: INR currency tiers
Scenario
India market spices
Configuration
Currency inr – min 5 max 19 fixed ₹450; min 20+ fixed ₹380
Calculation
Qty 20 → ₹380 × 20 = ₹7,600
Example 9: Reference list price
Scenario
New product – no Medusa variant price yet
Configuration
Reference $100, min 5, percentage 10
Calculation
$100 × 0.90 = $90/unit at 5+
Example 10: Tier gap (catalog below threshold)
Scenario
Industrial gloves – retail below 50, wholesale at 50+
Configuration
Only rule: min 50, fixed $2.10 (catalog $3.50)
Customer experience
Qty 1-49 = catalog; qty 50+ = $2.10
Calculation
Qty 50 → $105.00
Example 11: Buy 50+, distributor pricing
Scenario
Energy drink cans – regional distributors
Configuration
Min 50, fixed $1.15
Calculation
Qty 100 → $115.00
Example 12: Customer group (API)
VIP retailers get a better rate via customer_group_id:
{
"product_id": "prod_01XXXXXXXX",
"min_qty": 10,
"max_qty": null,
"pricing_type": "fixed",
"price": 75,
"currency_code": "usd",
"customer_group_id": "cusgroup_01XXXXXXXX"
}Logged-in VIP customers: $75/unit at 10+. Others see standard tiers.
Quick reference
| Pattern | Best pricing type | Typical breakpoints |
|---|---|---|
Retail bulk nudge |
Percentage |
3+, 5+, 10+ |
Published case price |
Fixed |
10+, 24+ |
Wholesale |
Fixed |
20+, 50+, 100+ |
“$X off” promo |
Fixed discount |
12+, 24+ |
B2B segment |
Fixed + customer group |
Contract-specific |