Skip to content

Troubleshooting ​

What it does ​

This page lists the problems staff meet most often. Find what you see in the first column, check the likely cause, then follow the fix.

Two fixes to try first

Tap Refresh in the left drawer. It reloads the menu, settings, payment methods and waiting online orders.

Then look at the indicator near the bottom of the left drawer. Red Offline means the connection has dropped.

Sign-in and locking ​

What you seeLikely causeFix
Sign In is greyed outOne of the two fields is emptyEnter your Username and your password or passcode
Sign-in fails with details you believe are correctPassword is selected but you are entering a passcode, or the other way roundTap Password or Passcode above the form to match what you are entering. Passcodes are numbers only. Passwords are case-sensitive
You are not connected to internet!The device is offlineCheck the Wi-Fi or network cable, then tap Sign In again
You forgot your password or passcode-Ask your manager to reset it. The POS has no password reset
The staff list covers the screen with Who's working today?The POS is locked, by Lock or by the auto-lock settingTap your profile. Enter your passcode or password if the POS asks. See POS Auto Lock
Your profile is not on the staff listYour staff profile is not active for this venueAsk your manager to check your staff profile in the Admin portal
No staff members foundNo active staff are set up for this venueAsk your manager to add staff in the Admin portal
You were signed out without tapping Sign outYour session ended, or someone signed you out with Logout from all devices on another terminalSign in again
Complete order before signing out!You are the attendant on an order that is still open or savedFinish the order, or hand a dine-in order to another attendant. See Shift Management
A Welcome to Pratham ResPOS checklist covers the POS screenStore settings, the payment gateway or the bill printer is not set up🔒 Manager only - complete each step. See Getting Started
The POS went back to the setup screens and its settings are goneThis terminal is no longer registered for the venue, or someone tapped Configure on the login screen🔒 Manager only - set the device up again. See First-Time Setup

Printing and cash drawer ​

What you seeLikely causeFix
Bill printer is not configured.No bill printer is set on this device🔒 Manager only - set one in Settings → Printers → Bill printer. See Printers & Cash Drawer
Label printer is not configured.No label printer is set on this device🔒 Manager only - set one in Settings → Printers → Label printer
Print failed: ...The POS could not reach the printerCheck the printer is switched on and connected by USB or network. Then print again
Printing is not supported.The app is running somewhere that cannot printUse the Windows, Android or iOS app
Nothing prints after a payment, and no window asksReceipts after payment are set to Off🔒 Manager only - change Settings → General → Receipts → Receipts after taking payment to Ask or Auto print
The Print Confirmation window does not appearReceipts are set to Auto print or Off🔒 Manager only - select Ask in Settings → General → Receipts
Nothing prints when an order is savedReceipts on save are set to Off🔒 Manager only - change Settings → General → Receipts → Receipts when saving an order for later
The receipt is blank or very faintThe thermal paper is loaded the wrong way roundReload the roll so the coated side faces the print head
The receipt stops halfwayThe paper ran outLoad a new roll, then reprint the receipt
Paper is jammed-Open the printer cover, remove the jammed paper, reload the roll and close the cover
A kitchen ticket prints on the wrong printerThe item is routed to a different kitchen printer🔒 Manager only - check Settings → Printers → Kitchen printers. See Printers & Cash Drawer
The cash drawer does not open after a cash paymentOpens drawer is off for that payment method🔒 Manager only - turn on Opens drawer for the method in Settings → Payment Methods, then tap Save changes
The cash drawer does not open for any paymentThe drawer is not connected to the bill printer, or no bill printer is setCheck the drawer cable is plugged into the bill printer. Test with Operations → Cash Drawer
Failed to open Cash Drawer! Error: ...The printer did not accept the open commandCheck the printer is on and the drawer cable is firmly plugged in

The cash drawer opens through the bill printer. It opens after a payment by any method that has Opens drawer turned on, and after a cash refund. Cash has Opens drawer on by default.

Reprint a receipt ​

For an order that is still open:

  1. Tap Orders in the left drawer.
  2. Find the order.
  3. Tap the print icon on the order card. In table view, tap Print.
  4. In Print Confirmation, tick the copies you want.
  5. Tap Print.

For an order that is finished:

  1. Tap Operations, then tap Receipts & Refunds.
  2. Find the order.
  3. Tap the print icon on the order's row.

