Skip to content

doc(promotions): DEVDOCS-6652 add maximum_allowed_discount_amount to … #1201

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bc-vincent-zhao merged 2 commits into from
Dec 28, 2025
Merged

doc(promotions): DEVDOCS-6652 add maximum_allowed_discount_amount to … #1201

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
988c744
doc(promotions): DEVDOCS-6652 add maximum_allowed_discount_amount to …
bc-vincent-zhao Dec 15, 2025
e15f812
doc(promotions): DEVDOCS-6652 update regex to disallow 0.0 value
bc-vincent-zhao Dec 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 23 additions & 3 deletions reference/promotions.v3.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -985,6 +985,8 @@ components:
properties:
discount:
$ref: '#/components/schemas/Discount'
maximum_allowed_discount_amount:
$ref: '#/components/schemas/MaximumAllowedDiscountAmount'
description: |-
**Cart Value Action**
Applies discount on the entire cart.
Expand Down Expand Up @@ -1054,6 +1056,8 @@ components:
properties:
discount:
$ref: '#/components/schemas/Discount'
maximum_allowed_discount_amount:
$ref: '#/components/schemas/MaximumAllowedDiscountAmount'
as_total:
type: boolean
description: |-
Expand Down Expand Up @@ -1128,13 +1132,17 @@ components:
type: string
description: The amount of discount (percentage off) to apply.
description: '**Percentage Discount**'
required:
- percentage_amount
FixedDiscount:
title: Fixed Discount
type: object
properties:
fixed_amount:
$ref: '#/components/schemas/Money'
description: '**Fixed Discount**'
required:
- fixed_amount
Money:
title: Money
pattern: '[0-9]+(\.[0-9]+)?'
Expand All @@ -1143,6 +1151,17 @@ components:
**Money**
Represents a monetary value in the store’s default currency.
example: '12.95'
MaximumAllowedDiscountAmount:
type: string
nullable: true
pattern: '^(?!0+(?:\.0+)?$)(\d+)(\.[0-9]+)?$'
description: |
The maximum monetary value that can be applied as a discount. It can take value from 1 to 10000000.
The application of this maximum depends on the discount type:
- Discount on shipping: the max limit is distributed to the first number of shipping destinations until it is reached
- Discount on products: the max limit is distributed to the first number of eligible products until it is reached
- Discount on order subtotal: the max limit is checked against the order discount value
example: '10'
OptionalCursorCollectionMeta:
title: Collection Meta
type: object
Expand Down Expand Up @@ -1939,8 +1958,8 @@ components:
data:
- id: 1
redemption_type: AUTOMATIC
name: Buy Product X Get Free Shipping
display_name: WOW!!! FREE SHIPPING for Product X
name: Buy Product worth X Get Y% off upto Z
display_name: Shop for X and get Y% off upto Z
created_from: api
channels:
- id: 1
Expand All @@ -1961,7 +1980,8 @@ components:
- action:
cart_value:
discount:
fixed_amount: '12.95'
percentage_amount: '10'
maximum_allowed_discount_amount: '20'
apply_once: true
stop: true
condition:
Expand Down