💳 Payment Device Setup
Connect physical payment terminals (POS devices, card readers) to LKG for Billing. Configure device type, connection method, and credentials to enable hardware-based payment processing at the point of sale.
Navigate to Integrations → Payment Devices.
Overview
The Payment Devices page lists all configured terminals. The default device is used automatically when a payment is processed unless another device is selected.
Supported Device Types
| Type | Description |
|---|---|
| Pine Labs | Pine Labs Plutus POS terminals |
| Paytm | Paytm for Business payment terminals |
| Razorpay | Razorpay POS card readers |
| Generic | Any POS device with serial/network interface |
Connection Types
| Type | When to Use |
|---|---|
| USB / Serial (Data Cable) | Device connected via USB cable to the computer; requires COM port and baud rate |
| Bluetooth | Wireless Bluetooth-paired device |
| Network (TCP/IP) | Device accessible over the local network via IP address and port |
| Cloud API | Cloud-connected device authenticated via API credentials |
Device Fields
| Field | Required | Description |
|---|---|---|
| Device Name | Yes | Display label (e.g., "Counter 1 Terminal") |
| Device Type | Yes | Pine Labs, Paytm, Razorpay, or Generic |
| Connection Type | Yes | USB/Serial, Bluetooth, Network, or Cloud API |
| Terminal ID | No | Terminal ID from the payment provider |
| Merchant ID | No | Merchant ID from the payment provider |
| COM Port | If Serial | Serial port (e.g., COM3) |
| Baud Rate | If Serial | 9600, 19200, 38400, 57600, or 115200 |
| IP Address | If Network | Device IP on local network |
| Port | If Network | TCP port (e.g., 9090) |
| Timeout (seconds) | No | How long to wait for device response (default: 60) |
| Active | Yes | Enable or disable the device |
| Default Device | No | Set as the default terminal for payments |
Adding a Device
- Click + Add Device
- Select Device Type and Connection Type — the form shows only the fields relevant to your selections
- Fill in connection details (COM port, IP, or API credentials as applicable)
- Click Save
Testing a Device
After saving, click Test Connection to verify the device is reachable and responding:
- ✅ Success — Device is connected and ready
- ❌ Failed — Check connection settings, cable, or network
Setting the Default Device
Click Set as Default on any active device row to make it the default terminal. The default device is used automatically when processing payments unless overridden at point of sale.
Editing & Deleting
- Edit — Update any device settings
- Delete — Remove a device from the list