Skip to main content
Suggest Edits The effect is an optional discount property that is applied to coupon, in-cart, and referral discounts. 
{
  "percent_off": 10.0,
  "type": "PERCENT",
  "effect": "APPLY_TO_ORDER" 
}
Here’s a list of all effects that you can add to different discount types.
Discount TypeEffects
Amount discount“APPLY_TO_ORDER”“APPLY_TO_ITEMS”“APPLY_TO_ITEMS_PROPORTIONALLY”“APPLY_TO_ITEMS_PROPORTIONALLY_BY_QUANTITY""APPLY_TO_ITEMS_BY_QUANTITY”
Percentage discount“APPLY_TO_ORDER”“APPLY_TO_ITEMS”
Unit discount“ADD_NEW_ITEMS”“ADD_MISSING_ITEMS”“ADD_MANY_ITEMS”

​
Apply to Order

Discount type: percentage, amount Using this effect, the discount is applied to the total order amount. 
{
    "category": "New Customers",
    "type": "DISCOUNT_VOUCHER",
    "discount": {
        "percent_off": 10.0,
        "type": "PERCENT",
        "effect": "APPLY_TO_ORDER"
    },
    "start_date": "2021-01-01T00:00:00Z",
    "expiration_date": "2025-12-31T23:59:59Z",
    "redemption": {
        "quantity": 1000 
    },
    "metadata": {
      "test": true,
      "locale": "de-en"
    }
  } // POST https://api.voucherify.io/v1/vouchers/SALECODE
  ```
  ```json Redeem request
  {
    "customer": {
        "source_id": "track_+EUcXP8XGf3mYmWxbJvEosmKXi3Aw",
        "name": "Alice Morgan",
        "email": "[email protected]",
        "metadata": {
            "locale": "en-GB",
            "shoeSize": 5,
            "favourite_brands": [
                "Armani",
                "L’Autre Chose",
                "Vicini"
            ]
        }
    },
    "order": {
        "amount": 20050,
        "items": [
            {
                "object": "order_item",
                "product_id": "prod_08ef2e7173d43e4f1d",
                "quantity": 1,
                "amount": 3000,
                "price": 3000,
                "product": {
                    "id": "prod_08ef2e7173d43e4f1d",
                    "name": "T-shirt",
                    "metadata": {},
                    "price": 3000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_08ef2e82bfd43e4f60",
                "quantity": 1,
                "amount": 2000,
                "price": 2000,
                "product": {
                    "id": "prod_08ef2e82bfd43e4f60",
                    "name": "Pen",
                    "metadata": {},
                    "price": 2000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_08ef2e94d2543e4fa7",
                "quantity": 2,
                "amount": 1000,
                "price": 1000,
                "product": {
                    "id": "prod_08ef2e94d2543e4fa7",
                    "name": "Mug",
                    "metadata": {},
                    "price": 1000
                }
            }
        ]
    },
    "metadata": {
        "locale": "en-GB"
    }
}

​
Apply to Items

Discount type: percentage, amount Using this effect, the discount is applied only to particular items defined by validation rules. While creating a discount, you need to add the effect to the discount object and define the list of discounted products using validation rules. You also need to define the maximum units that are allowed to have the discount applied in the validation rule. There are two limits. One defines the maximum units of a particular product that are allowed to be discounted per order line. The other defines the maximum number of units that are allowed to be discounted combined for all order lines matching the constrained item. As a result, the discount is applied to predefined products, and each of them is discounted equally at most up to the maximum limit allowed. The discount applied to each included item is equal to a discount value defined by discount.amount_off or discount.percent_off. 
{
  "amount_off": 1000, // discount applied to each discounted item
  "type": "AMOUNT",
  "effect": "APPLY_TO_ITEMS" 
}
We highly recommend creating campaigns and validation rules (steps 1-3) using the dashboard. In comparison to the same workflow done via the API, the Campaign Manager in your dashboard reduces the number of steps you need to follow to create a campaign with rules.
Step 1: Create validation rules Create Validation Rules to define discounted items. There are two ways validation rules define qualified items:
  • If items are added to the Products, you can create validation rules using their names/ internal IDs and static collections.
  • If items are not added to the Products, you can use dynamic product collections and define filters that qualified items need to match. Read more.
To choose products that qualify for a discount/ gift card, you can select items from your existing products list or build a product collection. Product collections define what criteria items in a customer’s cart need to match to qualify for a discount. Likewise, you can use collections to define criteria for excluded items. Read how to build and use collections.
Step 2: Create discount voucher/campaign Create a voucher, campaign, or cart-level promotion with the apply to items discount effect. 
{
    "category": "Product-specific",
    "type": "DISCOUNT_VOUCHER",
    "discount": {
        "amount_off": 1000,
        "type": "AMOUNT",
        "effect": "APPLY_TO_ITEMS"
    },
    "start_date": "2021-01-01T00:00:00Z",
    "expiration_date": "2025-12-31T23:59:59Z",
    "redemption": {
        "quantity": 1000
    },
    "metadata": {
        "test": true,
        "locale": "de-en"
    }
} // POST https://api.voucherify.io/v1/vouchers/SALE-$10
Step 3: Assign validation rules Create Validation Rules Assignment to attach validation rules with discounted products to the created discount. If you create a campaign in the dashboard, you can create new rules on the spot or select existing rules from the list. Choosing the rules in the Manager automatically assigns them to the campaign. Read more about validation rules Redemption While redeeming the code, each item defined in the validation rules will be discounted. 
{
    "customer": {
        "source_id": "tracking-id-test"
    },
    "order": {
        "amount": 195000,
        "items": [
            {
                "object": "order_item",
                "product_id": "prod_08f19debbb4715ddda",
                "quantity": 1,
                "amount": 2000,
                "discount_amount": 1000,
                "price": 2000,
                "product": {
                    "id": "prod_08f19debbb4715ddda",
                    "source_id": "mug-2021track98",
                    "name": "Mug Regular",
                    "metadata": {},
                    "price": 2000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_08f19eba8d0715dde0",
                "quantity": 1,
                "amount": 8000,
                "discount_amount": 1000,
                "price": 8000,
                "product": {
                    "id": "prod_08f19eba8d0715dde0",
                    "source_id": "pen-2021track54",
                    "name": "Pen Limited Gold Edition",
                    "metadata": {},
                    "price": 8000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_08eb194cab0eab36f3",
                "quantity": 1,
                "amount": 5000,
                "price": 5000,
                "product": {
                    "id": "prod_08eb194cab0eab36f3",
                    "source_id": "5900232130712",
                    "name": "T-SHIRT",
                    "metadata": {},
                    "price": 5000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_f1r5Tpr0DuC7",
                "quantity": 1,
                "amount": 180000,
                "price": 180000,
                "product": {
                    "id": "prod_f1r5Tpr0DuC7",
                    "source_id": "test_prod_id_1",
                    "name": "Apple iPhone 8",
                    "metadata": {
                        "test": true,
                        "vendor": "Cortland"
                    },
                    "price": null
                }
            }
        ]
    }
} // POST https://api.voucherify.io/v1/vouchers/SALE-$10/redemption

​
Apply to Items Proportionally

Discount type: amount Using this effect, the discount is divided and applied only to particular items defined by validation rules. While creating a discount, you need to add effect to the discount object and define the list of discounted products using validation rules. As a result, the discount is applied to chosen products only, and each of them is discounted proportionally to its share in the total amount of discounted items. The total discount amount applied to all items equals the discount value defined by discount.amount_off. 
{
  "amount_off": 1000, // total discount amount applied to all discounted items
  "type": "AMOUNT",
  "effect": "APPLY_TO_ITEMS_PROPORTIONALLY"
}
We highly recommend creating campaigns and validation rules (steps 1-3) using the dashboard. In comparison to the same workflow done via the API, the Campaign Manager in your dashboard reduces the number of API calls (made to create a campaign with rules).
Step 1: Create validation rules Create Validation Rules to define discounted items as described here. Step 2: Create discount voucher/campaign Create a voucher, campaign, or cart-level promotion with the apply to items proportionally effect. 
{
    "category": "Product-specific",
    "type": "DISCOUNT_VOUCHER",
    "discount": {
        "amount_off": 1000,
        "type": "AMOUNT",
        "effect": "APPLY_TO_ITEMS_PROPORTIONALLY"
    },
    "start_date": "2021-01-01T00:00:00Z",
    "expiration_date": "2025-12-31T23:59:59Z",
    "redemption": {
        "quantity": 1000
    },
    "metadata": {
        "test": true,
        "locale": "de-en"
    }
} // POST https://api.voucherify.io/v1/vouchers/10PROPRTIOANLLY
Step 3: Assign validation rules Create Validation Rules Assignment to attach validation rule with discounted products to the created discount. Redemption While redeeming the code, each item defined in validation rules will be discounted proportionally to its share in the total amount and the sum of item discounts matches the total discount value (discount.amount_off). In the response body, you can also see the applicable_to object that lists all items that qualify for a discount. 
{
    "customer": {
        "source_id": "tracking-id-test"
    },
    "order": {
        "amount": 195000,
        "items": [
            {
                "object": "order_item",
                "product_id": "prod_08f19debbb4715ddda",
                "quantity": 1,
                "amount": 2000,
                "price": 2000,
                "product": {
                    "id": "prod_08f19debbb4715ddda",
                    "source_id": "mug-2021track98",
                    "name": "Mug Regular",
                    "metadata": {},
                    "price": 2000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_08f19eba8d0715dde0",
                "quantity": 1,
                "amount": 8000,
                "price": 8000,
                "product": {
                    "id": "prod_08f19eba8d0715dde0",
                    "source_id": "pen-2021track54",
                    "name": "Pen Limited Gold Edition",
                    "metadata": {},
                    "price": 8000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_08eb194cab0eab36f3",
                "quantity": 1,
                "amount": 5000,
                "price": 5000,
                "product": {
                    "id": "prod_08eb194cab0eab36f3",
                    "source_id": "5900232130712",
                    "name": "T-SHIRT",
                    "metadata": {},
                    "price": 5000
                }
            },
            {
                "object": "order_item",
                "product_id": "prod_f1r5Tpr0DuC7",
                "quantity": 1,
                "amount": 180000,
                "price": 180000,
                "product": {
                    "id": "prod_f1r5Tpr0DuC7",
                    "source_id": "test_prod_id_1",
                    "name": "Apple iPhone 8",
                    "metadata": {
                        "test": true,
                        "vendor": "Cortland"
                    },
                    "price": null
                }
            }
        ]
    }
}

​
Apply to Items Proportionally by Quantity

Discount type: amount Likewise, the discount is divided and applied only to particular items defined by validation rules. While creating a discount, you need to add effect to the discount object and define the list of discounted products using validation rules. As a result, the discount is applied to chosen products only, and each of them is discounted proportionally to its share in the total quantity of discounted items. The total discount amount applied to all items equals the discount value defined by discount.amount_off. 
{
  "amount_off": 1000, // total discount amount applied to all discounted items
  "type": "AMOUNT",
  "effect": "APPLY_TO_ITEMS_PROPORTIONALLY_BY_QUANTITY"
}

​
Apply to Items to each unit of matched product

Discount type: amount Likewise, the discount is divided and applied only to particular items defined by validation rules. While creating a discount, you need to add the effect to the discount object and define the list of discounted products using validation rules. You also need to define the maximum units that are allowed to have the discount applied in the validation rule. As a result, the discount is applied to chosen products only, and each unit of the product is discounted at most up to the maximum limit allowed. The total discount amount applied to all items equals the number of discounted units multiplied by the discount amount. The discount value defined by discount.amount_off is the discount amount that will be applied to each unit. 
"discount": {
    "type": "AMOUNT",
    "amount_off": 500,
    "effect": "APPLY_TO_ITEMS_BY_QUANTITY"
}
Here is an example of a validation rule that limits the quantity of each product that can be discounted. One product is discounted at most for 1 unit per line item up to a maximum of 1 taking into account all matched order line items. The other product is discounted at most for 2 units per order line item up to a maximum of 3 for all matched order line items. 
{
    "id": "val_um5MMBdjQ2Uk",
    "name": "Business Validation Rule - Discount Effect - Amount - Items - each unit of matched product",
    "rules": {
        "logic": ""
    },
    "applicable_to": {
        "excluded": [],
        "included": [
            {
                "object": "product",
                "id": "prod_0b72b0bd64d198e3ae",
                "source_id": null,
                "strict": false,
                "effect": "APPLY_TO_EVERY",
                "quantity_limit": 1,
                "aggregated_quantity_limit": 1
            },
            {
                "object": "product",
                "id": "prod_0b72b00ffed198e344",
                "source_id": null,
                "strict": false,
                "effect": "APPLY_TO_EVERY",
                "quantity_limit": 2,
                "aggregated_quantity_limit": 3
            }
        ],
        "included_all": false
    },
    "created_at": "2022-09-05T08:11:29.497Z",
    "type": "basic",
    "context_type": "campaign.discount_coupons.discount.apply_to_items_by_quantity",
    "object": "validation_rules"
}

​
Add Missing Items

Discount type: unit This effect adds items to the cart only if a customer has fewer free items than offered by the code. For example, let’s assume that the code gives one free t-shirt: – If a customer doesn’t have the t-shirt already in the cart, then a free t-shirt will be added to the order. – If a customer already has this item in the cart, then the number of t-shirts already matches the units count. As a result, after applying the code, a discount will be applied to the item which is already in the cart and no extra items will be added. Read more.

​
Add New Items

Discount type: unit Choosing this effect results in adding items to the cart in the number defined by unit value. For example, if the code gives one free t-shirt, then no matter if a customer has the t-shirt already in the cart or not, a free t-shirt will always be added to the order and discounted. Read more.

​
Add Many Items

Discount type: unit The discount gives multiple types of free item(s) to customers. Free item units are always added to the customer’s cart based on either the Add missing items or Add new order items effects. Read more.
Go here to learn more about unit discounts and their effects.

​
Default Effect

Here are the default effects that API adds in the case you won’t define it in your discounts.
Discount TypeDefault Effect
AMOUNT- If you define included or excluded products: “APPLY_TO_ITEMS”- If you don’t define included or excluded products: “APPLY_TO_ORDER”
PERCENT- If you define included or excluded products: “APPLY_TO_ITEMS”- If you don’t define included or excluded products: “APPLY_TO_ORDER”
UNIT”ADD_MISSING_ITEMS""ADD_NEW_ITEMS”

​
Effects and Validation Rules

Discount effects work in parallel with the remaining Validation rules that specify included and excluded items, required cart structure and other redemption circumstances.
⌘I