Appearance
Sell gift cards online for a salon, in Laravel
December is when people buy gift cards: a haircut for a sister, an hour of nails for a mother. A salon that can only sell one at the desk misses everyone who shops at eleven at night, and the client who wanted to give one goes to the salon down the street that has a Buy a gift card button. The cards it does sell are a paper slip and a line in a notebook, and nobody knows what is left on card number 14.
Fresha, Square, Vagaro and Boulevard all sell gift cards. kitloom/gift-cards does it on a Laravel site with the salon's own data, its own payment provider and no share of the sale to anyone.
Sold online
On the salon's Gift cards page the buyer:
- picks an amount — the ones you offer, or one of their own in your range;
- says whether it is for them or for someone else, with that person's name, email and a message;
- chooses the day it goes, a birthday or Christmas morning;
- pays through your online payment method (Stripe, PayPal, Square, Mollie — whichever kitloom/payments has switched on).
The card is made when the payment provider confirms the money, never before. It goes out at nine that morning, your time, with a card to print attached: your name, the amount, the code and the message. The buyer gets a receipt and a copy at once.
Sold at the desk
Gift Cards → Sell a gift card:
- the amount;
- how it was paid — cash, your bank terminal, another way;
- whom it is for.
The code shows once, and Print gives the card to hand over in an envelope. A manager may also give one away (given, not paid), and the card's history says so.
Spent at the till
With kitloom/booking-checkouts, Take a payment has Gift card, in either admin and in the staff's app:
- the code typed in, and Check says what is left;
- the card pays what is due, or all it holds, and the rest is paid another way;
- the bill and the receipt name it by its last four characters.
Give money back → Back onto the gift card returns what it paid onto it: a gift card's money never leaves as cash.
Kept straight
What a card is:
- A code with a balance that carries from visit to visit.
- No expiry. Manitoba and most Canadian provinces do not allow an expiry date on a gift card; elsewhere, a setting in months.
- Kept encrypted. The code is shown everywhere by its last four characters, so a copy of the database spends nobody's card.
What the salon sees:
- The ledger. Every change of a balance — issued, spent, returned, corrected — is a line on the card's page, with who did it and why.
- What the cards still hold. A widget on the dashboard shows the total, the number the accountant asks for.
- Corrections and cancellations are a manager's, with a reason.
- The balance page. Anyone with a code sees what is left on it at
/, a page that refuses a guesser after five tries.gift- card/
Ask the agent
With kitloom/ai connected, an agent whose user sells cards can do it in words:
- "Sell a $75 gift card to Ruth for her sister Lena, paid in cash." (
gift_— it answers the code once)cards_ sell - "What is left on card HC3B?" (
gift_)cards_ find
For a Laravel developer
The tables are the module's own: gift_, gift_ (the ledger) and gift_. They sit on Eloquent models the application can swap through the Model.
Writing and selling:
Giftis the only writer.Card Writer issue,spend,give,Back adjustandcanceleach lock the card's row and write a line, andspend()takes a reference, so a payment told twice is spent once.- Selling online.
Selling\puts a purchase through kitloom/payments as aPurchases Payable. - For a theme. The
giftpage part gives it everything its form needs, and a headless site posts toCards gift-.cards/ v1/ purchases
The till. It names no module: kitloom/booking-checkouts takes another module's way of paying through a new contract, Bill — check, take inside the bill's lock, give. Store credit or a loyalty balance would fit the same way.
Around it:
- events
GiftandCard Issued Gift;Card Spent - webhooks
gift_andcard. sold gift_;card. used /;api/ v1/ gift- cards - privacy export and erase, which keep the ledger;
- a spreadsheet export.
Watch it
Try it
bash
composer require kitloom/gift-cards kitloom/gift-cards-filament
php artisan migrateOn a Nova site, the second package is kitloom/. Atelier, the salon theme, has the Gift cards page ready.
Open a sandbox in one click, with no sign-up: Filament or Nova. Every detail — the settings, the agent's tools, the routes — is in the Gift Cards guide.