Skip to content

Instantly share code, notes, and snippets.

@tareq3
Last active November 24, 2025 09:57
Show Gist options
  • Select an option

  • Save tareq3/623aebf8312af393ec8fc5b2b7d52eb7 to your computer and use it in GitHub Desktop.

Select an option

Save tareq3/623aebf8312af393ec8fc5b2b7d52eb7 to your computer and use it in GitHub Desktop.
# How to Enable or Disable Peer to Peer Connection in Viva Terminal App
## 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 **UnlockSetting** and put your pin.
4. From **App setting** section, Select **Integrations**
![Main menu showing More option](https://developer.viva.com/images/payment-methods-0.png?width=250px)
---
### 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.
![Locate Via Peer to Peer option](https://developer.viva.com/images/terminal_app_integrations_p2p_01.png?width=250px)
---
### 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**)
**[SCREENSHOT 6: Operation mode selection dropdown]**
#### Set PIN
- Create and enter a PIN of your choosing for secure connection
**[SCREENSHOT 7: PIN entry field]**
#### 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
**[SCREENSHOT 8: Server information section showing Device ID, IP Address, and Port]**
**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**
- Check that your terminal and TwinePos system are connected to the same WiFi or LAN network
2. **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
3. **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
- TwinePos systems will not be able to send payment requests to this terminal
---
For technical support, visit the [Twine Contact & Support](https://developer.twinepos.com/get-support) page.
---
**Document Version**: 1.0
**Last Updated**: November 2025
**Compatible with**: Viva Terminal App (Android)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment