Object Index / Definition

You are viewing an old version of the API
Order​Return​Discount

Beta

Represents a discount being returned that applies to one or more return line items in an order

Fixed-amount, order-scoped discounts are distributed across all non-zero return line item totals. The amount distributed to each return line item is relative to that item’s contribution to the order subtotal.

Properties

Name Description
amount_money
Money

The total declared monetary amount of the discount.

amount_money is not set for percentage-based discounts.

applied_money
Money

The amount of discount actually applied to this line item. When an amount-based discount is at order-level, this value is different from amount_money because the discount is distributed across the line items.

catalog_object_id
string

The catalog object id referencing CatalogDiscount.

Max Length 192
name
string

The discount's name.

Max Length 255
percentage
string

The percentage of the tax, as a string representation of a decimal number. A value of 7.25 corresponds to a percentage of 7.25%.

percentage is not set for amount-based discounts.

Max Length 10
scope
string

Indicates the level at which the OrderReturnDiscount applies. For ORDER scoped discounts, the server will generate references in applied_discounts on all OrderReturnLineItems. For LINE_ITEM scoped discounts, the discount will only apply to OrderReturnLineItems with references in their applied_discounts field.

source_discount_uid
string

uid of the Discount from the Order which contains the original application of this discount.

Max Length 60
type
string

The type of the discount. If it is created by API, it would be either FIXED_PERCENTAGE or FIXED_AMOUNT.

Discounts that don't reference a catalog object ID must have a type of FIXED_PERCENTAGE or FIXED_AMOUNT.

uid
string

Unique ID that identifies the return discount only within this order.

Max Length 60

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?