> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/api-guides-en/store-front/promotion/discount.md). # Discount The shopping mall provides codes or coupons that let consumers receive benefits, and using them lets consumers purchase products at a discounted price. Coupons are provided in two forms, general discount coupons and free-shipping coupons, and these benefits are used as a marketing tool to draw consumer interest and encourage more purchases. ### Key Features * Applying coupons and discounts * Members can purchase products using the various coupons and discounts provided by the shopping mall. * A variety of coupons and promotions * The shopping mall offers many kinds of coupons and promotions, providing members with a wide range of discount benefits. * Discount types * Two types of discounts are provided when applying a discount benefit: fixed-amount benefits and percentage-rate benefits. * Margin check * When applying a discount benefit, a margin check restricts discount benefits larger than the supply cost, minimizing losses for the company's own products. ### Process Definition

{% stepper %} {% step %} ### Order form coupon list inquiry Retrieves the list of coupons held by the member on the order form page. {% endstep %} {% step %} ### Coupon basic information inquiry For coupon download events among event types, retrieves the corresponding coupon's basic information. {% endstep %} {% step %} ### Per-member coupon count inquiry Retrieves the number of free-shipping coupons and the number of general coupons held by the member, respectively. {% endstep %} {% step %} ### Per-product instant discount price inquiry Retrieves the available product instant discount price for each product. {% endstep %} {% step %} ### Product detail maximum benefit price inquiry Retrieves the maximum benefit price for the corresponding product on the product detail page. {% endstep %} {% step %} ### Order form coupon usage processing Marks the selected coupon as used during order and claim processing. {% endstep %} {% step %} ### Order form maximum benefit price inquiry Retrieves the maximum benefit amount available to the member and the applicable discount information when processing a cart, order, or claim. {% endstep %} {% step %} ### Order form shipping coupon inquiry Retrieves the list of free-shipping and free-return coupons during order and claim processing. {% endstep %} {% step %} ### Coupon cancellation/restoration Changes the status of a previously used coupon back to unused during claim processing. {% endstep %} {% step %} ### Available benefit information inquiry This logic is a service-level validation and calculation logic; please refer to the 'business process definition' in the \[Promotion Validation] feature overview. {% endstep %} {% endstepper %} ### API Function List

API	Description	Server	Method	Notes
Per-member coupon count inquiry	Retrieves the number of coupons held by the member, by type. Retrieves the counts of general coupons and free-shipping coupons.	Order	GET	🔗View API>
Order form coupon list inquiry	Retrieves the coupons and discount information held by the member within the order form.	Order	POST	🔗View API> Staff discount limit inquiry: /api/member/v1/staff/getDsctLmtStat
Product detail maximum benefit price inquiry	Retrieves the maximum benefit price within the product detail page.	Order	POST	🔗View API> Staff discount limit inquiry: /api/member/v1/staff/getDsctLmtStat
Coupon basic information inquiry	Retrieves the information of the coupon issued for the coupon download event type.	Order	GET	🔗View API>
Per-product instant discount price inquiry	Retrieves the available product instant discount price for each product.	Order	POST	🔗View API> Discount&path=getGoodsDirectDiscountInfo
Order form coupon usage processing	Marks the selected coupon as used at order time, applying the product price and shipping benefits.	Order	POST	🔗View API>
Coupon cancellation/ restoration	When an order is cancelled through claim processing, cancels and restores the coupon used in the original order.	Order	POST	🔗View API>
Order form maximum benefit price inquiry	Retrieves the maximum benefit price for the order when processing a cart, order form, or claim.	Order	POST	🔗View API> Staff discount limit inquiry: /api/member/v1/staff/getDsctLmtStat
Order form shipping coupon inquiry	Retrieves the free-shipping coupons or free-return coupons held by the member during order and claim processing.	Order	POST	🔗View API>

### Term Definitions

Term	Description	Notes
Discount	Sale price discount, staff discount, product instant discount
Coupon	Product coupon, stackable coupon, cart coupon, shipping and return fee coupon

### Other Notes * **Per-product instant discount price inquiry API** * This API is currently called from the product API, but the product API itself is not in use. * **Benefit** * The applicable benefit for each tier is calculated based on whether it is a percentage-rate or fixed-amount benefit. * Benefits are applied across a total of three tiers, and one coupon or discount benefit can be received per tier. * To prevent losses to the company, when a benefit is applied, coupon and discount benefits are restricted if the result is cheaper than the product's supply cost. * **Coupon and discount policy**

Category	Tier 1 discount	Tier 2 discount			Tier 3 discount
Type	Sale price discount (single-item discount)	Product discount coupon	Staff discount	Product instant discount	Stackable discount coupon	Cart coupon
Discount type	Fixed amount	Fixed amount/percentage rate	Percentage rate	Percentage rate	Fixed amount/percentage rate	Fixed amount/percentage rate
Characteristics	Set at product registration	Only one discount type can be selected within the same tier (cannot be used simultaneously) (e.g., Tier 2 product coupon + staff discount cannot be used together) When calculating the maximum benefit price, the larger amount takes priority; if amounts are equal, applied in the order product instant discount -> product discount coupon -> staff discount			Only one discount type can be selected within the same tier (cannot be used simultaneously) Tier 3 discount can be used on its own. When calculating the maximum benefit price, the larger amount takes priority; if amounts are equal, applied in order of the coupon's expiration deadline
Calculation base amount	Sale price	Price after Tier 1 discount			Price after Tier 2 discount
Minimum purchase criteria	N/A	Quantity: fixed at 1 Amount: sale price of 1 unit of the product	N/A	N/A	Quantity: fixed at 1 Amount: sale price of 1 unit of the product	Quantity: sum of applicable products Amount: sum of the post-discount amount of applicable products (previous tier)
Application basis	Product sale price adjustment	Individual discount applied to all quantities of the product				Discount applied to all quantities of applicable products
Margin check	At product registration	Coupon/discount is shown and usable only when "supply price >= sale price - discount amount"
Tier 3 discount applicability	N/A	O	X	O	N/A	N/A
Common application notes	N/A	Discounts can be applied in 1-won units, and amounts below 1 won are rounded. Promotion recalculation is only performed if a claim is made before all products in the order enter "in delivery" status. To prevent 0-won payment, coupons/discounts larger than the sale price cannot be used.

* Maximum benefit policy

	Product Detail	Cart	Order Form
Available discount types	Product discount coupon, product instant discount, staff discount	Product discount coupon, product instant discount, staff discount	Product discount coupon, product instant discount, staff discount, stackable discount coupon, cart coupon
Target	Members/non-members (product instant discount only)	Members	Members
Notes	If a downloadable product discount coupon exists that the customer has not downloaded, that coupon is included in the maximum benefit calculation. For non-members, product instant discounts are shown only for discounts where all applicable member grades are selected.