📲 Installing the NX App on a New Device
This guide walks you through the full process of installing the NX POS App on a new device using Esper, completing the payment device configuration, and handling Android OS permission prompts for connected peripherals such as payment readers and USB printers.
⚙️ Overview
When adding a new POS device to your venue, you’ll install the NX App through Esper, NX’s device management platform.
Once installed, you’ll complete the Config Pay Device step from the NX Cloud Portal to ensure payment processing functions correctly.
This process ensures:
- The NX POS App is correctly installed and linked to your venue.
- The device is paired and configured with the venue’s payment environment.
- Connected peripherals such as card readers and printers have proper Android permissions.
🧩 Step 1: Confirm Device Enrollment in Esper
Before installing the NX App, verify that your device is visible and online in Esper.
- Log in to the Esper Console.
- Navigate to Devices & Groups.
- Ensure the new POS device appears under your venue’s group (e.g., NX Bar & Grill – Station 01).
- Verify it has an active Esper connection (not marked as “>24 hrs offline”).
If the device does not appear, it must first be enrolled using your NX-provided Esper provisioning template.
📦 Step 2: Install the NX App via Esper
Once the device is visible and connected in Esper:
- In the Esper Console, select the device.
- Click Apps from the device’s top navigation tabs.
- Locate the NX POS App from the list of available enterprise applications.
- Select Install App.
Esper will begin downloading and installing the NX App on the selected device.
Once installation completes, the NX POS App will appear on the device’s home screen.
💡 If automatic app updates are enabled (via NX Portal → Venue → General Settings → Technical), future updates will be installed automatically after End of Day.
🏦 Step 3: Configure the Payment Device
After installation, you must configure your Payment Device to work with your POS Device.
- From the POS Device, touch the ☁️ Cloud icon at the top right corner of the Login Screen
- Select 💳 Payments
- Touch the Config Pay Device button
- Wait for the configuration process to complete.
- The POS device will communicate with NX Cloud to load payment credentials and settings.
- When successful, the POS will display a confirmation message.
⚠️ Do not interrupt the device or network during configuration.
Payment configuration may take several minutes depending on connectivity.
🔌 Step 4: Accept Android OS Device Permissions
During the first use of NX POS, the Android operating system may present USB or accessory permission prompts for connected peripherals.
It’s important to grant these permissions so NX POS can communicate with the devices.
Payment Reader (VP3350)
If your POS device includes a VP3350 payment reader, Android may display a prompt such as:
“Allow NX POS to access this composite device?”
✅ Select Allow, and if available, check Always allow for this device.
This enables the NX App to securely communicate with the card reader for transactions.
USB Receipt Printer
If your station includes a USB-connected printer, attempt to print a receipt immediately after setup.
This will trigger a similar permission prompt:
“Allow NX POS to access this USB device?”
✅ Select Allow to enable printing functionality.
💡 If permissions are denied, disconnect and reconnect the device’s USB cable to re-trigger the Android permission request.
🧾 Step 5: Verify Functionality
Once you have completed a Config Pay Device and enabled any USB printers, proceed with testing:
- Process a test transaction (if applicable).
- Attempt to print a receipt and process a payment using the attached reader.
- Verify that both peripherals respond correctly.
Once these tests are complete, your new NX POS device is fully configured and ready for service.
🧠 Troubleshooting Tips
| Issue | Possible Cause | Solution |
|---|---|---|
| NX App not appearing on device | Esper install incomplete | Verify installation status in Esper → Apps tab |
| Payment device not responding | Config Pay Device not completed | Re-run Config Pay Device in NX Cloud |
| Android permission prompt dismissed | Permissions not granted | Reconnect USB device to re-trigger prompt |
| Printer not printing | No USB access permission | Attempt to print to trigger the prompt again |
| Payment reader shows “Disconnected” | Missing VP3350 permission | Reconnect reader and allow access when prompted |
✅ Summary
| Step | Action |
|---|---|
| 1️⃣ | Confirm the device is enrolled and connected in Esper |
| 2️⃣ | Install the NX POS App via Esper Console |
| 3️⃣ | Configure payments in NX Cloud → Payments → Config Pay Device |
| 4️⃣ | Accept Android OS prompts for payment and printer devices |
| 5️⃣ | Verify login, payment, and receipt printing |
💬 Key Takeaway
Installing the NX App through Esper and completing payment configuration ensures your new POS station is fully functional, secure, and ready to process transactions — with proper device permissions for seamless operation.