Skip to main content

How to Handle Payment Failures, Cancellations, and Refunds on Kiosk

Who is this for?

Staff who need to handle payment issues, cancel orders, process refunds, or assist customers during technical difficulties while using the Kiosk.

Before You Begin

  • Your POS register is operational and can accept payments.

  • You have Manager level access for cancellations and refunds.

  • You have Manager PIN access for Kiosk settings.

  • You have an active Kiosk license.


Step-by-Step Guide

Handling Payment Failures

How To Handle Payment Errors or Timeout

When a payment does not go through, the Kiosk shows a message such as 'Payment Error', 'Transaction Failed' or 'Payment was cancelled'.

Common Causes:

  • Insufficient funds in customer's account.

  • Card declined by bank.

  • QR payment timeout (customer took too long to scan).

  • Network connectivity issues.

  • Card not enabled for online payments.

Kiosk 'Payment Error' message with the 'Retry' and 'Change Payment Method' buttons, and 'Cancel Payment' at the bottom

1. Guide Customer to Retry

Ask the customer to tap 'Retry Payment' on the Kiosk. On some payment types, the button is called 'Retry'.

  • If successful → Order is processed automatically with no further action needed.

  • If fails again → Proceed to 'Change Payment Method'.

2. Guide Customer to Change Payment Method

  • Ask the customer to tap 'Change Payment Method' button.

  • Customers can try a different payment option:

    • Switch from QR to Card Terminal (or vice versa)

    • Try a different card

  • If successful → Order proceeds automatically.

  • If online payment options are not suitable → Proceed to 'Pay at counter'.

3. Guide Customer to 'Pay at counter'

  • Ask the customer to select 'Pay at counter'.

  • Kiosk prints a receipt with order details.

  • Customer brings receipt to the counter.

  • Process payment on POS using any available payment method (cash or card via external terminal)

How To Manually Approve a Transaction (When Customer Shows Proof of Payment)

Sometimes a customer's payment is deducted from their account, but the order doesn't go through on the Kiosk due to network issues.

When To Use Manual Approval:

  • Customer shows proof payment was made (banking app screenshot, transaction notification).

  • Payment amount matches the order total.

  • Order did not process on the Kiosk.

  • Customer should not be charged twice.

How To Manually Approve:

1. On the payment screen, tap the top right corner 3 times quickly. The 'Enter Manager's PIN' box appears.

2. Enter your 'Manager PIN'

3. The 'Manager Approve' box appears.

4. Under 'Add Note', type the transaction or payment ID from the customer's proof of payment.

5. Tap 'Confirm'

6. The order will be processed and sent to the kitchen for preparation.

Kiosk manual approval: tap the top right corner, enter the Manager PIN, add a note, tap 'Confirm' to see 'Payment Successful'


Refunding Kiosk Orders

You can only refund Kiosk orders manually through the POS Register. Refunds cannot be processed directly on the Kiosk device or the BackOffice.

How To Refund a Completed Kiosk Order (After Payment)

1. On your POS register, tap the 3 dots icon on the right side (menu icon)

2. Tap 'Manual Refund'

3. Enter the items that you want to refund.

4. Verify the refund total matches what customer paid

5. Complete the transaction

  • Enter Manager PIN if prompted

6. Choose a refund method.

7. Select a refund reason from the options.

8. Tap 'Confirm'.

POS manual refund: tap the 3 dots, then 'Manual Refund', add the items, pick 'Cash', choose a refund reason and tap 'CONFIRM'

Provide refund receipt to customer

Printed 'Returns Receipt' for a manual refund, showing the refunded items, the refund reason and the total refunded


Troubleshooting

Issue

Solution

QR Payment code not appearing on Kiosk

Check the internet connection. In BackOffice, go to 'Settings', then 'Payment Options', and check that DuitNow QR is enabled. In the meantime, ask the customer to choose 'Pay at counter'.

Customer says payment was deducted but order didn't go through

Check the customer's proof of payment. Once confirmed, approve the order manually on the Kiosk. See 'How To Manually Approve a Transaction' above.

Payment succeeds but kitchen doesn't receive order

Check kitchen printer connection and KDS connectivity. Verify Kiosk's assigned Main Register has kitchen printing enabled and check if the product has an assigned printer.

Cannot find order to refund on POS

Check the 'Online' tab under 'Transactions' (not 'Open Orders'). Filter by "KIOSK" label. Search by order number or time. Verify date range matches when order was placed

Customer wants to cancel after paying

Explain that paid orders cannot be canceled, only refunded. Process a manual refund through POS following the refund procedure above


FAQs

1. Can I cancel an order that's already being prepared in the kitchen?

Yes, but this should be avoided when possible as it wastes food. If you must cancel, communicate with kitchen staff immediately to stop preparation. For paid orders, process a manual refund instead.

2. Can I see which sales came from my Kiosk?

Yes. In BackOffice, go to 'Online Orders'. Click 'All Channels' to open the channel list, make sure only 'Kiosk' is ticked, then click 'Apply'.

The 'Online Orders' page in BackOffice with the channel list open, only 'Kiosk' ticked and 'Apply' highlighted.


Need Help?

Contact StoreHub Support via live chat in your StoreHub app or email [email protected].


Was this article helpful?

Let us know below or contact support for further assistance.

Did this answer your question?