Appearance
No-show fees and a card on file for a salon in Laravel
A balayage takes three hours. When the client does not come, the chair stays empty all afternoon and the colourist is paid for nothing. Asking for a deposit helps, but many clients close the booking form the moment it asks for money. So the big booking systems do something else: Fresha calls it capturing card details, Booksy calls it No-Show Protection. The client leaves a card when booking, nothing is charged, and the salon charges a fee only if the client does not come or cancels too late.
kitloom/booking-deposits, the deposits module of kitloom/bookings, now does this as well. On the Modules screen it is called Deposits & No-show Protection. It works on a Laravel site, with the salon's own data and the salon's own Stripe account.
Ask the agent
With kitloom/ai connected, an agent whose user manages the deposits reads the fees:
- "Which no-show fees did not go through this month?" (
booking_)deposits_ fees - "Did Ada pay her deposit for Tuesday?" (
booking_)deposits_ list
Charging, waiving and refunding stay in the admin, with a person who decides.
A card instead of a deposit
Under Deposits & No-show Protection → Settings, a service asks for one of three things:
- nothing;
- a deposit: a fixed amount, a share of the price, or the whole price;
- a card on file.
A card on file has two fees: one for a no-show and one for a late cancellation. By default each is half the visit; it can also be a fixed amount, or none. A service can have its own fees: colour and balayage, for example, while a quick trim asks for nothing at all. When a visit of several services includes one that asks for a deposit, the deposit wins.
On the booking form the client reads: A card is needed to book. Nothing is charged now. 34.00 CAD if you miss the visit or cancel less than 12 hours before. Book holds the time and opens Stripe's own page, where the client leaves the card. The bank's 3-D Secure check happens there, so a later fee needs nothing more from the client. Back on the site, the booking is made.
A client who booked from their account and left a card before is offered Use Visa •••• 4242 and skips Stripe. A client who leaves a card and closes the tab still keeps the booking: the site asks Stripe before it lets a time go. The words the client agreed to are kept with the booking, with the time and the address, in case the charge is ever disputed.
The card stays on the salon's own Stripe account, under the same key the till uses. Our pages never see the card number, there is no platform in between, and nobody takes a share.
A no-show, a late cancellation
When the client does not come, No-show asks Charge the no-show fee — 34.00 CAD. The switch starts on, and the amount can be lowered but never raised above what the client agreed to. The card is charged from the queue, and the client gets a receipt.
If the salon would rather not be asked, the setting Charge the no-show fee without asking charges the fee every time a no-show is marked. That includes a no-show marked from an email link or by an AI agent.
A client can cancel online until the cancelling limit. After that they call, and the salon cancels for them. Inside the limit, Cancel asks Cancelled late by the client: charge the late-cancellation fee. This switch starts off, because the salon also cancels for its own reasons. A decline never charges anything.
The same switch appears on the desk, in the staff member's day on the site, and in the mobile app.
When the card does not pay
A card can be declined, or the bank can ask the client to confirm the charge. Either way, the fee stays owed:
- The client gets an email with a page to pay it with any card.
- The owner gets a notice in Telegram, Slack or wherever kitloom/notifications sends them.
- With the till of kitloom/booking-checkouts, the fee also appears on the client's next bill as Unpaid no-show fee — Tue 3 Nov. Paying the bill pays the fee.
Fees lists every fee and where it stands, and the menu counts the ones not paid. Each fee has:
- Charge again, for when the client has topped up the card or spoken to the bank;
- Waive, to let the fee go;
- Refund, to send a paid fee back to the card.
Cards and trusted clients
Cards on file shows the brand, the last four digits and the expiry of each card, and nothing more. Remove deletes the card at Stripe too, but not while it holds a booking still ahead: a no-show could not be charged then. Booksy works the same way. Clients see their cards under Saved cards in their account and remove them there.
Regulars can book without any of this. No card or deposit needed on the client's card lets them book from their own account with no card and no deposit. A guest who types a regular's email is asked like anyone else.
Bookings made at the desk or on the phone ask for nothing. Ask for a card on such a booking emails the client a page to leave one.
For a Laravel developer
Stripe is reached through Laravel's HTTP client, with no SDK, on one pinned API version:
- a Checkout Session in setup mode saves the card;
- an off-session PaymentIntent, with an idempotency key per attempt, charges a fee;
- a Checkout Session in payment mode collects a fee the card did not pay.
There is no webhook to set up: the site asks Stripe when the client comes back, and the scheduler asks again before it lets a time go. Every fee paid is also a row in kitloom/payments' ledger.
The bookings module never names Stripe or this module. It asks its Prepayment contract two things:
- what is owed when booking — a deposit, or nothing now and a fee later;
- what may be charged when a booking turns into a no-show or a late cancellation.
The decisions draw their switch from the second answer. The till asks a contract of its own, Client, what a client still owes from elsewhere. Tests fake Stripe with Fakes. The module comes with both admins, Filament and Nova.
Watch it
Three short lessons from the admin, narrated:
Try it
It comes with kitloom/booking-deposits, for either admin:
bash
composer require kitloom/booking-deposits kitloom/booking-deposits-filament
php artisan migrateOn a Nova site, the second package is kitloom/.
You can open a sandbox in one click, with no sign-up: Filament or Nova. In Atelier, the salon theme, balayage asks for a card on file, and Fees and Cards on file already hold a paid fee and a declined one. Cards are asked for only once Stripe is switched on with a test key.
Every detail — the fees, the emails, the agent's tools, the routes — is in the Deposits & No-show Protection guide.