Appearance
Booking Checkout
A visit or a walk-in paid at the salon: the bill with what else was done, GST and other taxes on a line each, the tip, the deposit already paid; cards through the salon's own Stripe (Tap to Pay, a reader on the counter, Interac), cash, the receipt by email and the day's till by staff member.
kitloom/ · admins: kitloom/, kitloom/
A visit paid at the salon. Each booking gets a bill: the service that was booked, whatever else was done, GST and any other tax on a line of its own, the tip, and the deposit the client already paid online. Money given against it — a card tapped on the staff member's phone, cash, or another way — is written down with who took it and when, and the till of a day, a week or a month adds it up by way of paying and by staff member, with the taxes collected by name.
A client who walks in is billed the same way, and the receipt goes by email. It sits on kitloom/bookings and kitloom/payments. The admin is kitloom/booking-checkouts-filament or kitloom/booking-checkouts-nova; the staff take payments in the kitloom mobile app (kitloom/mobile-apps).
Setting it up
- Checkout → Settings → Taxes. Add each tax your bills must show: a name and a percent —
GST,5; a provincial tax beside it where you charge one. With none, a bill has no tax line. - The prices already include tax — leave it off if tax is added at the till, as in Canada: a $40 cut with 5 % GST comes to $42. Switch it on if your prices are what the client pays: the bill then only shows how much of the $40 is tax.
- Tips offered — the shares the app offers before paying (10, 15, 20 by default). An amount of the client's own and "no tip" are always there.
- A paid bill marks the visit done — on by default: once a bill is paid in full on the visit's day — before its time too, when the client came early — the booking is marked done and nobody taps Done as well. A visit paid for on an earlier day is marked done by hand.
- Email a receipt when a bill is paid — on by default: the receipt goes to the address the client booked with as soon as the bill is paid in full. Whatever this says, a receipt can be sent again from the bill — in the app or the admin — to that address or another the client gives.
Cards
A card is taken through your own Stripe account — the secret key you keep under Payments → Settings → Stripe — and the money goes from the client's card to your Stripe and on to your bank. Nobody takes a share but Stripe.
- In the Stripe dashboard open Terminal once and accept its terms; Stripe makes your first location there.
- Under Payments → Settings, switch Stripe on and paste your secret key.
- In the mobile app, Take payment then offers Tap to Pay: the client taps their card on the staff member's phone (Android 13 or later with NFC; Stripe lists the phones it accepts).
A bill is never paid at the phone's word. The app starts a payment, the phone collects the card, and the bill is paid when Stripe itself says the money is in — asked when the phone reports back, and again whenever the bill is opened, so a phone that lost its network after the tap loses no payment. In Canada Interac is offered beside the cards.
A reader on the counter. Order a Stripe reader (S700, WisePOS E) in the Stripe dashboard under Terminal → Hardware orders, and register it there under Terminal → Readers with the code its screen shows. It then appears in the app's Take payment as Card reader, and in the admin as Send to a card reader on a bill's row: the payment is sent to it from any phone or from the admin, the client taps or inserts the card and enters a PIN on the reader, and the screen waits until Stripe says it is paid — or says why not. In Canada this is the way to take Interac debit above 100 CAD, which a phone cannot.
The salon's bank terminal. A salon that keeps its bank's terminal (Moneris, Clover) or another service's changes nothing: the card is taken there as always, and Paid on the salon's bank terminal writes it against the bill, so the day's till and the tips still add up. Nothing is sent anywhere.
Tips at the terminal. A tip is set on the bill before paying (Tip: none, one of the shares, an amount), and the terminal is sent what is due with it. Where the client chooses the tip on the terminal itself:
- A Stripe reader asks for it before the card while Settings → Ask for a tip on the card reader is on: the first three of Tips offered, "No tip" and an amount of the client's own, worked out on the services and goods before tax. The tip chosen is written on the bill as its Tip when Stripe says the payment is in, against the visit's staff member, and the receipt shows it. A bill that already has a tip is sent without the question. kitloom sets the shares on your Stripe location (a Terminal configuration named "kitloom: tips"); a reader takes a change within about five minutes.
- The salon's bank terminal: Paid on the salon's bank terminal has Of which tip — the tip line of the terminal's slip. The bill's tip grows by it and the payment is written for the whole, in one step. Write it before the payment: a paid bill takes no tip any more.
Good to know: Tap to Pay takes contactless cards only. Above your country's contactless limit some cards ask for a PIN through the chip, which a phone cannot read — take those another way (a Stripe reader, cash).
Money goes back to a card from the bill: Give money back → Back to the card, through Stripe, by whoever manages the bookings. An Interac payment is the exception: its bank's rules want the card held to a reader again, so it goes back with On a card reader, with the card — the reader waits for the client's card, and the bill shows the money as given back once Stripe says it went.
A bill
| Opened | The first time someone opens Take payment on a visit, with the booked service at the booking's price. |
| Lines | Another service from your catalogue (at the staff member's own price where they have one), or anything you name and price — a product, a small extra. A free line can be marked untaxed (a gift card). |
| Discount | One a bill, a line taking money off. The visit's own, as it was booked with kitloom/booking-discounts ("First visit −12.00"), is there when the bill opens, under the services at their own prices. Give a discount takes a share or an amount off the services or off everything the visit's own (never a debt from before), with a word why; Discount code takes a code the client gives at the till, as the discounts module answers it (with kitloom/booking-discounts). A new discount takes the place of the one there was; taking one off gives its code back to the client. A staff member gives up to Largest discount staff give themselves (10 % by default); Give discounts of any size at the till (give_, managers) gives any. A discount is taxed as the lines it lowers: the taxes come out of what is left. |
| Taxes | Every line is taxed but the tip. Each tax is its own line. They are kept on the bill as they were when it was paid: changing a rate later rewrites no old bill. |
| Tip | A share of the lines before tax, or an amount. It is paid with the rest, to the salon, and written against the visit's staff member — the till shows tips apart from the takings, for you to pay out. |
| Deposit | What the client paid online when booking (kitloom/booking-deposits) is taken off what is due, not off the total. |
| Owed from before | What the client still owes from another visit — a no-show fee their card did not pay (kitloom/booking-deposits) — comes on the bill as a line of its own when it opens: untaxed, no share of the tip. Paid with the bill, it is paid where it is kept. Taken off the bill, it stays owed and does not come back on this bill. Paid on the client's link before anything is paid here, its line goes. |
| Payments | A card through Stripe (see above), a card on your own terminal, cash, or another way (a transfer, a voucher) with a note — and a gift card with kitloom/gift-cards: its code typed, it pays what is due or what it holds, the rest is paid another way. Several payments may pay one bill; more than is owed is change, not money kept. |
| Paid | The bill is closed: no line, tip or payment is added. |
| Money given back | By whoever manages the bookings only — all of it or a part, with a word why. Back to the card, Stripe sends it; on a card reader, with the card (Interac's only way); what a gift card paid goes back onto it, never as cash; cash and the rest are written as given back by hand. |
| Receipt | An email with the visit, every line, each tax, the tip, the deposit and every payment, in the language the client booked in. The same receipt, numbered and dated, is on the visit in the client's account (Details, with Print) and in the app. |
A client without a booking
Someone walks in and is seen at once: in the app, Walk-in: take payment now on the day — the service, the staff member (yourself, or anyone for whoever runs the salon), and a name and an email if the client wants a receipt. The visit is written for this very minute, nobody is sent a booking email or a push, and its bill opens to be paid like any other; once paid, the visit is done and counts in the day's visits, the client's card and the reviews. It is written whatever the calendar says of that minute — a booking at the same time stays as it is, beside it.
Who does what
- A staff member opens the bills of their own bookings, adds lines and the tip, takes payments and sends receipts. They see their own till on Done, and write their own walk-ins where they book their own clients.
- A discount a staff member gives up to the share set in the settings; whoever holds Give discounts of any size at the till gives any.
- Whoever manages the bookings does the same for every booking, gives money back — in the app or the admin — and sees the salon's till with each staff member's part.
- The Checkout section of the admin (the bills and these settings) opens to the roles you give See the bills and the checkout settings on the roles screen.
In the admin
At the desk. On the calendar's day (Bookings → Calendar), a visit's panel has Checkout: it opens the visit's bill — made the first time — on a page of its own:
- the visit, the lines and the taxes, the tip, the deposit paid when it was booked, every payment, and what is still to pay;
- Add a service (at the staff member's own price where they have one), Add a line (a product sold at the counter, a fee: what, price, quantity, taxed or not), the ✕ beside a line to take it off;
- Tip — none, one of the shares in the settings, or an amount;
- Take a payment — cash (hand over more than is due and the change is worked out; only what is due is written), the salon's own bank terminal, or another way with a word (an e-transfer, a voucher); Send to a card reader and Check the card payment with Stripe Terminal; Email the receipt; Print — the page prints as the receipt; Give money back for a manager.
Walk-in: take payment now, at the top of the calendar and on the dashboard: the service, the staff member, the client found or new — or nobody — writes the visit for now, told to nobody, and opens its bill.
Checkout → Bills lists every bill, newest first: the booking and its client, the staff member, the total with its lines, the tip, what was paid and what is still owed. A row opens the bill's page; its menu has the same actions.
Checkout → Takings (Filament) is the till of a day, a week or a month, with arrows to the time before and after: what was taken, how much of it is tax and how much tips; by each way of paying; the taxes collected, each by name — on the bills paid in full in that time, as each bill kept them, so the figure is the one to remit; and each staff member's visits, no-shows, takings and tips. Whoever manages the bookings sees the whole salon; a staff member the section opens to sees their own part, where Bookings → Settings shows the staff the money.
On the dashboard (Filament), under the bookings' numbers of the day, Taken at the till today: what was taken, less what was given back, by each way of paying, and the day's tips — for the roles the Checkout section opens to. kitloom- false takes it off.
For developers
Billis the only writer:Writer open($booking, $actor),walk(a visit of this minute, bookings' sourceIn($input, $actor) walk-, and its bill),in add,Line() remove,Line() tip(),pay()(by hand),take()(a payment however it was taken — a terminal names its own reference),refund(),refunded()(what Stripe already sent back).Bills::is the bill as a screen draws it;present($bill, $actor) Bills::the takings of a day, a week or a month —till($staff, $date, $period) taken,tips,taxes(a name and an amount each) andtax,Total by,Method by.Staff Billworks the figures in cents.Totals:: of($lines, $taxes, $included, $tip) Cardtakes a card through Stripe Terminal:Payments token(),start()(a PaymentIntent and a row that waits),settle()(Stripe asked; paid there, written here and into kitloom/payments'billing_— and a refund that waited on a reader, once it went),payments refund(),refund,On Reader() refundable().Stripe\is the thin client onTerminal Client Http, pinned to one API version.Receipts\, and onReceipts:: send($bill, $email, $actor) Billby itself while the setting is on; the email isPaid Receipts\, queued. Its rows areReceipt Email Receipts\, which bookings'Receipt Rows:: of($bill) Visit(Bill Visits\) also hands to the client's visit asCheckout Visit Bills receipt.- Events:
Events\,Bill Paid Events\.Bill Refunded - REST
booking-under the site's root, and the same controller under the app'scheckouts/ v1 app/:v1/ bookings POST bills/,walk- in POST bills/,{code} …/,lines DELETE …/,lines/ {id} POST …/,tip …/,pay …/(refund methodcard, reader, cash, other),…/,receipt …/,card …/,card/ settle …/,reader …/,reader/ cancel POST terminal/,token GET terminal/,readers GET till,GET salon/.till - What a deposit covered comes from the bookings'
Contracts\; no module is named.Prepayment:: paid() - A discount is a line with
discountset (booking,hand,code;Bill) and a negative price, apart fromLine:: lowers() ref(a debt from elsewhere).BillandWriter:: discount() discount(RESTCode() bills/and{code}/ discount bills/) write it; the visit's own comes from bookings'{code}/ discount/ code Contracts\when the bill opens and follows a move, andVisit Discount:: of() release()gives a discount module's use back when its line goes. A presented bill's lines carrydiscount, and the billdiscount:;{most, codes} Bills::answerstill() discounts, what they took off the bills paid in the time. - A way of paying another module keeps (a gift card, store credit): a
Contracts\taggedBill Tender Bill—Tender:: TAG key()(the payments'method, never one of the till's own),label(),fields()the till asks for,check($bill, $input, $cents)(what it would take, nothing spent; RESTbills/),{code}/ tender take($bill, $input, $cents, $reference)inside the bill's lock — what it moves and the payment stand or fall together — andgiveon a refund.Back($bill, $payment, $cents) Tenders\reads the tag; a presented bill lists them underTenders tenders, with what of each may go back. - Money a client owes from elsewhere: a
Contracts\taggedClient Debt Client—Debt:: TAG owed($bill)answersDebts\s (aDebt refthat stays the same, the line's words, the amount) for the bill's client;settled($bill, $ref)is called for each when the bill is paid. A bill opened for a client gets a line per debt (refonbooking_), one debt on one bill being paid at a time; while nothing is paid, a debt no longer owed loses its line.bill_ lines - Tables:
booking_,bills booking_,bill_ lines booking_.bill_ payments