Product Price Table Products Variants

This documentation explains how to configure specific discounts for individual products and their variants within a product price table, allowing merchants to set custom pricing rules at the product and variant level.

Properties

Property	Explanation	Type	Required
product_id	The unique identifier for the product	String	true
product_variant_id	The unique identifier for the product variant	String	true
discount	Discount that will be applied to product variant	String	true
price	Fixed price that will be applied to product variant	String	false

Endpoints

PUT /products/price-tables/{id}/products-variants

Updates one or more products variants exceptions in a product price table.

PUT /products/price-tables/1/products-variants

[
  {
    "product_id": "136548284",
    "product_variant_id": "136548285",
    "discount": "20.00",
    "price": "150.00"
  },
  {
    "product_id": "246818282",
    "product_variant_id": "246818285",
    "discount": "10.00",
    "price": "250.00"
  },
  {
    "product_id": "358965478",
    "product_variant_id": "358965484",
    "discount": "0.00",
    "price": "350.00"
  }
]

HTTP/1.1 204 No Content

{}

GET /products/price-tables/{id}/products-variants/{id}

Gets a specific product variant exception from a product price table.

GET /products/price-tables/1/products-variants/136548285

HTTP/1.1 200 Ok

{
  "price_table": {
    "id": "1",
    "verification_code": "5a23d45e-52b4-470f-8cf8-ff959b9ef0fa",
    "store_id": "3776871",
    "name": "Price Table",
    "default_discount": "7.00",
    "cart_minimum_price": "250.00",
    "cart_minimum_quantity": 30,
    "active": true,
    "created_at": "2025-11-17T15:12:39.396Z",
    "updated_at": "2025-11-23T12:48:52.132Z",
    "has_categories": true,
    "has_products_variants": false,
    "has_customers": true,
    "product_variants": [
      {
        "product_id": "136548284",
        "product_variant_id": "136548285",
        "discount": "20.00",
        "price": "150.00"
      }
    ]
  }
}

GET /products/price-tables/{id}/products-variants

Returns a paginated list of products variants from the product price table.

Parameter	Explanation
page	Page to show
per_page	Amount of results

GET /products/price-tables/1/products-variants?page=1&per_page=50

HTTP/1.1 200 Ok

{
  "total": 3,
  "page": 1,
  "price_table": {
    "id": "1",
    "verification_code": "5a23d45e-52b4-470f-8cf8-ff959b9ef0fa",
    "store_id": "3776871",
    "name": "Price Table",
    "default_discount": "7.00",
    "cart_minimum_price": "250.00",
    "cart_minimum_quantity": 30,
    "active": true,
    "created_at": "2025-11-17T15:12:39.396Z",
    "updated_at": "2025-11-23T12:48:52.132Z",
    "has_categories": true,
    "has_products_variants": false,
    "has_customers": true,
    "product_variants": [
      {
        "product_id": "136548284",
        "product_variant_id": "136548285",
        "discount": "20.00",
        "price": "150.00"
      },
      {
        "product_id": "246818282",
        "product_variant_id": "246818285",
        "discount": "10.00",
        "price": "250.00"
      },
      {
        "product_id": "358965478",
        "product_variant_id": "358965484",
        "discount": "0.00",
        "price": "350.00"
      }
    ]
  }
}

DELETE /products/price-tables/{id}/products-variants/{id}

Delete a specific product variant exception from a product price table.

DELETE /products/price-tables/1/products-variants/136548285

HTTP/1.1 204 No Content

{}

FAQ

How to use only the percentage discount

If you would like to use only percentage discount for product variant in a Product Price table, the following body should be sent:

[
  {
    "product_id": "136548284",
    "product_variant_id": "136548285",
    "discount": "20.00",
    "price": null
  }
]

HTTP/1.1 204 No Content

{}

How to clear all products variants exceptions of a Product Price Table

If you would like to update to clear all products variants in a product price table, the following body should be sent:

[]

HTTP/1.1 204 No Content

{}

How to create a Product Price Table?

See the main Product Price Tables documentation for instructions on creating a price table (link with documentation).