Skip to main content

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

Updated over a week ago

Overview

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 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

Step 1: Access the Integrations Menu

  1. Open the Viva Terminal app on your device

  2. Tap on More in the main

  3. Tap on Unlock Setting and put your pin.

  4. From 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:

  1. At the top of the screen, locate the Enable Peer to Peer toggle

  2. Tap the toggle to turn it ON (it should change color/position to indicate it's active)

To Disable Peer to Peer:

  1. At the top of the screen, locate the Enable Peer to Peer toggle

  2. 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 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:

  1. Verify both devices are on the same network

    1. Check that your terminal and TwinePos system are connected to the same WiFi or LAN network

  2. Verify the connection details

    1. Double-check that you've entered the correct IP Address and Port in your POS system

    2. Ensure the Device ID matches

  3. Restart the connection

    1. Toggle Peer to Peer OFF, wait a few seconds, then toggle it back ON

    2. 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

Did this answer your question?