Coupons

A coupon gives a discount on the whole cart. The player uses it in the game, with the cart's coupon button. The web store doesn't take coupons.

Create a coupon

In the dashboard, open Coupons and create a coupon:

Field	Rules
Code	2 to 32 characters: letters, numbers, _ and -. It is stored in uppercase, so xmas10 and XMAS10 are the same coupon.
Discount	A percentage, from 1% to 100%, or a fixed amount in reais. The percentage is rounded down, in cents.
Total uses	Optional. How many times the coupon can be used in all.
Uses per player	Optional. How many times the same player can use it.
Start and end	Optional. The coupon only works between the two dates.
Active	Turn it off to stop the coupon without deleting it.

A coupon that covers the whole amount completes the purchase with no payment. The player sees Compra confirmada! O cupom cobriu o valor todo; seus itens chegam em instantes. (purchase confirmed, the coupon covered the whole amount).

How the player uses it in the game

The cart needs a button with the Discount coupon action. See How do I build the /loja menus?.

• Minecraft 1.21 onwards: an anvil opens. The player types the code and clicks the item on the right. Leaving the field empty removes the coupon.
• Before 1.21: the menu closes and the player types the code in the chat. cancelar goes back without changing anything. On 1.8.9, - removes the applied coupon.

Hasty checks the coupon right away, and again at checkout.

Problems

Message	Likely cause	What to do
Nao foi possivel verificar o cupom agora. Tente de novo.	The server couldn't reach Hasty.	The player tries again in a moment.
The coupon is refused	Outside its dates, no uses left, turned off or mistyped.	Check the coupon in Coupons.