PricingValue

A precise monetary value with its associated currency. Combines a decimal amount with a three-letter CurrencyCode to express prices, costs, and other financial values. For example, 12.99 USD.

A percentage discount value applied to cart items or orders. Returned as part of the PricingValue union on discount applications, where it represents discounts calculated as a percentage off rather than a fixed amount.

An automatic discount applied to a cart or checkout without requiring a discount code. Implements the DiscountApplication interface.

Includes the discount's title, value, and allocation details that specify how the discount amount distributes across entitled line items or shipping lines.

Captures the intent of a discount source at the time it was applied to a cart. This includes the discount value, how it's allocated across entitled items, and which line types it targets.

The actual discounted amounts on specific cart lines are represented by CartDiscountAllocation objects, which reference this application.

Captures the intent of a discount at the time it was applied. Each implementation represents a different discount source, such as automatic discounts, discount codes, and manual discounts.

The actual discounted amount on a line item or shipping line is represented by the DiscountAllocation object, which references the discount application it originated from.

Records the configuration and intent of a discount code when a customer applies it. This includes the code string, allocation method, target type, and discount value at the time of application. The applicable field indicates whether the code was successfully applied.

Note: To see the actual amounts discounted on specific line items or shipping lines, use the <a href="https://shopify.dev/docs/api/storefront/current/objects/DiscountAllocation"><code><span class="PreventFireFoxApplyingGapToWBR">Discount<wbr/>Allocation</span></code></a> object instead.

A discount created manually by a merchant, as opposed to automatic discounts or discount codes. Implements the DiscountApplication interface and includes a title, optional description, and the discount value as either a fixed amount or percentage.

A discount application created by a Shopify Script. Implements the DiscountApplication interface and captures the discount's value, allocation method, and targeting rules at the time the script applied it.