Coupon Issuance

The shopping mall provides codes or coupons that offer discounts and various benefits. They have two properties, percentage-rate coupons and fixed-amount coupons, and applying such a coupon at checkout provides a discount benefit. There are also special coupons that provide free shipping or free returns.

---

Key Features

• Coupon issuance system

  • Members can directly obtain coupons from the Store Front.

  • The system also operates a mechanism for issuing coupons from the Back Office.

• Automatic issuance system

  • A conditional coupon issuance system exists that automatically issues coupons meeting the conditions via the automatic issuance type code.

• Coupon inquiry

  • On the product detail page, the downloadable coupon inquiry API can be used to retrieve the list of coupons downloadable for the product.

  • The per-member coupon inquiry API can be used to retrieve the list of coupons a member holds.

Process Definition

1

Product detail downloadable coupon inquiry

Retrieves coupons applicable to the corresponding product on the product detail page.

2

Per-member coupon inquiry

Retrieves the list of coupons held by the member to check their expiration date, type, and so on.

3

Coupon download (BO)

An API used when the system issues coupons, used for issuing coupons such as new member sign-up coupons and birthday coupons.

4

Coupon download (FO)

A service through which a member directly requests a coupon download and receives the coupon through a series of actions.

5

Coupon inquiry by automatic issuance type

Checks whether a valid coupon exists that matches the automatic issuance type condition.

API Function List

API	Description	Server	Method	Notes
Coupon download (FO)	A service through which logged-in members, via product pages, event pages, and so on, can directly obtain coupons.	Order	POST	🔗View API>
Coupon download (BO)	A service through which other module services, such as batch jobs or new member sign-up, request coupon issuance when a coupon needs to be issued.	Order	POST	🔗View API> Member information list inquiry: /api/member/v1/member/getMemberInfoList
Per-member coupon inquiry	Retrieves the coupon information held by the member.	Order	GET	🔗View API>
Product detail downloadable coupon inquiry	Retrieves the list of coupons downloadable for the corresponding product on the product detail page.	Order	POST	🔗View API>
Coupon inquiry by automatic issuance type	To automatically issue a coupon to a member meeting a specific criterion, retrieves the list of valid issuable coupons for the corresponding automatic issuance type code.	Order	GET	🔗View API>

Term Definitions

Term	Description
Conditional automatic issuance coupon	A system in which the system automatically issues a coupon to a member who meets a specific criterion (automatic issuance type), without the member having to request it directly.
Automatic issuance type code (MK008)	A code defining the type of automatically issued coupon. New member sign-up coupon (2101), shopping bag exclusive coupon (2201) long-term non-purchase customer coupon (2301), birthday coupon (2401) grade celebration coupon (2501), app first login welcome coupon (2601) PUSH opt-in coupon (2701)

Other Notes

• Coupon usage processing

  • Marks the corresponding coupon issuance number as used during orders and claims.

• Coupon expiration notice

  • If a coupon held by the user has 3 days or less remaining or expires today, an expiration notice is sent (notification inbox, email).

• Coupon usage cancellation processing

  • At order time (upon order processing failure): the "used" attribute of the issued coupon is changed to 'N'; however, since this can be done within the same transaction based on the creation date, this feature is not used.

  • On claims and other calls

    • Creates a new coupon based on the existing issuance history.

    • If an issuance history already exists, coupon issuance is not performed again.

    • The coupon issuance count limit is not checked; upon reissuance, if the original coupon's usable period has not yet passed, it is reissued with the original period, and if the original coupon's usable period has passed, it is issued as a usable coupon by looking up the coupon restoration validity days (ST001) value from today.