First-Time Setup
What it does
First-time setup connects the POS app on this device to your business. It tells the app which outlet the device belongs to and which terminal it is.
After that, the POS asks for three more things before it lets you take an order: your store details, a payment gateway and a bill printer.
Manager only
🔒 Manager only - first-time setup needs your admin username and password.
What you need before you start
| What you need | Where to get it |
|---|---|
| Client ID | A number given to your business when your account was created. Contact your administrator if you do not have it |
| Admin username and password | Your administrator login |
| A terminal for this outlet | Terminals are created in the Admin Portal. One must exist before you start |
| A bill printer | The last required step asks you to select a bill printer on this device |
The whole journey
Start setup
Read the welcome screen and tap Get Started.
Sign in
Enter your Client Id, Username and Password.
Select your outlet and terminal
Choose the outlet, choose the terminal, then tap Continue to POS.
Store Settings
Required. Enter your store details and save them.
Payment Gateway
Required. Choose the provider your card terminal uses and activate it.
Bill/KOT Printers
Required. Select the bill printer for this device.
Ready to take orders
The checklist closes and the home screen opens.
Steps 1 to 3 connect the device. Steps 4 to 6 are the Welcome to Pratham ResPOS checklist. The home screen stays blocked until all three are complete.
Part 1 - Connect this device
Start setup
- Open the POS app. The screen Welcome to Pratham POS System! appears.
- Read the list under What you'll need.
- Tap Get Started.

Sign in
- Enter your Client Id. Use numbers only.
- Enter your Username.
- Enter your Password.
- Tap Sign In.

Select your outlet and terminal
The outlet and the terminal are on one screen, headed Select Your Outlet.
- Tap Select Outlet.
- Select your outlet from the list.
- Check the details under Selected Outlet Details.
- Tap Select Terminal. This field appears after you select an outlet.
- Select the terminal for this device.
- Tap Continue to POS.
The message Terminal selected successfully! appears and the POS opens.

Selected Outlet Details shows:
| Detail | What it is |
|---|---|
| Name | The name of the outlet |
| Type | The type of outlet |
| Phone | The phone number of the outlet |
| Outlet Id | The number that identifies the outlet |
| Order Types | The order types the outlet accepts |
| Address | The address of the outlet |

WARNING
Check the address before you continue. If you choose the wrong outlet, orders, reports and receipts are linked to the wrong location.
INFO
- Continue to POS stays greyed out until you select both an outlet and a terminal.
- Tap Logout under Continue to POS to sign out and start again.
- Completing this screen also records attendance for the user who signed in. :::
If the terminal is already in use
When the terminal you selected belongs to another device, a window opens with a title such as Terminal "POS- 1" In Use. It names the other device under Active device.
| Button | What it does |
|---|---|
| Continue | Moves the terminal to this device and logs the other device out |
| Cancel | Clears your terminal choice so you can select a different terminal |
WARNING
Continue resets the other device. It loses the settings and orders saved on it and goes back to first-time setup. Only tap Continue when you mean to move the terminal, for example when you replace a broken device.
Part 2 - Complete the Welcome to Pratham ResPOS checklist
When the POS opens for the first time, the window Welcome to Pratham ResPOS covers the home screen. You cannot close it. It closes on its own when Setup Progress reaches 3/3.
| Step | What you set up | Saved for |
|---|---|---|
| Store Settings | Store details and how the outlet runs | The whole outlet |
| Payment Gateway | The provider your card terminal uses | The whole outlet |
| Bill/KOT Printers | The bill printer for receipts | This device only |
Each step has a Configure button. A finished step turns green and reads Completed.
INFO
Store Settings and Payment Gateway are saved for the whole outlet. When you add another terminal to an outlet that is already set up, these two steps already read Completed. Bill/KOT Printers must be done on every device.
Complete Store Settings
- Tap Configure beside Store Settings. The Store Details tab opens.
- Fill in the required fields. Each one is marked with
*. - Tap Save settings.
- Tap POS in the side menu to go back to the checklist.
The message POS is configured successfully. appears when the details are saved.
See Settings - Store Details for what each field means.
Complete Payment Gateway
- Tap Configure beside Payment Gateway. The Payment Gateway tab opens.
- Under Gateway, tap the provider your card terminal uses.
- Fill in the settings for that provider, if any are shown.
- Tap Save and activate.
- Tap POS in the side menu to go back to the checklist.
The message Gateway saved and activated. appears. Only one gateway is active at a time.
See Payment Gateways for the steps for each provider.
Complete Bill/KOT Printers
- Tap Configure beside Bill/KOT Printers. The Printers tab opens.
- Under Bill printer, select your printer in Printer. The choice is saved straight away.
- Tap Print test receipt to check the printer.
- Tap POS in the side menu to go back to the checklist.
See Printers & Cash Drawer to add kitchen printers, a label printer and the cash drawer.
After the checklist
The checklist closes and the home screen opens. You can change any of these settings later from the Settings menu.
Go to Setup & Configuration for the optional settings, such as displays, the weight scale and tables.
Set up the app again on this device
Use this when you move the device to a different outlet, or when you hand the device to another venue.
This cannot be undone
Setting up again removes everything saved on this device. Orders, customers and the menu stored on the server are not affected.
Open the Login screen. It shows only when no staff member is signed in on this device.
Tap Configure, beside Do you want to configure app again ?