The customer receipt prints straight away. There is no choice of copies for a finished order.

You want to...Do this
Send the receipt instead of printing itIn Receipts & Refunds, tap the share icon on the order's row. See Receipts & Refunds
Reprint the card terminal's own receipt🔒 Manager only - tap Settings → Payment Gateway → Logs and receipts → Reprint receipt. Not every gateway offers it

Payments and card terminal ​

What you seeLikely causeFix
Setup Payment gateway from settings and then proceed!No payment gateway is set up on this device🔒 Manager only - set one up in Settings → Payment Gateway. See Payment Gateways
The card terminal does not respondThe terminal is off, asleep or off the networkCheck the terminal is on and connected. Restart it, then try the payment again
The card terminal is not pairedPairing was lost or never completed🔒 Manager only - tap Settings → Pair Card Terminal and follow the steps. The same screen opens from Operations → Pair Gateway
The pairing screen says the terminal is paired but payments failThe pairing is out of date🔒 Manager only - tap Pair Again and pair the terminal again
First set default payment gateway from 'General' tab!No payment gateway is active, so there is nothing to pair🔒 Manager only - select and save a gateway in Settings → Payment Gateway, then pair
A card is declinedThe card or the bank refused the paymentRead the message on the terminal. Ask the customer for another card or payment method
You think a customer was charged twice-Do not take another payment. Check the order in Operations → Receipts & Refunds and the terminal's own history. Then contact your payment provider
Coupon, Discount, Surcharge or Gift Card is greyed out with Not allowed after partial paymentA payment was already taken on the orderThese cannot change once part of the order is paid
Authenticate Admin opens when you tap Discount or SurchargeYour venue requires admin approvalAsk an Admin or Franchise Owner to select their profile and enter their passcode or password
User is not Admin!The person who signed in is not an Admin or Franchise OwnerAsk an Admin or Franchise Owner to approve
No admin users foundNo active Admin or Franchise Owner is set up for this venueAsk your manager to check staff roles in the Admin portal
Maximum allowed discount is ...The discount is above the limit for your roleEnter a smaller discount. Admin approval does not raise the limit. See Discounts
You are not allowed to apply discountsYour role does not allow discountsAsk a staff member whose role allows discounts to sign in and apply it

Admin approval is not a PIN

Approval is an admin sign-in on the Authenticate Admin screen. It exists for discounts, surcharges and refunds only. Discarding or cancelling an order asks for a reason, not for approval.

Orders ​

What you seeLikely causeFix
Please select table first to add items.The dine-in order has no tableTap the Table chip and choose a table
Please select table first!You tapped the Customer chip on a dine-in order with no tableChoose a table first
The minus and plus buttons on an item do not workThe item has already gone to the kitchenAdd the item again as a new line, or remove the line
This item has been paid for and can no longer be changed.The item was paid in a split paymentLeave the item as it is
This is a loyalty reward item and cannot be removed directly.The item is a free loyalty rewardRemove the reward from Loyalty. See Loyalty
Cannot remove this item, a split payment covering it has already been collected.The item was paid in a split paymentLeave the item on the order
Cannot remove this item, doing so would make the cart total less than the amount already paid.A payment was already takenKeep the item, or refund the payment first. See Receipts & Refunds
Order Already Paid opens when you tap another order typeA paid order cannot change typeTap Start New Order
You cannot find a Void Order buttonThe button does not existSee Discard or cancel an order
You cannot find a paid order on the Orders screenOrders shows open orders onlyTap Operations, then Receipts & Refunds
You cannot switch between open orders in the cartThe cart shows one order at a timeSave the order with Save / Print, then open the other one from Orders or Tables
Order is not processedThe order could not be saved to the serverTry again. If it keeps happening, export the logs and contact support

Discard or cancel an order ​

Where you areTapWindow that opensStatus the order gets
The order is open in the cartThe red bin icon at the top of the cartDiscard This Order?Void
The order is on the Orders screen, POS tabThe bin icon on the order cardCancel This Order?Cancelled
  1. Tap the bin icon.
  2. Select a reason. A reason is required.
  3. Confirm with Discard Order or Cancel Order.

Tap Keep Order to go back without changing anything.

If a payment has been taken on the order, the window shows This order has been PAID. with the amount. Check with a manager before you continue. Refunds are made from Receipts & Refunds.

