All guides

V-POS Web App setup

Set up a V-POS Web App register: download, pair, and test your till

Prepare your store, pair a Windows checkout computer to its register, configure receipt printing and a cash drawer, and verify an online test sale.

| 6 minute read

Prepare the store in your online portal

Set up the business and store before installing a checkout terminal. Review the store address, time zone, currency, tax rules, products, prices, promotions, and employee access. Create or confirm an active register station for every checkout computer you plan to use.

  • Give each terminal its own assigned register identity, even when multiple registers belong to the same store.
  • Check the employee PINs and permissions that cashiers will use at checkout.
  • Keep the computer online during setup and checkout testing.

Download and install V-POS Web App

Download the current Windows installer from the V-POS Hardware page and run it on the computer assigned to the register. Open V-POS Web App after installation. The setup does not ask you to connect a database or manually enter a store server address.

Pair this computer to the right store and register

In the online portal, open Settings > Web App terminals, choose Pair New Terminal, select the register station for this computer, and generate a pairing code. Enter the code in V-POS Web App within 15 minutes. Each code works once.

  • Use the same V-POS environment in the portal and V-POS Web App. A code from a local development portal works only with V-POS Web App configured for that same local server; it cannot pair the production installer to a localhost account.
  • Review the store preview before finishing setup, then sign in with an employee's store PIN.
  • If the code is rejected, check the portal's terminal list and the portal address shown in V-POS Web App before generating another code. If pairing succeeded but store loading failed, use the reload-stores action rather than submitting the used code again.
  • When replacing a terminal, keep the old one until the new terminal is paired and its sales synchronization is confirmed.

Set up receipt printing and the cash drawer

Install the Windows printer driver and print a Windows test page first. In V-POS Web App, open Settings > Receipts > This computer, select the physical receipt printer, and save the settings for that computer. Confirm the receipt width and print a test receipt before a shift.

  • For ESC/POS drawer control, connect the drawer to the compatible receipt printer's drawer port, select pin 2 or pin 5 as required, and disable the printer driver's automatic drawer kick so V-POS controls the opening policy.
  • Driver-controlled mode prints a small NO SALE slip and relies on the printer driver's drawer-kick setting. Other receipts may also open the drawer in this mode.
  • Use Save and test drawer with the actual printer and drawer. Windows accepting a print job confirms it was queued; it does not prove paper printed or the drawer physically opened. Test the device before live use.

Choose the correct card-payment workflow

With Manual Card Terminal selected, the cashier enters the amount on the separate bank terminal and records approval in V-POS only after the external terminal confirms it. V-POS does not send or charge a manual card transaction. If the external transaction is declined, cancel the approval window and choose another tender as needed.

  • Card payments are processed through your payment terminal. With Manual Card Terminal selected, staff process the payment on the terminal and record the result in V-POS. Test your exact terminal before relying on it.
  • Clover, Chase, and other providers require standalone/manual processing unless a specific V-POS integration is confirmed.

Run an online checkout test before opening

With the terminal online, complete a controlled test sale. Confirm the correct products, taxes, fees or deposits, total, receipt output, and drawer behavior. Then check that the sale appears in the online portal for the assigned store. Keep the terminal online while testing.

  • Hardware compatibility varies by printer, drawer, scanner, scale, and customer display model; test each device rather than assuming it will work.
  • Offline checkout is still being validated. Do not rely on offline sales for live transactions yet.

Continue with the setup resources

Use the current setup guide for the installer, pairing steps, hardware notes, and status of checkout testing.