This guide will help you turn on or off the Peer to Peer connection feature in your Viva Terminal app. The Peer to Peer protocol (also known as 'Local Terminal API') allows the Twine POS system to communicate with your card terminal device over the same network.

Requirements

Viva Terminal app installed on your Android device
Access to the app's settings menu
Both your terminal and ECR system must be on the same network

Step-by-Step Instructions

Open the Viva Terminal app on your device.
Tap on More in the main menu.
Tap on Unlock Settings and enter your PIN.
From the App setting section, select Integrations.

Step 2: Select Viva Peer to Peer

From the Integrations menu, you'll see several integration options. Locate and tap on Viva Peer to Peer from the list.

Step 3: Enable or Disable the Connection

To Enable Peer to Peer:

At the top of the screen, locate the Enable Peer to Peer toggle.
Tap the toggle to turn it ON (it should change color/position to indicate it's active).

To Disable Peer to Peer:

At the top of the screen, locate the Enable Peer to Peer toggle.
Tap the toggle to turn it OFF (it should change color/position to indicate it's inactive).

Step 4: Configure Settings (When Enabled)

Once Peer to Peer is enabled, you'll see additional configuration options:

Operation Mode

Select your preferred operation mode (e.g., Use device as PIN pad).

Set PIN

Create and enter a PIN of your choosing for secure connection.

Server Information

Review the connection details you'll need to connect to the Twine POS system:

Device ID: Your terminal's unique identifier.
Device IP Address: The IP address of your terminal on the network.
Port: The communication port number.

Note

The Viva Terminal app will automatically switch to ECR mode and wait for a Peer to Peer sale request from your connected system.

Troubleshooting

Connection Issues

If you're having trouble connecting:

Verify both devices are on the same network
- Check that your terminal and Twine POS system are connected to the same WiFi or LAN network.
Verify the connection details
- Double-check that you've entered the correct IP Address and Port in your POS system.
- Ensure the Device ID matches.
Restart the connection
- Toggle Peer to Peer OFF, wait a few seconds, then toggle it back ON.
- Restart the Viva Terminal app if needed.

Additional Information

What happens when Peer to Peer is enabled?

Your terminal switches to ECR mode automatically.
The terminal waits for payment requests from your connected cash register or POS system.
All transactions are processed through the Peer to Peer protocol.

What happens when Peer to Peer is disabled?

The terminal returns to standard operation mode.
You can process payments directly through the Viva Terminal app interface.
Twine POS systems will not be able to send payment requests to this terminal.

How to Enable or Disable Peer to Peer Connection in Viva Terminal App