CatalogDiscount

November 20, 2019 ยท View on GitHub

Description

A discount in the Catalog object model.

Properties

NameGetterSetterTypeDescriptionNotes
namegetName()setName($value)stringThe discount name. Searchable. This field has max length of 255 Unicode code points.[optional]
discount_typegetDiscountType()setDiscountType($value)stringIndicates whether the discount is a fixed amount or percentage, or entered at the time of sale. See CatalogDiscountType for possible values[optional]
percentagegetPercentage()setPercentage($value)stringThe percentage of the discount as a string representation of a decimal number, using a `.` as the decimal separator and without a `%` sign. A value of `7.5` corresponds to `7.5%`. Specify a percentage of `0` if `discount_type` is `VARIABLE_PERCENTAGE`. Do not include this field for amount-based or variable discounts.[optional]
amount_moneygetAmountMoney()setAmountMoney($value)\SquareConnect\Model\MoneyThe amount of the discount. Specify an amount of `0` if `discount_type` is `VARIABLE_AMOUNT`. Do not include this field for percentage-based or variable discounts.[optional]
pin_requiredgetPinRequired()setPinRequired($value)boolIndicates whether a mobile staff member needs to enter their PIN to apply the discount to a payment in the Square Point of Sale app.[optional]
label_colorgetLabelColor()setLabelColor($value)stringThe color of the discount display label in the Square Point of Sale app. This must be a valid hex color code.[optional]
modify_tax_basisgetModifyTaxBasis()setModifyTaxBasis($value)stringIndicates whether this discount should reduce the price used to calculate tax. Most discounts should use `MODIFY_TAX_BASIS`. However, in some circumstances taxes must be calculated based on an item's price, ignoring a particular discount. For example, in many US jurisdictions, a manufacturer coupon or instant rebate reduces the price a customer pays but does not reduce the sale price used to calculate how much sales tax is due. In this case, the discount representing that manufacturer coupon should have `DO_NOT_MODIFY_TAX_BASIS` for this field. If you are unsure whether you need to use this field, consult your tax professional. See CatalogDiscountModifyTaxBasis for possible values[optional]

Note: All properties are protected and only accessed via getters and setters.

[Back to Model list] [Back to API list] [Back to README]