The Box office sells tickets for shows. A show has one or more performances (dates), each at a venue, and each performance sells ticket types (general, VIP…) from a capacity you set. This is not the Support «Ticketing» (help-desk tickets).
How a sale works
- A buyer opens
/shows, picks a date and ticket types, gives a name and mobile number, and pays through your gateway (ZarinPal, SEP or Stripe). - Their places are held for the time you set on the show (15 minutes by default) while they pay. A payment that arrives after the hold ran out is still accepted if the places are free, and otherwise returned.
- On payment the buyer gets an SMS (if your SMS line can send free text) and an email with a link to their QR tickets. An invoice and the accounting entry (account 4250 Ticket Revenue, with VAT) are created for you.
- At the door, staff scan the QR code. Each ticket gets one entry.
Where things are
| Page | What it is for |
|---|---|
| Shows | Create shows, dates, ticket types, capacity pools and discount codes; publish. |
| Orders | Every order; sell at the counter; cancel an order or a ticket; refund. |
| Refund requests | Buyers who asked for a refund after a date change or cancellation. |
| Door | Scan tickets at the entrance. |
| Reports | Sold, held and scanned per date, and the attendee list. |
| Settings | VAT rate, default hold time, SMS, whether buyers need an account, how long national IDs are kept. |
Buyers and accounts
By default anyone can buy with just a mobile number; they get a link and a tracking code to open their tickets, and can look an order up again from the Find your tickets page. Buyers who sign in (or register) also get a My tickets page in their account that lists every paid order, including ones bought before they had an account with the same verified mobile number or email. Under Settings you can turn off Allow buying without an account so buyers must sign in first.
Good to know
- Capacity is counted, never stored. A hold that runs out frees its places by itself.
- Cancelling never moves money. A refund is recorded on the order's invoice; see Orders.
- In the Persian locale refunds are paid by hand: the buyer gives an IBAN (Sheba), you pay it, and you record it on the invoice.
- Prices are shown with VAT added on top (10% by default); a show can be exempt.
- The admin dashboard can show four box-office cards: tickets sold and revenue in the last 30 days, the nights of the coming week, and the refund requests waiting. Add them from the dashboard's card picker (you need the reports permission).