Skip to Content
Selflane HubKioskTips and payments

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 the Payment not completed, repeat-payment, and Payment needs checking messages.

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 counter and To go.
  • Tap Edit order or Add more items to 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:

  1. Service fees, each by its name.
  2. Subtotal, which includes the service fees.
  3. Tax, one row per tax rate, each by its name and percentage.
  4. Weekly specials, as negative amounts.
  5. Your card program’s line, by its name. See Card program.
  6. Tip, only when the guest chose one.
  7. 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 see Card reader unavailable · please ask a team member, or Reconnecting to card reader… · please wait or ask a team member while 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 total and Try 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, then Please ask a staff member for help. and Try 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 your Suggested choices as percentages, each with its dollar amount (for example 18% over $3.24).
  • Below the threshold, guests see $1.00, $2.00, and $3.00, plus 10%, 15%, and 20%. The threshold is $15 if you haven’t set one.
  • Tips scroll sideways when there are more than fit.
  • Your Default tip rate starts selected when it matches a tip on screen the first time the guest reaches Review 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.

  1. In the Back Office , open Settings → Point of Sale → Payment, and go to Gratuity.
  2. Turn on Allow gratuity.
  3. Turn on Use front-display tip screen to show the kiosk tip settings.
  4. Add your Suggested choices and set the Default tip rate. The Back Office fills in 18% when the rate is empty. Enter 0 to start every order with no tip selected.
  5. Set the Dollar tip threshold.
  6. 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 card and Ready · present card. While the card is read, Reading your card….
  • PAX terminal (Selflane Hub 1.3.0 or later): Finish on the card terminal and Follow 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 seesWhat happenedGuest can tap
Card declined, with the reason from the card readerThe 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 completedThe 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
CanceledThe guest tapped Cancel. Your card was not charged. shows when a started payment was released.Back to cart
Card payment temporarily unavailableThe 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 received and You won't be charged again.: the card was charged, but the order wasn’t saved.
  • Payment needs checking and Please 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.

Last updated on