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

  • 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

Default Wholesale Behavior

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

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

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

Wholesale Object Properties

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

Field
Type
Required
Description

level

number

Yes

Wholesale level (1, 2)

discount

number

Yes

Discount percentage (0-100)

Wholesale Levels

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

Level
Typical Quantity Range

1

10-99 units

2

100+ units

Price Calculation

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

Last updated