Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Period and punch cards

The Season and punch cards screen has two parts: Card definitions — the cards you sell — and Purchased cards — the cards customers have. Only administrators and owners can reach the screen.

Edit card definition

FieldWorks like this
NameShown in the purchase window, in the cart below the slot and on the receipt.
SlugA short name that rental slots and events can give a discount to. See discount for card holders.
Time and placeThe slots the card covers. Empty means all slots at the facility. Time and place.
PriceWhat the card costs.
Number of monthsHow long the card is valid: 1, 2, 3, 4, 6 or 12. Other numbers do not work.
PeriodicOff: the card is valid from the day of purchase. On: the card follows fixed periods — with 6 months, January–June and July–December — and the buyer chooses this or the next period.
Max 1 per groupThe card covers only one ticket per slot. Has nothing to do with groups.
PunchesNumber of slots. 0 makes the card a period card, with no limit.
Can be soldWhether the card is offered in the purchase window.

The fields are not validated. If you type something wrong in Number of months or Punches, you get no error message.

A card with Can be sold on is listed in the purchase window. A card with Periodic is shown for the current period until about a month before it ends, and for the next period from about one to two months before it starts. The price is the same no matter how late in the period the card is bought.

For every slot Velpr calculates a price for, it first looks for a card the customer has. A card covers the slot when

  1. the slot matches Time and place,
  2. the slot starts between the card’s From and To,
  3. the card has punches left — tickets in the cart count too,
  4. the card is not Paused,
  5. with Max 1 per group: the card does not already cover a ticket in the same slot.

The slot then costs 0. If several cards fit, the one with the lowest number of Punches is used first, so that punch cards are used before period cards. Slots that already cost 0 do not use punches.

Each ticket uses one punch, and the punch is counted when the order is completed.

SituationWhat happens
The card is in the same cart as the slotsThe card does not apply to them. The customer must buy the card first.
The customer releases a slotThe punch is used. It does not come back.
The card is used up, expired or pausedThe slots cost the regular price.

If you want to give card holders a discount instead of free slots, a rental slot or an event can give a discount to punch:<slug>. That gives a lower price, but still uses a punch when the order is completed.

Card details

FieldWorks like this
Search by name or emailSearch by name or email.
Vis pauset (Show paused)Also shows paused cards.
Show expiredAlso shows cards that are no longer valid.
Used / PunchesPunches used, and the number of punches — ∞ for period cards.
OwnerThe customer who has the card.
From / ToWhen the card is valid. Can be changed.
Time and placeThe slots this particular card covers. Can be changed for one customer without changing the card definition.
PausedPauses the card. It covers no slots, and the customer sees it on Min side (My page).
Pause commentThe reason, which the customer can see.

There is no button to refund, delete, give back punches or hand out a card without the customer buying it.


The setup step by step: the admin guide for cards. The customer’s side: the card reference.