Tiered Product Pricing

Multi-tier pricing per product (volume discounts) with currency-aware localisation. Quotes auto-pick the right tier based on quantity.


What It Does

When to Use

Any product with volume discounts. Without tiered pricing your sales team has to manually price every quote.

Defining Tiers

curl -X POST https://api.anvilhk.com/api/v1/products/$PRODUCT_ID/tiers \
  -H "Authorization: Bearer $ANVIL_KEY" \
  -H "X-Tenant-ID: $TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "USD",
    "tiers": [
      { "minQty": 1, "maxQty": 99, "unitPrice": 50 },
      { "minQty": 100, "maxQty": 499, "unitPrice": 45 },
      { "minQty": 500, "maxQty": null, "unitPrice": 40 }
    ]
  }'

Currency & Localisation

Each currency has its own tier ladder. If a buyer requests CAD and you only have USD tiers, Anvil converts at the live FX rate (/api/v1/fx-rates) and rounds to the nearest sensible figure.

API Endpoints

Pricing & Limits

Gotchas