Coupon Management

Coupon Management allows administrators to create, edit, search, activate, deactivate, and manage discount coupons for the iShop storefront. Coupons can be used for promotions, welcome discounts, seasonal sales, customer retention campaigns, and limited-time offers.

Coupons directly affect order totals. Always confirm the discount type, discount value, valid period, usage limits, and active status before publishing a coupon.

Overview

The Coupons screen contains a coupon list and a coupon editor. The list screen is used to search and manage existing coupons, while the editor is used to create or modify coupon rules.

Area	Description
Coupon List	Displays all created coupons with code, name, discount, active status, validity, usage count, and updated date.
New Coupon	Opens the coupon creation screen.
Keyword Search	Searches coupons by coupon code or name.
IsActive Filter	Filters coupons by active status.
Coupon Editor	Defines coupon code, discount policy, valid period, usage limits, and active status.

Coupon List

The Coupon List screen shows all coupons registered in the system. Administrators can search by coupon code or name and filter coupons by active status.

Column	Description
ID	The internal coupon identifier.
Code	The coupon code entered by the customer during checkout.
Name	The administrator-facing coupon name.
Discount	The discount type and value applied by the coupon.
Active	Shows whether the coupon is enabled.
Valid Now	Shows whether the coupon is currently valid based on the start and end period.
Used	Shows how many times the coupon has been used.
Updated	Displays the last updated date.

Search and Filter

Keyword

Use the Keyword field to search coupons by code or name.

Examples:
WELCOME10
SUMMER20
First Order Discount
Holiday Sale

IsActive

Use the IsActive dropdown to filter coupons by active status.

Filter	Description
All	Displays all coupons regardless of active status.
Active	Displays only active coupons.
Inactive	Displays only inactive coupons.

Search Button

Click Search after entering a keyword or selecting a filter.

Reset Button

Click Reset to clear search conditions and reload the coupon list.

Create a New Coupon

Click + New Coupon to create a new coupon.

Open Admin > iShop > Coupon.
Click + New Coupon.
Enter the coupon code.
Enter the coupon name.
Enter an optional description.
Select the discount type.
Enter the discount value.
Set max discount or minimum order amount if needed.
Set the start and end date.
Set usage limits if needed.
Check Is Active if the coupon should be available.
Click Save.

Coupon Editor Fields

Field	Description
Code	The coupon code customers enter during checkout. Example: `WELCOME10`.
Name	The administrator-facing name used to identify the coupon internally.
Description	Optional notes explaining the purpose, campaign, or restrictions of the coupon.
Discount Type	Determines how the discount is calculated.
Discount Value	The amount or percentage value applied by the coupon.
Max Discount	Optional maximum discount amount. Useful for percentage coupons.
Min Order	Optional minimum order amount required to use the coupon.
Start (UTC)	The UTC date and time when the coupon becomes valid.
End (UTC)	The UTC date and time when the coupon expires.
Usage Limit Total	Optional total number of times this coupon can be used.
Usage Limit Per User	Optional number of times each user can use this coupon.
Is Active	Controls whether the coupon is enabled.

Coupon Code

The coupon code is the value customers enter during checkout. It should be short, clear, and easy to type.

Recommended:
WELCOME10
SUMMER20
FREESHIP
VIP15
BLACKFRIDAY

Avoid:
Welcome Discount 10 Percent!!!
coupon with spaces
쿠폰코드###

Use uppercase letters and numbers for coupon codes when possible. This makes the code easier to read and share.

Discount Type

Discount Type determines how the coupon discount is calculated.

Type	How it works
Percent	Applies a percentage discount to the order. Example: 10% off.
Fixed Amount	Applies a fixed currency discount. Example: $10 off.

Percent Discount

A percent discount subtracts a percentage of the eligible order amount.

Example:
Discount Type: PERCENT
Discount Value: 10

Result:
A $100 order receives a $10 discount.

Fixed Amount Discount

A fixed amount discount subtracts a specific amount from the eligible order.

Example:
Discount Type: AMOUNT
Discount Value: 15

Result:
The order receives a $15 discount.

Max Discount

Max Discount limits the maximum discount amount. This is especially useful for percentage coupons.

Example:
Discount Type: PERCENT
Discount Value: 20
Max Discount: 50

Result:
Even if 20% of the order is more than $50, the discount will not exceed $50.

Min Order

Min Order defines the minimum order amount required before the coupon can be used.

Example:
Min Order: 100

Result:
The customer can use the coupon only when the order amount is $100 or more.

Valid Period

The Start and End fields define when the coupon is valid. These values are stored using UTC time.

Field	Purpose
Start (UTC)	The coupon becomes usable after this date and time.
End (UTC)	The coupon becomes unavailable after this date and time.

Always confirm the timezone when creating time-sensitive promotions. A coupon may appear invalid if the UTC time does not match the expected local promotion time.

Usage Limits

Usage limits control how many times a coupon can be used.

Limit	Description
Usage Limit Total	The total number of times this coupon can be used by all customers.
Usage Limit Per User	The number of times each customer can use this coupon.

Example:
Usage Limit Total: 100
Usage Limit Per User: 1

Result:
The coupon can be used 100 times in total, and each user can use it only once.

Is Active

The Is Active checkbox controls whether the coupon is enabled.

If checked, the coupon can be used when all other rules are valid.
If unchecked, the coupon cannot be used even if the date and rules are valid.

To temporarily disable a coupon without deleting it, uncheck Is Active.

Valid Now

The Valid Now column indicates whether the coupon is currently usable. A coupon is valid only when the active status, valid period, and usage limits allow it.

Recommended Workflow

Decide the promotion purpose.
Create a short coupon code.
Enter an internal coupon name.
Select discount type.
Enter discount value.
Set Max Discount and Min Order if needed.
Set Start and End time in UTC.
Set total and per-user usage limits if needed.
Check Is Active.
Save the coupon.
Test the coupon during checkout.

Common Use Cases

Use Case	Recommended Setup
Welcome discount	Use a percent coupon such as `WELCOME10` with per-user limit set to 1.
Seasonal sale	Use a percent or fixed amount coupon with start and end dates.
High-value order promotion	Set a Min Order amount.
Limit promotion cost	Use Max Discount for percent coupons.
Limited campaign	Set Usage Limit Total.

Important Notes

Coupon codes should be unique.
Discount value should match the selected discount type.
For percent coupons, consider using Max Discount to control promotion cost.
Start and End values use UTC time.
A coupon must be active and within the valid period to be usable.
Usage limits may prevent a coupon from being used even if it is active.
Always test the coupon before announcing it to customers.

Best Practices

Use short uppercase coupon codes.
Use clear internal names for campaign tracking.
Set valid start and end dates for promotional coupons.
Use per-user limits for customer-specific or welcome coupons.
Use minimum order amounts to protect margins.
Review used counts during active campaigns.
Deactivate expired or finished coupons instead of deleting them immediately.

Coupons are powerful promotional tools, but incorrect settings can cause unexpected discounts. Always review and test coupon behavior before launching a campaign.