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 see | Likely cause | Fix |
|---|---|---|
| Sign In is greyed out | One of the two fields is empty | Enter your Username and your password or passcode |
| Sign-in fails with details you believe are correct | Password is selected but you are entering a passcode, or the other way round | Tap 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 offline | Check 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 setting | Tap your profile. Enter your passcode or password if the POS asks. See POS Auto Lock |
| Your profile is not on the staff list | Your staff profile is not active for this venue | Ask your manager to check your staff profile in the Admin portal |
| No staff members found | No active staff are set up for this venue | Ask your manager to add staff in the Admin portal |
| You were signed out without tapping Sign out | Your session ended, or someone signed you out with Logout from all devices on another terminal | Sign in again |
| Complete order before signing out! | You are the attendant on an order that is still open or saved | Finish the order, or hand a dine-in order to another attendant. See Shift Management |
| A Welcome to Pratham ResPOS checklist covers the POS screen | Store 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 gone | This 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 see | Likely cause | Fix |
|---|---|---|
| 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 printer | Check 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 print | Use the Windows, Android or iOS app |
| Nothing prints after a payment, and no window asks | Receipts 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 appear | Receipts are set to Auto print or Off | 🔒 Manager only - select Ask in Settings → General → Receipts |
| Nothing prints when an order is saved | Receipts 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 faint | The thermal paper is loaded the wrong way round | Reload the roll so the coated side faces the print head |
| The receipt stops halfway | The paper ran out | Load 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 printer | The 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 payment | Opens 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 payment | The drawer is not connected to the bill printer, or no bill printer is set | Check 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 command | Check 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:
- Tap Orders in the left drawer.
- Find the order.
- Tap the print icon on the order card. In table view, tap Print.
- In Print Confirmation, tick the copies you want.
- Tap Print.
For an order that is finished:
- Tap Operations, then tap Receipts & Refunds.
- Find the order.
- 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 it | In 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 see | Likely cause | Fix |
|---|---|---|
| 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 respond | The terminal is off, asleep or off the network | Check the terminal is on and connected. Restart it, then try the payment again |
| The card terminal is not paired | Pairing 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 fail | The 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 declined | The card or the bank refused the payment | Read 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 payment | A payment was already taken on the order | These cannot change once part of the order is paid |
| Authenticate Admin opens when you tap Discount or Surcharge | Your venue requires admin approval | Ask 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 Owner | Ask an Admin or Franchise Owner to approve |
| No admin users found | No active Admin or Franchise Owner is set up for this venue | Ask your manager to check staff roles in the Admin portal |
| Maximum allowed discount is ... | The discount is above the limit for your role | Enter a smaller discount. Admin approval does not raise the limit. See Discounts |
| You are not allowed to apply discounts | Your role does not allow discounts | Ask 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 see | Likely cause | Fix |
|---|---|---|
| Please select table first to add items. | The dine-in order has no table | Tap the Table chip and choose a table |
| Please select table first! | You tapped the Customer chip on a dine-in order with no table | Choose a table first |
| The minus and plus buttons on an item do not work | The item has already gone to the kitchen | Add 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 payment | Leave the item as it is |
| This is a loyalty reward item and cannot be removed directly. | The item is a free loyalty reward | Remove 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 payment | Leave 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 taken | Keep the item, or refund the payment first. See Receipts & Refunds |
| Order Already Paid opens when you tap another order type | A paid order cannot change type | Tap Start New Order |
| You cannot find a Void Order button | The button does not exist | See Discard or cancel an order |
| You cannot find a paid order on the Orders screen | Orders shows open orders only | Tap Operations, then Receipts & Refunds |
| You cannot switch between open orders in the cart | The cart shows one order at a time | Save the order with Save / Print, then open the other one from Orders or Tables |
| Order is not processed | The order could not be saved to the server | Try again. If it keeps happening, export the logs and contact support |
Discard or cancel an order
| Where you are | Tap | Window that opens | Status the order gets |
|---|---|---|---|
| The order is open in the cart | The red bin icon at the top of the cart | Discard This Order? | Void |
| The order is on the Orders screen, POS tab | The bin icon on the order card | Cancel This Order? | Cancelled |
- Tap the bin icon.
- Select a reason. A reason is required.
- 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 see | Likely cause | Fix |
|---|---|---|
| No window and no sound when an online order arrives | Show 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 accepted | Accept new orders automatically is on, so the master device accepts without asking | No fix needed. 🔒 Manager only - change it in Settings → General → Online ordering |
| No online orders are arriving at all | Online Orders is Paused or Disabled | Tap Operations and check the Online Orders card. Tap Resume or Enable. See Operations |
| No online orders are arriving and the drawer shows Offline | The connection has dropped | Check the network. See Sync and offline |
| An order you expect is not on the Orders screen | The list has not reloaded | Tap Refresh in the left drawer. The Orders screen has no refresh button of its own |
| The alert sound keeps repeating | Repeat until acknowledged is on | Open 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 printed | The order is a pre-order. It is held until it is due and prints when it moves to In Progress | Wait until it is due, or move it to In Progress. See Online orders |
| There is no Accept button on an order | Accept and Decline show only while the order is newly placed | Use the next-step button shown on the order |
| No caller window opens when the phone rings | Show incoming calls is off for this terminal | 🔒 Manager only - turn it on in Settings → Device → Role and behaviour. See Caller ID |
Displays
| What you see | Fix |
|---|---|
| A kitchen display, customer display or order status display does not connect | Follow Display Connection Troubleshooting |
| A display was working and then stopped | Follow Display Connection Troubleshooting |
Sync and offline
| What you see | Likely cause | Fix |
|---|---|---|
| The left drawer shows red Offline | The POS has lost its live connection | Check 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 offline | The order could not be sent | Nothing 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 missing | The POS has not reloaded since the change | Tap Refresh in the left drawer |
| A setting changed on another terminal does not show here | The POS has not reloaded since the change | Tap 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
| Detail | Where to find it |
|---|---|
| App version | Help → System Information. It also shows under the clock on the login screen |
| Terminal name | Help → System Information → Terminal Name, or Settings → Device → Terminal name |
| Outlet ID and Client ID | Help → System Information |
| What happened | Write down what you tapped and the exact words of any message. Take a photo of the screen if you can |
| System logs | Help → 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.
| info@prathampos.com | |
| Phone | +61 457 454 857 / 1300 941 886 |
| Address | Office 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.
