Tips and card payments on the kiosk
Guests pay for kiosk orders by card, on their own. This page shows what they see from Review your order to the pickup number, so you can set up tips and your card program and help a guest whose payment doesn’t go through.
Requirements:
- A connected card reader. See Manage the card reader.
- For tips: gratuity set up in the Back Office. See Set up tips.
- Selflane Hub 1.3.0 or later for PAX terminals, and at any business that runs a card program. Before 1.3.0, a kiosk at such a business can’t take orders: Review shows
We couldn't get your total. This page describes 1.3.0. Earlier versions don’t show the store’s reason when it refuses an order, or thePayment not completed, repeat-payment, andPayment needs checkingmessages.
Review and pay
Guests tap through from their cart to Review your order. Nothing is charged until they tap Pay.
On this screen, guests can:
- Switch between
Here · pickup at counterandTo go. - Tap
Edit orderorAdd more itemsto go back to the menu. - Choose a tip, if you offer one. See Tips.
- Tap
Pay. The button shows the total to be charged.
The payment summary lists, in this order:
- Service fees, each by its name.
Subtotal, which includes the service fees.- Tax, one row per tax rate, each by its name and percentage.
- Weekly specials, as negative amounts.
- Your card program’s line, by its name. See Card program.
Tip, only when the guest chose one.Total.
Every amount comes from Selflane. While Selflane prices the order, Pay shows a loading animation and the summary shows Confirming today's prices….
When the guest taps Pay, Selflane prices the order once more. The Amount due on the next screen is what’s charged, and it normally matches the total on Review your order.
When guests can’t tap Pay
Pay is grayed out when:
- The card reader isn’t connected. Under
Pay, guests seeCard reader unavailable · please ask a team member, orReconnecting to card reader… · please wait or ask a team memberwhile Selflane Hub reconnects it. See Manage the card reader. - A dish is sold out or no longer on the menu. The guest removes it, or changes its choice, before paying.
- Selflane couldn’t price the order. A card shows
We couldn't get your totalandTry again. The order is saved. - Your business isn’t taking orders right now, for example because it’s closed. The card shows
This store can't take your order right now, thenPlease ask a staff member for help.andTry again. When Selflane sends a reason, it shows in English between the two lines.
Tips
The kiosk asks Add a tip? above the payment summary when tips are set up. Guests tap a tip, or No thanks to skip it. They can change their choice until they tap Pay.
If the guest changes the order and the tip they chose is no longer offered, the kiosk clears it without a message. For example, a $2.00 tip on a $12 order is cleared when added dishes take the order past the $15 threshold, because only percentages show then.
- At or above your
Dollar tip threshold, guests see yourSuggested choicesas percentages, each with its dollar amount (for example18%over$3.24). - Below the threshold, guests see
$1.00,$2.00, and$3.00, plus10%,15%, and20%. The threshold is $15 if you haven’t set one. - Tips scroll sideways when there are more than fit.
- Your
Default tip ratestarts selected when it matches a tip on screen the first time the guest reachesReview your order. Otherwise no tip is selected. If the guest goes back to the menu and returns, the default isn’t applied again.
A percentage tip is worked out on the dishes’ total, before weekly specials, service fees, and tax. Include tax in calculation doesn’t apply on the kiosk.
Set up tips
See Payment settings for all gratuity options.
- In the Back Office , open
Settings→Point of Sale→Payment, and go toGratuity. - Turn on
Allow gratuity. - Turn on
Use front-display tip screento show the kiosk tip settings. - Add your
Suggested choicesand set theDefault tip rate. The Back Office fills in 18% when the rate is empty. Enter0to start every order with no tip selected. - Set the
Dollar tip threshold. - Save your changes.
The kiosk shows no tip step when Allow gratuity is off, or when there are no Suggested choices. If gratuity was never saved, the Back Office shows Allow gratuity ticked but the kiosk treats it as off. Save Gratuity once to turn kiosk tips on. The kiosk doesn’t check Use front-display tip screen itself, so turning only that off keeps tips on the kiosk.
In Selflane Hub 1.3.0 or later, tip changes reach the kiosk within about 10 minutes, without a restart. A change never appears while a guest is ordering.
Card program
In Selflane Hub 1.3.0 or later, if your business runs Dual pricing, Surcharge, Service fee, Convenience fee, or Non-cash adjustment, the kiosk adds its line to every order. Kiosk guests always pay by card, so the line always applies.
True-cash discount adds nothing on the kiosk. Guests pay the menu price, because the kiosk doesn’t take cash.
The line shows by your program’s name, after tax and any weekly specials, and before Tip. It’s included in Total, in the charge, and on the printed receipt.
Set up the program in Cash Discount. Check a test order on the kiosk after changing it.
Pay at the card reader
After Pay, the kiosk shows Preparing your order… while Selflane builds the order. Then it shows the Amount due and asks for the card:
- Stripe reader:
Tap, insert, or swipe your cardandReady · present card. While the card is read,Reading your card…. - PAX terminal (Selflane Hub 1.3.0 or later):
Finish on the card terminalandFollow the prompts on the terminal. Guests tap, insert, or swipe on the terminal.
Guests can tap Cancel, or Back to cart at the top, until the card is read. If they cancel while the reader is busy, they see Canceling payment… and Please wait for a few seconds.
An Expires countdown shows at the bottom. Guests have 90 seconds, and any tap or reader activity starts it again. In the last 10 seconds, the countdown turns amber. With a Stripe reader, guests also see Present your card now to keep your order. At zero, the kiosk cancels the payment, clears the order, and returns to the welcome screen.
If the card reader disconnects, guests see Card payment temporarily unavailable and Please ask a team member — your order is still saved. The countdown shows Paused. They can tap Try Again once the reader is back, or Back to cart.
After the payment
When the card is approved, the kiosk shows Payment Received and Creating your order… while it saves the order. If saving takes longer than usual, guests also see This is taking longer than usual — retrying.
Once the order is saved, the kiosk shows Payment approved, the amount, and the pickup number, for example Pickup #42.
The receipt prints on its own. At the bottom of the screen, guests see Printing your receipt…, then Receipt printed. If it doesn’t print, they see Receipt didn't print — note your order number. See Printers.
Guests tap Start new order, or the kiosk returns to the welcome screen after 30 seconds.
When a payment doesn’t go through
| Guest sees | What happened | Guest can tap |
|---|---|---|
Card declined, with the reason from the card reader | The card was declined. | Different Card, Back to cart |
Payment not completed and The payment didn't go through, and nothing was charged. | The PAX terminal timed out or was canceled before a card was used. | Try Again, Back to cart |
Card declined and The terminal flagged this card as a repeat payment. Nothing was charged. Try a different card. | A PAX terminal refused the card as a repeat payment. | Different Card, Back to cart |
Payment couldn't be completed | The payment stopped before the card was charged. | Try Again, Back to cart |
Couldn't prepare your order and No payment has been started yet. | Selflane couldn’t build the order, for example with no internet. | Try Again, or Back to cart if trying again won’t help |
Canceled | The guest tapped Cancel. Your card was not charged. shows when a started payment was released. | Back to cart |
Card payment temporarily unavailable | The card reader disconnected. | Try Again, Back to cart |
On these screens, the Expires countdown runs again, and every tap starts it over at 90 seconds. Card payment temporarily unavailable pauses it. When it runs out, the kiosk clears the order and returns to the welcome screen.
See a team member to finish your order
If the kiosk can’t confirm how a payment ended, it shows See a team member to finish your order with no buttons. It never offers to charge the guest again.
Payment receivedandYou won't be charged again.: the card was charged, but the order wasn’t saved.Payment needs checkingandPlease don't pay again or use the card terminal until a team member has checked.: the kiosk can’t confirm the charge. The card could already be charged, even twice. Check the terminal before the guest pays again.
The kiosk returns to the welcome screen after 90 seconds.
Hub keeps working on the payment after the guest leaves. See Interrupted kiosk payments for what it does and what staff should check.
Related links
- Manage the card reader: connect, change, and update the kiosk’s card reader.
- Payment settings: gratuity settings in the Back Office.
- Cash Discount: set up Dual Pricing, Surcharge, and other card programs.
- Set up Selflane Hub: install the app and switch the device to kiosk.
- Kiosk hardware: supported card readers and printers.