Interrupted kiosk payments
Check here before a guest pays twice. A kiosk payment can stop partway when the app restarts, the device loses power, or the card reader stops answering. Use this page when a guest is sent to a team member to finish their order, or when you can’t tell whether a guest was charged.
Requirements
- Selflane Hub 1.3.0 or later. Earlier versions keep no record of a payment in progress, so they can’t finish or cancel a payment cut off by a restart.
- The extra PAX check on Android, described in PAX terminals, needs the first Selflane Hub 1.3.0 update or later.
What the guest sees
When 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.
| Guest sees | What it means |
|---|---|
Payment received and You won't be charged again. | The card was charged, but the kiosk didn’t finish the order. Hub doesn’t save this order on its own, so a staff member needs to check. |
Payment needs checking and Please don't pay again or use the card terminal until a team member has checked. | The kiosk can’t tell whether the card was charged. It could be charged once, twice, or not at all. Hub keeps working on it in the background. |
The kiosk returns to the welcome screen after 90 seconds.
What staff should do
- Ask the guest not to pay again on the kiosk or the card terminal.
- If the guest saw
Payment needs checking, give Hub about 15 minutes. Keep the device on, online, and signed in. Hub tries again every few minutes, so its last try can come a few minutes after the 10-minute limit. If the guest sawPayment received, don’t wait. - In the Back Office , open
Sales>Ordersand filter byKiosk. See Sales Orders for help. Look for the guest’s order and its amount. - If the order is there, give the guest their order number. Hub doesn’t print a receipt for it.
- If there’s no order, don’t take a new payment until you know whether the first one went through. With a PAX terminal, check the terminal’s transaction report for the sale. If you can’t tell, contact Selflane support.
What Hub does on its own
Before a card can be charged, Hub records the payment on the device. If the payment doesn’t finish, Hub picks it up again right away. After a restart or power loss, it picks it up the next time the app opens. It then saves the order or cancels the charge.
- Within 10 minutes of the payment starting, Hub saves the order if the card was charged, or cancels the payment if it wasn’t. If the kiosk had already started canceling a Stripe payment, Hub only finishes the cancel and never saves an order. A saved order shows in the Back Office and on the KDS like any kiosk order, with its order number.
- After 10 minutes, Hub cancels a Stripe payment instead of saving the order. This keeps a guest who already gave up from getting an order. For a PAX terminal, see PAX terminals.
- Hub doesn’t print a receipt for an order it saves this way.
When the device is offline
If Selflane can’t be reached, Hub tries again after a few seconds, then every few minutes. The 10 minutes still count from when the payment started, not from when the device went offline.
Hub can’t save an order or cancel a Stripe payment while the device is offline. When it reconnects after the 10 minutes, Hub cancels a Stripe payment instead of saving the order, and doesn’t save a PAX sale. If the device stays offline for 24 hours, Hub gives up without canceling the payment, and Selflane gets an alert.
After a restart, Hub starts again only once the device is online and has loaded your businesses.
Signing out, switching business, or changing processor
- Switching business doesn’t stop Hub. It finishes payments for any business the signed-in account can open.
- Signing out pauses Hub until someone signs in again. If the next account can’t open that business, Hub gives up on the payment once 10 minutes have passed since it started. It doesn’t save the order or cancel the payment. If nobody signs in for 24 hours, Hub gives up at the next sign-in.
- Switching the card processor away from PAX in Payments makes Hub give up on every unfinished PAX payment, even approved ones. Check that no PAX payment is waiting before you switch.
PAX terminals
With a PAX terminal, Hub asks the terminal what happened to the sale. It waits 2 minutes after sending the sale, because the terminal can still be showing it. If the terminal approved the sale and the kiosk had already started saving the order, Hub sends the save again without asking the terminal.
| Terminal reports | Within 10 minutes | After 10 minutes |
|---|---|---|
| The sale was approved | Hub saves the order, if the terminal returns the sale’s transaction number and its serial number. Otherwise Selflane gets an alert and no order is saved. | Hub doesn’t save the order or reverse the sale. |
| A different amount was approved | Hub voids the sale on the terminal. | Hub leaves the sale as it is. |
| The sale was declined | Nothing was charged. There’s no order to save. | Same. |
| The sale was approved, then voided on the terminal | The charge was reversed. There’s no order to save, and Selflane gets an alert. | Same. |
| No record of the sale | Hub keeps asking. Don’t treat the guest as uncharged yet. | Hub stops asking. |
On Android with the first Selflane Hub 1.3.0 update or later, Hub also checks the terminal’s report right after the terminal answers. The guest sees Payment needs checking when the report shows:
- Two approved sales for one order. The guest paid twice. Hub doesn’t save an order or refund either sale.
- An approved sale, then a cancel. The guest paid before the cancel. Hub then saves the order as described above.
What Hub flags
When Hub can’t settle a payment, Selflane gets an alert with the payment details. Nothing shows on the device. Flagged payments include:
- A payment that shows
Payment received, where the card was charged but no order was saved. - A PAX sale the terminal approved that Hub couldn’t save as an order, including two approved sales for one order.
- A charged Stripe payment that Hub canceled instead of saving the order.
- A PAX sale that was voided on the terminal.
- A payment Hub gave up on: after 24 hours, after the processor was switched away from PAX, or for a business the signed-in account can’t open.
Related links
- Tips and payments: the kiosk payment flow and the messages guests see.
- Manage the card reader: connect, change, and update the kiosk’s card reader.
- Sales Orders: find, refund, or cancel an order in the Back Office.
- Set up Selflane Hub: install the app and switch the device to kiosk.