Tips

Three different things are called tips at Musqet, and they behave nothing alike. It is worth knowing which one you mean before you set anything up, because they take different money to different places.

Till tips are added to a card sale on the terminal. The customer taps a tip on top of what they owe, and it lands in your card takings along with the sale.
Cashier tips go straight to the member of staff who served the customer, into that person’s own Bitcoin wallet. Nothing is booked to your business, and nothing appears in your business records.
Lightning tip links are shareable links that pay your business wallet, for a tip jar on a website, a receipt or a table card.

The rest of this page takes them one at a time, then covers where each shows up afterwards.

Tips at the till

A till tip is added to a card sale on the terminal. Refunds are never tipped.

Turning it on and choosing the amounts

Tips at the till are set up in the merchant portal, under Devices > Tips. A tips configuration holds the amounts a terminal offers and whether it asks at all. You can keep more than one, for example a busier config for the counter and a quieter one for table service.

Each configuration chooses how the amounts are expressed:

Percentage, where each button is a share of the sale, so 10 means ten per cent of what the customer owes.
Flat amount, where each button is a fixed sum in your currency.

You then lay the buttons out in up to four rows of three, and each amount must be a whole number up to 1000. Turning quick tip options off leaves the till with no preset buttons, so the customer enters any amount by hand. A live preview on the same screen shows the till exactly as the customer will see it.

Choosing which terminals ask

A configuration does nothing until it is assigned to a terminal. On the same page you can:

assign one configuration to several terminals at once,
pick the configuration for a single terminal, or
leave a terminal unassigned, in which case it never asks for a tip.

Terminals with nothing assigned are listed together as Devices with no config assigned, so it is easy to see which tills are not asking. Assignments take effect on the terminal straight away, without anyone signing out and back in. Deleting a configuration unassigns it from every terminal that used it.

What the customer sees

On a card sale, a terminal with tips switched on shows Add a tip? before charging the card. The customer picks one of your amounts, chooses Other to enter their own, or chooses No Tip. The screen then shows the balance due, the tip and the new total, and the card is charged for the two together.

If the staff member backs out of the tip screen, the sale is cancelled rather than charged without a tip, so nobody is charged the wrong amount by accident.

The printed receipt breaks the two apart, showing a Primary Amount for the sale and a Tip Amount underneath, so the split is on the customer’s copy.

Tips that go to the cashier

A cashier tip is a separate, optional feature that pays the member of staff who served the customer, into their own Bitcoin wallet. It never touches your business money.

How it works

When you switch this on, the customer’s screen shows a second QR code after a sale has settled. The customer scans it and pays a tip in Bitcoin, and that tip goes directly to the personal wallet of the staff member the sale was attributed to. Nothing is booked to your business: there is no sale, no transaction and no entry in your records for it. See Where tips show up.

You turn cashier tips on, and set the tip amounts the customer is offered, in the Merchant app, under Menu > Tips. The amounts are in Bitcoin, and you can offer up to six of them.

Who can receive a tip

A sale only offers a cashier tip when all of the following are true. Musqet checks them on its own servers, both when the customer’s screen is drawn and again the moment the customer pays, so a change in between simply means no tip is offered.

Cashier tips are switched on for your business.
The sale has settled, so you actually have the money.
The sale was attributed to a staff member, so there is someone to pay.
That staff member has claimed their identity on their own device.
That person has a personal wallet set up to receive the tip.

If any one of these is not met, the customer is simply not offered a tip.

Claiming your tips

Before a member of staff can receive cashier tips, they link their staff identity to their own account. They do this on their own signed-in device, in the Merchant app, on the Wallet tab, where a Collect your tips here card appears. They pick their name from the staff list and confirm it with their till PIN, and from then on tips for their sales go to their wallet.

Two things to know:

A personal wallet must be set up first. Without one, claiming is refused with a prompt to set up the wallet before trying again, because there would be nowhere to send the tip.
Each person is linked to one staff identity per business. If someone claims a different identity, their previous link is released, so tips only ever follow one person.

If the till PIN is wrong, the app says so and lets them try again. Too many wrong attempts locks the identity for a while, and a flurry of attempts in quick succession is turned away until things settle, both to stop a PIN being guessed.

Lightning tip links

A Lightning tip link is a shareable payment link, in the form of a Lightning address and a QR code, that pays your business wallet. Use it for an online tip jar or a printed code. Unlike a cashier tip, the money goes to the business, not to an individual member of staff.

You manage tip links in the portal under Team > Lightning tips, and in the Merchant app under Menu > Business tip links.

Creating and deleting tip links is an owner task: it needs the Manage tip links permission, which owners have by default. A team member with only the View tip links permission can see the links and their QR codes, and share them, but cannot create or delete them.

Creating one

Choose Create lightning tip and fill in:

a Short name, which becomes part of your Lightning address and must be unique. It can only use lower-case letters, numbers, and the characters -, _ and .. If the name is already taken you are asked to pick another.
an optional Description, which is shown to the person paying, in their Lightning wallet.

Each link has its own Lightning address and a QR code you can show or download to share it. Deleting a link stops its Lightning address working straight away, and that cannot be undone, so the app asks you to confirm.

Where tips show up

The three kinds of tip are recorded in three different places, which is the main thing to get right when the numbers are questioned.

Till tips are part of the card sale. They are charged together with the sale and arrive in your card takings as one amount, so there is no separate tips figure to find in your reports. The one place they are itemised is the printed terminal receipt, which shows the sale and the tip on their own lines.
Cashier tips do not appear in your business records at all, by design. They are paid to the cashier’s personal wallet, so they are that person’s to see in their own wallet, and never yours.
Lightning tip links pay your business wallet, so a tip through a link arrives in your Bitcoin balance like any other Bitcoin payment.

For developers

Two of these are on the v1 API, and one deliberately is not.

Till tips configurations can be created, listed, updated, deleted and assigned to terminals through the API. A percentage amount is a whole-number percent and a flat amount is a whole unit of your currency, matching the portal.
Lightning tip links can be created, listed and deleted through the API. Creating one with a short name that already exists returns a conflict.
Cashier tips have no business-facing API, on purpose. They pay a member of staff’s personal wallet rather than the business, so there is no business record to read, and whether a given sale offers a tip is decided by Musqet at the moment of payment, not by the caller.

When something goes wrong

Match what the person is seeing.

What they see	What it means	What to do
The till never asks for a tip	The terminal has no tips configuration assigned, or its configuration is switched off	Assign a configuration in Devices > Tips and check it is enabled
The tip amounts are wrong	A different configuration is assigned, or the amounts were changed	Check which configuration the terminal has, and its rows, in Devices > Tips
Set up your personal wallet before claiming tips	The cashier has no personal wallet yet	Set up the wallet, then claim again
The PIN is refused when claiming	The till PIN entered does not match the chosen name	Re-enter it, or reset the staff member’s PIN in the portal
Locked, try again later	Too many wrong PIN attempts	Wait for the lockout to pass, then try again
The customer was never offered a tip	The sale was not attributed to a claimed cashier, or the sale had not settled	Check the sale is attributed and the cashier has claimed and set up a wallet
A tip did not reach the cashier	The sale had not settled, or the cashier had not claimed and set up a wallet when it happened	See Who can receive a tip
That short name is already taken	Another tip link already uses it	Choose a different short name
A tip link stopped working	The link was deleted	A deleted link cannot be restored. Create a new one
I cannot see my card tips as a separate figure	Till tips are charged with the sale, so they sit inside your card takings rather than on a line of their own	See Where tips show up; the terminal receipt shows the split