Use these instructions to connect Vektori Kassa running on a different device to Viva.com Terminal via the internet. The payment device can be a payment terminal, a compatible Android phone or an iPhone. First activate Terminal, configure the shop details in Vektori Cloud and select the payment terminal in the POS system.
Vektori Pilvi → Settings → POS → Payment terminal integrations → Viva Rest API Cloud
Before you start
- Make sure both devices have a working internet connection. The devices can be on different networks.
- If necessary, install Viva.com Terminal on a compatible Android phone from Google Play or on an iPhone from the App Store. The application may already be installed on a payment terminal.
- Have your company’s Viva.com and Vektori credentials ready, as well as access to the settings.
- You will need the merchant ID, shop name and shop ID. Instructions for finding them are provided below.
1. Viva.com: prepare the payment terminal and credentials
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 with 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 (payment terminal list).
- 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.
Find the merchant ID
- Sign in to your company’s Viva.com account in a browser.
- Open Settings → API Access (API credentials).
- In the Credentials section at the top of the page, copy your company’s Merchant ID. You will need it in Vektori in the next step.
Viva’s visual guide: finding the merchant ID.
Find the shop name and ID
The shop ID (Source Code) is the four-digit code of the shop, or payment source, in Viva.com. This is different from the company’s merchant ID.
- In Viva.com, open Sales → Physical Payments → Stores. Viva’s instructions also refer to these menus as Sales and Physical Payments.
- Open your shop’s details by clicking the shop name.
- Make a note of the Shop name and Code. The code is the Source Code you need. Keep any leading zeroes.
If the shop does not exist, select Add Store, enter the shop details, select the linked Viva.com account and address, and select Create. Then make a note of the shop name and code.
Viva’s visual guide: adding a shop and linking a payment terminal to the shop.
Link the payment terminal to the correct shop
- Open Viva.com’s list of payment terminals: Sales → In-store Payments → Terminals.
- Find the payment terminal you use and select Edit.
- In the Select source field, select the correct shop and save.
If the options are not visible, ask the Viva account administrator to check your permissions.
2. Vektori Pilvi: add the Viva details
- Sign in to your company’s Vektori Cloud.
- Open Vektori Pilvi → Settings → POS → Payment terminal integrations → Viva Rest API Cloud.
- Enter or check the details below.
| Vektori field | What to enter |
|---|---|
| Merchant ID (Credentials) | Your company’s Viva.com Merchant ID |
| Shops → Shop name | The shop name, preferably the same as in Viva.com |
| Shops → Code | The shop’s four-digit Source Code exactly as shown |
Finally, select Save. If there are several shops, add the other shops using the + Add shop button and save their details.
The merchant ID, shop name and code are required for the payment terminal to appear in the POS system. Also check the merchant ID in the field that has already been populated. POS API Client ID and Client Secret are optional.
3. Vektori Kassa: select the payment terminal
- In the POS system, open Functions → Settings → Payment terminal.
- Select Viva Rest API Cloud.
- Select the correct shop under Shop and the payment terminal belonging to it under Device ID.
- Close the settings.
4. Check that payments work
- Make a test sale at the POS.
- 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 terminal does not appear in the POS system or the payment is not transferred?
- Check the internet connection on both devices.
- In Viva, check that the payment terminal has been activated and linked to the correct shop.
- In Vektori Cloud, check the merchant ID, shop name and shop ID. Check these details even when the integration status is Connected.
- Check the shop and payment terminal selected in the POS system.
If the problem persists, submit a support request to Vektori. State how you are using it, the payment terminal model and at which stage the problem occurs.
Comments
0 comments
Please sign in to leave a comment.