For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

1

Order form coupon list inquiry

Retrieves the list of coupons held by the member on the order form page.

2

Coupon basic information inquiry

For coupon download events among event types, retrieves the corresponding coupon's basic information.

3

Per-member coupon count inquiry

Retrieves the number of free-shipping coupons and the number of general coupons held by the member, respectively.

4

Per-product instant discount price inquiry

Retrieves the available product instant discount price for each product.

5

Product detail maximum benefit price inquiry

Retrieves the maximum benefit price for the corresponding product on the product detail page.

6

Order form coupon usage processing

Marks the selected coupon as used during order and claim processing.

7

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.

8

Order form shipping coupon inquiry

Retrieves the list of free-shipping and free-return coupons during order and claim processing.

9

Coupon cancellation/restoration

Changes the status of a previously used coupon back to unused during claim processing.

10

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.

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

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

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

Coupon cancellation/ restoration

When an order is cancelled through claim processing, cancels and restores the coupon used in the original order.

Order

POST

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

Term Definitions

Term
Description

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.