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

Coupon Management

The Coupon Management service lets you register and edit various types of coupons, and look up the list of registered coupons to check detailed information and status. This service focuses on preventing indiscriminate coupon usage and issuance, and efficiently managing coupon-related costs.


Key Features

  • Coupon Registration and Editing

    • Register and edit coupons with detailed settings such as basic information, coupon benefits, applicable targets, and excluded targets.

    • Set the issuance method so that a coupon is automatically issued to members who meet the corresponding conditions.

    • Set the coupon's discount type as fixed-amount or percentage, and limit coupon usage by specifying a minimum/maximum amount.

  • Coupon Status Management

    • Check the status of registered coupons, and manage discontinued coupons so they can no longer be issued or used.

  • Coupon Cost Inquiry

    • Efficiently look up the status of issued coupons and the cost incurred from coupon usage in a single inquiry.

    • Monitor overall coupon-related costs based on the number of members who received a coupon, the coupon usage rate, and the usage count.

Process Definition

1

Registered Coupon Inquiry

Looks up the list and count of registered coupons.

2

Coupon Status Change

Changes the status of a registered coupon. Status classifications include Normal Coupon and Discontinued Coupon.

3

Coupon Setup and Issuance

Enters the coupon issuance conditions, such as basic information, coupon benefits, and applicable targets, and issues the coupon.

4

Issuance Status Inquiry

Looks up the list and count of cost information for coupon usage, such as issuance status, usage status, and incurred cost status.

5

Coupon Detail Inquiry

Looks up the detail information of a coupon entered at the time of registration.

6

Coupon Issuance Status

Looks up the list and count of members who received a registered coupon.

7

Data Download

Uploads registered member information within an Excel file, looks up the content recorded in the file, and delivers it.

8

Coupon Withdrawal Procedure

Withdraws a coupon issued incorrectly or abnormally to a specific member among the list of members who were issued it.

9

Coupon Period Edit

Changes the validity period of a coupon held by a member.

10

Manual Coupon Issuance

Manually issues a coupon to a member that was not issued due to a system error.

11

Coupon Multilingual Inquiry

Looks up the multilingual registration information for coupon management.

12

Coupon Multilingual Registration

Registers the multilingual information for coupon management.

API Function List

API
Description
Server
Method
Notes

Coupon Management List Inquiry

Looks up the list of registered coupons using the entered conditions.

BO

GET

Coupon Management List Count Inquiry

Looks up the count of registered coupons using the entered conditions. Pagination is applied based on the count returned.

BO

GET

Common Code Inquiry

Looks up the common code for coupon type among the search conditions when looking up the coupon list.

BO

GET

Coupon Registration/Edit

Registers or edits the coupon information entered by the administrator.

BO

POST

Coupon Status Change

Changes the status code of a coupon.

BO

POST

Coupon Detail Information Inquiry

Looks up the detail information of a registered coupon.

BO

GET

Coupon Issued Member Inquiry

Looks up the members and member list who received a registered coupon.

BO

GET

Coupon Issued Member Count Inquiry

Looks up the count of the member list who received a registered coupon.

BO

GET

Member Coupon Bulk Issuance Inquiry

Uploads an Excel file, looks up the member information recorded in the Excel file, and delivers it.

BO

POST

Member Coupon Issuance

Issues a specific coupon to the specified member.

BO

POST

Coupon Period Change

Changes the validity period of a specific coupon among the coupons issued to a member.

BO

POST

Coupon Withdrawal

Marks a specific coupon among the coupons issued to a member as used, thereby withdrawing it.

BO

POST

Coupon Cost Management Inquiry

Looks up the list of coupon costs registered using the entered conditions.

BO

GET

Coupon Cost Management Result Count Inquiry

Looks up the count of the coupon cost list registered using the entered conditions. Pagination is applied based on the count returned.

BO

GET

Common Code Inquiry

Looks up the common code for coupon type among the search conditions when looking up the coupon list.

BO

GET

Coupon Detail Information Inquiry

Looks up the detail information of a registered coupon.

BO

GET

Coupon Issued Member Inquiry

Looks up the members and member list who received a registered coupon.

BO

GET

Coupon Issued Member Count Inquiry

