First Purchase Discounts

A first purchase discount prices a package lower for a customer who has never owned it. Once they own it, every later purchase of that package is at the normal price.

There is no code to type. The discount applies automatically and the storefront shows the reduced price on the package card.

This is per package, not per customer. A long-standing customer still gets the discount on a package they have never bought before. If you want a discount for genuinely new customers instead, use a coupon with First-time customers only enabled. See Coupons.

Setting it up

On a package, open the Billing & Rewards tab and turn on Enable first purchase discount. Then choose:

Percentage off. A percentage of the package price, from 1 to 100.
Fixed amount off. A cash amount, which cannot exceed the package price.

The discount is calculated from the package’s normal price, never from a sale price.

What the customer sees

A visitor who has not entered a username sees the discounted price with the original struck through, labelled as a first purchase price. This is deliberate: the offer is advertising, so it is visible while browsing.

Once a customer enters their username, the storefront shows the true price for them. A customer who already owns the package sees the normal price with no label, and checkout charges the normal price.

Rules worth knowing

It never stacks with a sale. If a package is on sale and also has a first purchase discount, the customer pays whichever of the two is lower. They are never combined. A 30% sale on top of a 30% first purchase discount would otherwise take 60% off without you intending it.

It covers one item per order. Buying three of the same package charges the first purchase price for one and the normal price for the other two.

Refunds do not restore it. Once a customer has owned the package, they have used their first purchase price, even if the order was later refunded. This stops the discount being farmed by buying and refunding repeatedly.

Tiered upgrades take priority. If a package is part of a tiered upgrade path and the customer already owns the tier below, they pay the upgrade price and the first purchase discount does not also apply. An upgrade is always a first purchase of that tier, so the two would otherwise combine on every upgrade.

Gifts follow the recipient. Gifting a package to someone who has never owned it gets the first purchase price, even if you already own it yourself. Gifting to someone who already owns it charges the normal price. This matches how tiered upgrade pricing already works.

Renaming does not reset it. Customers are matched on their Minecraft UUID where one is available, so changing username does not earn the discount a second time.

The in-game store GUI shows the normal price, not the first purchase price. The GUI menu is built once per server rather than per player, so it cannot know who is looking. Customers are still charged the discounted price at checkout, so nobody is overcharged.

Custom templates

Storefront templates read two fields on a package:

firstPurchasePrice is the discounted price, or empty when the viewer is not eligible or the package has no discount.
firstPurchaseDiscountAvailable is true when the offer applies to this viewer.

The bundled Crest, Almanac and Realms templates already use them. A custom template will keep showing the normal price until you add them yourself. See Custom templates.