Create Discount Programs

Learn how to configure discount types, conditions, and pricing models for your promotions.

Overview​

Suppliers create promotions for stores to offer time-limited or ongoing discounts on product prices. Each promotion applies a specific discount type and can target products based on configurable conditions.

For step-by-step instructions on creating and managing promotions in the platform, see Creating Sales Promos.

Understanding Promotion Types​

Choose one of the following discount types when you create a promotion:

• Fixed Price — Set a specific sale price for the product (for example, $51.50).
• Percentage Off — Subtract a percentage from the price (for example, 20% off).
• Percentage Off Cart — Apply a percentage discount off the total cart value (for example, 15% off).
• Amount Off — Subtract a fixed amount from the price (for example, $100 off).

Configuring Promotion Conditions​

Define one or more conditions to control which products a promotion applies to. A product must meet all defined conditions for the promotion to take effect.

• Products — Include specific products by their product identifiers.
• Categories — Include all products within selected categories.
• Brands — Include all products that match selected brands.
• Manufacturers — Include all products that match selected manufacturers.
• Countries — Include all products sold in selected countries.
• Currencies — Include all products priced in selected currencies.
• Basket — Include baskets based on a total price condition: greater than or less than a set amount.
• Item — Include specific products based on a price condition: greater than or less than a set amount.

Understanding Promotion Resolution​

The system calculates final prices using the following logic:

1. Fetch the base price for the product based on the buyer's quantity, country, and currency.
2. Apply any fixed_price promotions first. These override the base price.
3. If no fixed_price promotions exist, apply percentage_off promotions first, then amount_off promotions.
   • percentage_off promotions reduce the running price by a percentage, applied sequentially.
   • amount_off promotions reduce the running price by a fixed amount, applied sequentially.
4. Set the running price to 0 if it drops below zero after all promotions.
5. Return both the base price and the final price.

Reviewing Promotion Approvals​

In B2B relationships, all price changes require auditability and approval from procurement, including promotions.

Setting Up Complex Pricing Models​

Use volume or graduated pricing models for tiered discount structures.

1. Select a currency for the pricing model
2. Populate the pricing table with tier details
3. Add new tiers by selecting + Add another tier. Remove tiers with the trash icon.

Volume Pricing​

For each tier in a volume pricing model:

• Last unit — The inclusive cutoff quantity for the tier.
• Per unit — The price per unit for all units if the total quantity falls within the tier.
• Flat amount — An optional additional charge for the tier.

Graduated Pricing​

For each tier in a graduated pricing model:

• Last unit — The inclusive cutoff quantity for the tier.
• Per unit — The price per unit for only the units within the tier.
• Flat amount — An optional additional charge for the tier.

Promotion Fields Reference​

Use the following fields when you create a promotion through the UI or API:

Creating a Promotion with the API​

Find the Store ID​

Provide the store ID in the request URL. To find the store ID, search for the store on the Stores page.

Examples​

Amount off promotion​

Create a promotion for store ID 1 with a $10 discount for all products in category ID 2.

curl --location --request POST 'https://api.axiomdata.io/api/suppliers/promotions/stores/1' \
--data-raw '{
    "name": "Promotion Name",
    "description": "A description of the promotion",
    "promotion_message": "Check out this promotion",
    "promotion_url": "http:\/\/www.example.info",
    "conditions": [
        {
            "categories": {
                "type": "include",
                "ids": [
                    2
                ]
            }
        }
    ],
    "actions": {
        "amount_off": [
            {
                "currency": "USD",
                "unit_amount": 10,
                "billing_scheme": "standard"
            }
        ]
    }
}'

Percentage off promotion​

Create a promotion for store ID 1 with a 10% discount for product identifiers product1, product2, and product3.

curl --location --request POST 'https://api.axiomdata.io/api/suppliers/promotions/stores/1' \
--data-raw '{
    "name": "Promotion Name",
    "description": "A description of the promotion",
    "promotion_message": "Check out this promotion",
    "promotion_url": "http:\/\/www.example.info",
    "conditions": [
        {
            "products": {
                "type": "include",
                "ids": [
                    "product1",
                    "product2",
                    "product3"
                ]
            }
        }
    ],
    "actions": {
        "percentage_off": [
            {
                "percentage": "20",
                "billing_scheme": "standard"
            }
        ]
    }
}'

Fixed price promotion​

Create a promotion for store ID 1 with a fixed price of $50 for variant identifier variant1.

curl --location --request POST 'https://api.axiomdata.io/api/suppliers/promotions/stores/1' \
--data-raw '{
    "name": "Promotion Name",
    "description": "A description of the promotion",
    "promotion_message": "Check out this promotion",
    "promotion_url": "http:\/\/www.example.info",
    "conditions": [
        {
            "products": {
                "type": "include",
                "ids": [
                    "variant1"
                ]
            }
        }
    ],
    "actions": {
        "fixed_price": [
            {
                "currency": "USD",
                "unit_amount": 10,
                "billing_scheme": "standard"
            }
        ]
    }
}'

Graduated amount off promotion​

Create a promotion for store ID 1 with a graduated discount for all products with the brand Example.

curl --location --request POST 'https://api.axiomdata.io/api/suppliers/promotions/stores/1' \
--data-raw '{
    "name": "Promotion Name",
    "description": "A description of the promotion",
    "promotion_message": "Check out this promotion",
    "promotion_url": "http:\/\/www.example.info",
    "conditions": [
        {
            "brands": {
                "type": "include",
                "names": [
                    "Example"
                ]
            }
        }
    ],
    "actions": {
        "amount_off": [
            {
                "currency": "GBP",
                "billing_scheme": "graduated",
                "tiers": [
                    {
                        "up_to": 10,
                        "flat_amount": "5",
                        "unit_amount": "10"
                    },
                    {
                        "up_to": 100,
                        "flat_amount": "5",
                        "unit_amount": "20"
                    },
                    {
                        "up_to": 1000000000,
                        "flat_amount": "5",
                        "unit_amount": "25"
                    }
                ]
            }
        ]
    }
}'