Order Discounts

Chicken-flavored dog biscuits have been discontinued, so this item receives a 7% discount. The applied_discounts attribute tells Square that this line item gets a specific discount and the discounts attribute defines what the discount is. applied_discounts can be set on any line item and reference any discount defined in the order.

Note that applied_discounts is a list, which means that multiple discounts can be applied to a single line item.

To celebrate National Puppy Day, the entire order receives a 12% discount. The Orders API calculates and applies order-level discounts as line-item price adjustments, so it apportions the discount across all the line-item subtotals. In this case, the applied_discounts attribute isn't used. The discounts attribute uses a scope parameter to tell Square to apply the discount to all line items.

To thank customers for their business, a Puppy Appreciation Discount is applied to dog treats. Customers save $3.00 on chicken-flavor dog biscuits and $11.00 on beef-flavor chewy rawhide.

To celebrate the storewide Anniversary Sale, a discount of $5.00 is applied to the entire order. The Orders API calculates and applies order-level discounts as line-item price adjustments, so it evenly distributes the discount across all the line-item subtotals.

The owners of Raphael's Puppy-Care Emporium have decided to offer a Buy One, Get One Free discount to motivate customers to buy combinations of dog biscuit items. To expedite the checkout process, they set up a pricing rule in their catalog to automatically apply discounts. On every order, they add the pricing_options attribute and set auto_apply_discounts. That's all they need to do. When set, any order that contains a catalog item that matches a price rule is automatically discounted.