> For the complete documentation index, see [llms.txt](https://docs.driffle.com/driffle-seller-api-legacy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.driffle.com/driffle-seller-api-legacy/reference/wholesale-pricing-feature.md).

# Wholesale Pricing Feature

The **Driffle Seller API** now supports **wholesale pricing tiers**, enabling sellers to offer dynamic, quantity-based pricing. This feature allows bulk buyers to receive automatic discounts based on predefined quantity thresholds, making large-order management more efficient and flexible.

### Key Features <a href="#key-features" id="key-features"></a>

* **Tier-based Pricing**: Define multiple wholesale levels with different discount percentages
* **Automatic Price Calculation**: System calculates wholesale prices based on your retail price and discount percentages
* **Flexible Configuration**: Enable/disable wholesale offers and manage multiple pricing tiers
* **Seamless Integration**: Works with existing offer creation and management endpoints
* **Default Wholesale Behavior**: When no wholesale object is provided, wholesale offers are created by default with 0% discount (same as retail price)

### Important Notes <a href="#important-notes" id="important-notes"></a>

#### Default Wholesale Behavior <a href="#default-wholesale-behavior" id="default-wholesale-behavior"></a>

**When no `wholesale` object is provided:**

* The system automatically creates wholesale offers with **0% discount** (same as retail offer `YourPrice` )
* This applies to both create and update API calls
* The wholesale offer will be enabled by default

**To apply discounts:**

* You **must** include the `wholesale` object in your request
* Define your desired discount percentages in the `tiers` array

**To disable wholesale offers:**

* You **must** explicitly send `"enabled": false` in the wholesale object
* Simply omitting the wholesale object will NOT disable wholesale offers

### Wholesale Object Structure <a href="#wholesale-object-structure" id="wholesale-object-structure"></a>

The wholesale feature uses a simplified `wholesale` object in request bodies:

```json
{
    "wholesale": {
        "enabled": true,
        "tiers": [
            {
                "level": 1,
                "discount": 10
            },
            {
                "level": 2,
                "discount": 15
            }
        ]
    }
}
```

#### Wholesale Object Properties <a href="#wholesale-object-properties" id="wholesale-object-properties"></a>

| Field     | Type    | Required | Description                                                                    |
| --------- | ------- | -------- | ------------------------------------------------------------------------------ |
| `enabled` | boolean | Yes      | Whether wholesale pricing is enabled for this offer.                           |
| `tiers`   | array   | No       | Array of pricing tiers with discount levels. **Required when enabled is true** |

#### Tier Object Properties <a href="#tier-object-properties" id="tier-object-properties"></a>

| Field      | Type   | Required | Description                 |
| ---------- | ------ | -------- | --------------------------- |
| `level`    | number | Yes      | Wholesale level (1, 2)      |
| `discount` | number | Yes      | Discount percentage (0-100) |

### Wholesale Levels <a href="#wholesale-levels" id="wholesale-levels"></a>

The system uses predefined levels that correspond to different quantity thresholds:

| Level | Typical Quantity Range |
| ----- | ---------------------- |
| 1     | 10-99 units            |
| 2     | 100+ units             |

### Price Calculation <a href="#price-calculation" id="price-calculation"></a>

Wholesale prices are automatically calculated using the following formula:

```
Wholesale YourPrice = Retail Offer YourPrice × (1 - Discount Percentage / 100)
```

For details, refer to the [API Reference](/driffle-seller-api-legacy/reference/api-reference.md) &#x20;