Discount codes

Manage → Discounts. The list shows Code, Type, Value, Usage, Status.

Three kinds

Type	vi	The value you enter
Percentage	Phần trăm	The percentage taken off
Fixed	Số tiền cố định	The amount taken off
Free shipping	Miễn phí vận chuyển	Nothing — shipping goes to zero

Two ways to apply one

Code — the shopper types it at checkout, e.g. SUMMER20. The code is stored uppercase, so it does not matter how the shopper types it.

Automatic — no code at all. The discount applies itself when an order meets the conditions.

What it applies to

Whole order	Applied to the order total
Specific products	Only the products you pick
Specific categories	Only the categories you pick

For the latter two, a picker appears so you can search and tick the items.

Conditions and limits

Minimum order — the order value required for the discount to apply. Leave at 0 for no minimum.

Usage limit — the total number of times the code may be used across the whole store. Leave at 0 for unlimited. The Usage column shows Used 12 / 100, or just Used 12 when unlimited.

Starts at / Ends at — the window during which it runs. Leave both blank for no time limit.

Active — the on/off switch. "Only active discounts can be used."

Four statuses, and they are derived

The status in the list is not a field you pick — it is the result of the Active switch plus the schedule:

Status	Means
Active	Switched on and inside its window
Inactive	The switch is off
Scheduled	Switched on, but the start date has not arrived
Expired	The end date has passed

Which means that when a code "does not work", the first question is always which of those four it is. Scheduled and Expired look identical to a shopper — both are a code that does not work — but the fixes are nothing alike.

Duplicate codes

If you enter a code that already exists, the form says "A discount with this code already exists. Please choose another." Each code is unique within a store.

The internal title

The Title field is an internal label, optional, and shoppers never see it. It earns its keep once you have twenty codes and need to remember which campaign SUMMER20 belonged to.

Deleting

Deleting a discount is permanent and cannot be undone.

For a code you merely want to stop, switch Active off rather than deleting. An inactive code cannot be used, but its usage count and its record survive — which matters when you need to reconcile the revenue of a finished campaign.

Why discounts are not in the public API

discounts exists in the scope vocabulary, but there is no /api/v1 endpoint for it yet. The reason is that each public resource needs its own frozen shape rather than exposing the internal structure directly — a struct that serialises today publishes every field it grows tomorrow. See What is not here yet.

Meanwhile, redeeming a code happens normally during checkout — the one place a code is ever redeemed, under a lock, with its usage limit genuinely enforced.