Looks up the count of the member list who received a registered coupon.

BO

GET

Member Coupon Bulk Issuance Inquiry

Uploads an Excel file, looks up the member information recorded in the Excel file, and delivers it.

BO

POST

Member Coupon Issuance

Issues a specific coupon to the specified member.

BO

POST

Coupon Period Change

Changes the validity period of a specific coupon among the coupons issued to a member.

BO

POST

Coupon Withdrawal

Marks a specific coupon among the coupons issued to a member as used, thereby withdrawing it.

BO

POST

Promotion Multilingual Information Inquiry

Looks up the multilingual information of a discount/mileage benefit.

BO

GET

Promotion Multilingual Registration

Registers the multilingual information of a discount/mileage benefit.

BO

POST

Terminology

Term
Description

Discount Type (Fixed Amount)

A type of coupon that discounts a set amount or amount range when a product is purchased. This type of coupon mainly discounts a fixed amount, or provides a benefit that discounts the amount specified at the time of registration once a minimum purchase amount is met.

Discount Type (Percentage)

A coupon that discounts a certain percentage of a product's price when the product is purchased. With this type of coupon, the discounted amount varies according to the product's price. Because a percentage coupon causes the discounted amount to vary relative to the product's price, the higher the product's price, the greater the discounted amount can be.

Issuance Count per Member

Specifies the maximum number of times a single member can receive the coupon.

Total Issuance Count

Specifies the total issuance count for the coupon. First-come, first-served coupon issuance is possible up to the set number.

Issuing Entity

Fixed Promotional Coupon: A coupon provided on a fixed basis for promotional purposes. Event Coupon: A coupon created for a specific event. Partner: A coupon created for a specific partner's products. Customer Compensation Coupon: A coupon created to compensate a customer claim.

Other Notes

  • Targeted Issuance: A system that automatically issues a coupon to specific members.

  • Conditional Automatic Issuance: A system that automatically issues a coupon, via a daily batch, to members who meet specific set conditions.

  • Customer Download Issuance: A system in which customers directly obtain the coupon from within the shopping mall pages.

  • Cost Share Ratio: A system that coordinates the cost incurred from the coupon between the company and its partner.

  • Coupon and Discount Policy

Category
1st Discount
2nd Discount
3rd Discount

Type

Selling price discount (single-item discount)

Product discount coupon

Employee discount

Immediate product discount

Stackable discount coupon

Cart coupon

Discount Type

Fixed amount

Fixed amount/Percentage

Percentage

Percentage

Fixed amount/Percentage

Fixed amount/Percentage

Characteristics

Set when the product is registered

  • Another discount type within the same tier cannot be selected (cannot be used simultaneously) (e.g., 2nd-tier product coupon + employee discount cannot be used together)

  • When calculating the maximum benefit price, the larger amount is applied first

  • If amounts are equal, applied in the order of immediate product discount -> product discount coupon -> employee discount

  • Another discount type within the same tier cannot be selected (cannot be used simultaneously)

  • 3rd-tier discount can be used independently.

  • When calculating the maximum benefit price, the larger amount is applied first

  • If amounts are equal, applied in order of the coupon's validity end date

Calculation Base Amount

Selling price

Price after 1st discount applied

Price after 2nd discount applied

Minimum Purchase Criteria

N/A

Quantity: fixed at 1 Amount: selling price of 1 unit of the product

N/A

N/A

Quantity: fixed at 1 Amount: selling price of 1 unit of the product

Quantity: sum of eligible products Amount: sum of the post-discount amounts of eligible products (previous tier)

Application Basis

Adjusts the product's selling price

Applies an individual discount to all quantities of the product

Applies a discount to all quantities of eligible products

Margin Check

At product registration

Coupon/discount is exposed and usable only when “supply price >= selling price - discount amount”

3rd-Tier Discount Applicability

N/A

O

X

O

N/A

N/A

Common Application Rules

N/A

  • Discounts can be applied in 1-won increments, and any amount under 1 won is rounded.

  • Promotions are recalculated only when a claim is filed before all products in the order have shipped.

  • To prevent a 0-won payment, coupons/discounts with a discount amount greater than the selling price cannot be used.