This guide explains how to connect Vektori Kassa running on a separate device and a Viva payment terminal locally using an IP address. The till selection is Viva Local API. Setup is carried out on the payment terminal and the till; no Vektori Cloud integration settings are needed.
Viva Local API is available in the browser-based till and in the Android and iOS applications.
Before you begin
- Have your company’s Viva.com credentials ready and make sure you have access to the Vektori Kassa settings.
- Connect the till and payment terminal to the same local network. The network must allow communication between the devices.
- Make sure both devices have an internet connection and that Viva.com Terminal is installed on the payment terminal. The local connection uses Wi-Fi, Ethernet or a cable supported by the devices.
Recommendation: if necessary, ask your network administrator to assign the payment terminal a permanent IP address or a DHCP reservation. If the address changes, it must also be updated in the till.
1. Viva.com: activate the payment terminal
If the payment terminal has already been activated for your company’s Viva.com account, continue to the next section.
- Open Viva.com Terminal on the payment terminal.
- Activate the application by signing in with your company’s Viva.com credentials, or select activation using a device code.
- If you use a device code, sign in to your Viva.com account in a browser and open the list of payment terminals: Sales → In-store Payments → Terminals (list of payment terminals).
- Select the option to add a new payment terminal and enter the activation code shown on the device.
- Complete the activation on the payment terminal.
Viva’s activation guide (in English).
2. Payment terminal: enable the local network connection
Viva’s name for this connection is Local Terminal API. In the Viva.com Terminal application, the setting is called Viva Peer to Peer.
- Open Viva.com Terminal on the payment terminal.
- Open More → Integrations → Viva Peer to Peer.
- Enable Enable Peer to Peer.
- Select the operating mode for the payment terminal and enter a PIN code when prompted.
- Open Server information and note down the Device IP address, that is, the device’s IP address.
Server information also displays other details. The Vektori Kassa settings only require the Device IP address from this view. When Peer to Peer is enabled, Terminal waits for payment requests from the till in ECR mode.
Viva’s illustrated guide: Viva Peer to Peer (in English).
3. Vektori Kassa: add the payment terminal’s IP address
- In the till, open Functions → Settings → Payment terminal.
- Select Viva Local API.
- Enter only the payment terminal’s IP address in the field.
- Close the settings.
4. Check that payments work
- Make a test sale at the till.
- Select card payment and check that the correct amount appears on the payment terminal.
- Complete the card payment.
- Check that the approved payment result is returned to Vektori and that the sale is completed normally.
Payment is not transferred to the payment terminal?
- Check that the till and payment terminal are on the same local network and that the network allows communication between them.
- Check that Viva Peer to Peer is enabled on the payment terminal.
- Compare the payment terminal’s current IP address with the address saved in the till.
- If the IP address has changed, update the new address in the till’s payment terminal settings.
If the problem continues, submit a support request to Vektori. Tell us how you use the system, the model of the payment terminal and at which stage the problem occurs.
Comments
0 comments
Please sign in to leave a comment.