Online orders ​

What you seeLikely causeFix
No window and no sound when an online order arrivesShow online orders is off for this terminal🔒 Manager only - turn it on in Settings → Device → Role and behaviour → Show online orders, then tap Save changes
No window on the master device, but orders are acceptedAccept new orders automatically is on, so the master device accepts without askingNo fix needed. 🔒 Manager only - change it in Settings → General → Online ordering
No online orders are arriving at allOnline Orders is Paused or DisabledTap Operations and check the Online Orders card. Tap Resume or Enable. See Operations
No online orders are arriving and the drawer shows OfflineThe connection has droppedCheck the network. See Sync and offline
An order you expect is not on the Orders screenThe list has not reloadedTap Refresh in the left drawer. The Orders screen has no refresh button of its own
The alert sound keeps repeatingRepeat until acknowledged is onOpen the new order. 🔒 Manager only - change it in Settings → General → Notifications
The alert sound is wrong or too quiet-Check the device volume. 🔒 Manager only - choose another New online order sound in Settings → General → Notifications
You accepted an order and nothing printedThe order is a pre-order. It is held until it is due and prints when it moves to In ProgressWait until it is due, or move it to In Progress. See Online orders
There is no Accept button on an orderAccept and Decline show only while the order is newly placedUse the next-step button shown on the order
No caller window opens when the phone ringsShow incoming calls is off for this terminal🔒 Manager only - turn it on in Settings → Device → Role and behaviour. See Caller ID

Displays ​

What you seeFix
A kitchen display, customer display or order status display does not connectFollow Display Connection Troubleshooting
A display was working and then stoppedFollow Display Connection Troubleshooting

Sync and offline ​

What you seeLikely causeFix
The left drawer shows red OfflineThe POS has lost its live connectionCheck the Wi-Fi or network cable and the router. The indicator turns green Online when the connection returns
An order was finished while the POS was offlineThe order could not be sentNothing to do. The POS keeps the order on the device and sends it by itself when the connection returns
A new item, price, deal or coupon is missingThe POS has not reloaded since the changeTap Refresh in the left drawer
A setting changed on another terminal does not show hereThe POS has not reloaded since the changeTap Refresh in the left drawer
The POS is slow-Close other apps on the device. Restart the POS app. Restart the device if it stays slow
The screen does not respond-Wait 30 seconds. Then close the POS app and open it again. Open orders are kept on the device

Get the details support will ask for ​

DetailWhere to find it
App versionHelp → System Information. It also shows under the clock on the login screen
Terminal nameHelp → System Information → Terminal Name, or Settings → Device → Terminal name
Outlet ID and Client IDHelp → System Information
What happenedWrite down what you tapped and the exact words of any message. Take a photo of the screen if you can
System logsHelp → System Logs → Export Logs. See Help and Support

The POS keeps logs on the device for up to 30 days.

Contact support ​

Collect the details in the table above first. They help support find the problem quickly.

Contact details are also in the app

Tap Help in the left drawer. The Contact Support section lists the current ways to reach support. See Help and Support.

Emailinfo@prathampos.com
Phone+61 457 454 857 / 1300 941 886
AddressOffice 3420, Ground Floor, 470 St Kilda Road, Melbourne VIC 3004

FAQs ​

Do I need a manager PIN to void or cancel an order?

No. The POS has no manager PIN. Discarding or cancelling an order asks for a reason only. Admin approval exists for discounts, surcharges and refunds, and it is an admin sign-in on the Authenticate Admin screen.

Where is Order History?

No screen has that name. Open orders are on the Orders screen. Finished orders are in Operations → Receipts & Refunds.

Is there a Test Connection button for the card terminal?

No. To check the terminal, confirm it is on and connected, then pair it again from Settings → Pair Card Terminal if payments still fail.

Will I lose open orders if I restart the app?

The POS keeps open orders on the device as you work. Open the app again and sign in to carry on.

Does Refresh fix an Offline indicator?

Refresh reloads the menu, settings and waiting orders. It does not repair the network. If the drawer shows Offline, check the device's Wi-Fi or network cable first.

The Configure link on the login screen looks like it might fix things. Should I tap it?

No. Configure removes everything stored on the device, including printer settings and saved orders. Only a manager should use it, and only when the device must be set up again. See Getting Started.

Pratham POS User Guide