Docs
Cards from template to sale
How templates, series and cards fit together, how to print and sell them, and how stock, transfers and reversals stay correct in the ledger.
Prepaid cards are three objects: a template that holds a saved specification, a series generated from it, and the cards in that series.
The three objects
A template is a specification you keep: which plan the card grants, how long it is valid, what it costs, and which design it prints with. It exists so a second batch is one click rather than a form.
A series is what you actually generate, and it is the unit everything else works on. The plan, the validity, the price and the design live on the series. Cards belong to a series and carry their own validity, so a card that is sold six months after it was printed can still be given a full term from first use.
Generating a series
Under Cards, generate from a template or fill the form directly: how many cards, which plan, what validity, what price. The codes are generated for you.
There are two card modes. A prepaid card activates on first use, with no separate PIN — the subscriber connects with the code and the term starts then. A voucher account card credits a wallet instead of starting a plan.
Printing
Card designs are edited in Studio, the built-in layout editor, and rendered in the browser. A design can be reused across series, and a series remembers the one it was generated with.
Printing marks the cards as printed, which is how the stock figures stay honest: a series shows how many of its cards are printed, sold and still available.
Selling
Three ways, and they can all be live at once:
- The card shop, where a subscriber buys online and pays through one of the configured gateways.
- The point of sale, for counter sales by a clerk on a shift, with a printed slip.
- Handing a manager stock, through a transfer.
A card can also be redeemed by scanning its QR code, which signs the subscriber in and applies the card in one step.
Stock, transfers and reversals
Every card has a disposition — available, sold, used — and every series shows the totals. A transfer between managers writes an entry on both sides of the ledger, so a reseller's stock and their balance never disagree.
A reversal is a ledger operation, not a delete. It writes the opposite entry and leaves both visible, which is what makes the history auditable months later.
If it did not work
- A code is refused at login. Check the card's state: an already-used prepaid card, or one whose own validity has expired, is refused by design.
- A series shows fewer available cards than you expect. Cards marked printed or transferred are no longer in the available pool; the series page breaks the figure down.
- A QR scan opens the portal but does not apply the card. The scan carries the code in the link; a shortened or re-encoded link loses it.
Last updated