Create prices

Create or replace existing product prices with support for regular pricing, discounts, and tiered pricing.

<h3>Pricing structure</h3>

Each price record can include:

• Regular Price - The base price for the product SKU
• Discounts - Percentage or fixed amount discounts applied to the regular price
• Tiered Pricing - Quantity-based pricing for bulk purchases

<h3>Discount configuration</h3>

Discounts can be configured in two ways:

• Fixed Amount Discounts - Use price field to specify a fixed discount amount (e.g., 10.00 for $10 off)
• Percentage Discounts - Use percentage field to specify a discount percentage (e.g., 20 for 20% off)

Each discount requires a unique code identifier to distinguish between different discount types.

<h3>Tiered pricing</h3>

Tiered pricing offers different prices based on purchase quantity:

• Tier Fixed Prices - Use price field with qty to specify quantity-based fixed prices
• Tier Percentage Discounts - Use percentage field with qty to specify quantity-based percentage discounts

Tier quantities must be greater than 1.

<h3>Pricing for configurable products</h3> Because configurable product price is calculated based on the price of the selected product variant, you don't need to send the price data for configurable product SKUs. Sending price data for these SKUs can cause incorrect price calculations.

[
  {
    "sku": "red-pants-xl",
    "priceBookId": "us-retail",
    "regular": 29.99,
    "discounts": [
      {
        "code": "seasonal_sale",
        "percentage": 15
      },
      {
        "code": "loyalty_discount",
        "price": 5
      }
    ],
    "tierPrices": [
      {
        "qty": 5,
        "percentage": 10
      },
      {
        "qty": 10,
        "price": 25
      }
    ]
  }
]