Read the list in the Reconfigure POS System window.
Tap Yes, Reconfigure POS. Tap Cancel to keep everything as it is.

The app restarts on the first-time setup screen. Do the whole setup again, including the three checklist steps.
This data is removed from this device:
| Removed from this device |
|---|
| Restaurant & Outlet Settings |
| Printer Settings |
| Current Cart & Saved Orders |
| Receipt Customizations |
| Theme & Layout Preferences |
| Staff Authentication Data |
INFO
When the POS is only locked, it shows the Who's working today? screen. That screen has no Configure link. Sign out every staff member on that screen first. The Login screen then appears.
Messages you may see
| Message | What it means and what to do |
|---|---|
| Client Id is required. | Enter your Client Id |
| Client Id should be integer value | The Client Id is a number. Do not enter your business name |
| Username is required. or Password is required. | Fill in the empty field |
| Please select an outlet or Please select a terminal | Select a value in the field before you tap Continue to POS |
| No terminals found for this outlet. Please contact administrator to create terminals. | 🔒 Manager only - the outlet has no terminal. Create one in the Admin Portal, then select the outlet again |
| Failed to fetch outlets | The POS could not load your outlets. Check the internet connection, then sign in again |
| Terminal selected successfully! | The device is connected to the terminal |
| Failed to setup terminal | The terminal could not be saved. Check the internet connection, then tap Continue to POS again |
| This terminal is currently being used by another device | See If the terminal is already in use |
| POS is configured successfully. | The store details are saved. The Store Settings step is complete |
| Gateway saved and activated. | The gateway is active. The Payment Gateway step is complete |
| No gateways available | No gateway is turned on for your account. Contact Pratham support |
FAQs
I finished setup. Why can I not take an order?
The Welcome to Pratham ResPOS checklist is still open. Look at Setup Progress. Tap Configure on each step that does not read Completed.
The home screen opens when all three steps are complete.
Can I skip a step on the checklist and do it later?
No. The checklist has no close button and no skip button. All three steps are required before the first order.
Why do Store Settings and Payment Gateway already say Completed on a new device?
They are saved for the whole outlet. Another terminal at your outlet has already set them up. You only need to complete Bill/KOT Printers on this device.
I saved the settings but the checklist did not come back. Where is it?
Tap POS in the side menu. The checklist shows on the home screen until every step is complete.
My sign in does not work. What do I check?
- Check that Client Id holds numbers only.
- Check the username and password with your administrator.
- Check that the device is connected to the internet. :::
There are no terminals in the list. What do I do?
Terminals are created in the Admin Portal, not in the POS app. 🔒 Manager only - ask your administrator to create a terminal for this outlet. Then select the outlet again to reload the list.
What happens to the other device when I take over its terminal?
It is logged out of the terminal and reset. It loses the settings and orders saved on it and goes back to first-time setup. To use it again, set it up with a different terminal.
I cannot find the Configure link to set up the app again. Where is it?
The link is on the Login screen only. The Login screen shows when no staff member is signed in on the device.
When you see Who's working today?, sign out every staff member on that screen. The Login screen then appears.
Related pages
- Setup & Configuration - what is required and what is optional
- Settings - Store Details
- Payment Gateways
- Printers & Cash Drawer
