Use this guide to enable card payments when the Vektori Kassa app and Viva.com Terminal are on the same Android device or iPhone. Payments are transferred from one app to the other on the same device. First activate Terminal, save the merchant ID in Vektori Cloud and select Viva App2App in the till.
When the payment device is separate, use the Viva Cloud setup guide. App2App is available in Android and iOS apps.
Vektori Pilvi → Settings → Till → Payment terminal integrations → Viva App2App
Before you start
- Make sure the device has an internet connection.
- Have your company’s Viva.com and Vektori credentials ready, as well as access to the settings.
- Install Viva.com Terminal on the same compatible device as Vektori Kassa. On an Android phone, use Google Play; on an iPhone, use the App Store. Viva.com Terminal may already be installed on a payment terminal.
1. Viva.com: activate the app and find the merchant ID
Activate Viva.com Terminal
If the app has already been activated for your company’s Viva.com account, continue to finding the merchant ID. Activation is carried out in the same way on Android and iPhone.
- Open Viva.com Terminal on the device.
- Activate the app 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 (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 according to the device’s instructions.
If necessary, see Viva’s activation guide (in English).
Find the merchant ID
- Sign in to your company’s Viva.com account in a browser.
- Open Settings → API Access (Settings → API Access).
- 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 illustrated guide: finding the merchant ID.
2. Vektori Pilvi: save the merchant ID
- Sign in to your company’s Vektori Cloud.
- Open Vektori Pilvi → Settings → Till → Payment terminal integrations → Viva App2App.
- Enter Viva.com’s Merchant ID in the Merchant ID (Credentials) field. Check that the ID is correct even if the field has been pre-filled.
- Select Save.
Your company’s merchant ID is sufficient for App2App. Client ID and Secret are optional. This method works without a separate shop ID, IP address or device pairing.
3. Vektori Kassa: enable the app and payment terminal
Install and open the till
If the till is already in use on this device, continue to Select a payment terminal.
- Android: The till app can be installed automatically on a device managed through Vektori. If the app does not appear, note down the device’s serial number (SN) from the bottom or packaging and contact your Vektori supplier. On an Android phone, install Vektori Kassa from Google Play. On a CS50C device, install it from Google Play; on a SUNMI device, from the SUNMI Store; and on a PAX device, from the PAX Store.
- iPhone: install Vektori Kassa from the App Store on the same iPhone as Viva.com Terminal.
Open the installed Vektori Kassa and sign in to the till according to the sign-in instructions. Select the correct salesperson.
Select a payment terminal
- In the till, open Functions → Settings → Payment terminal.
- Select Viva App2App.
- Close the settings.
The selection and integration settings are the same on Android and iOS.
4. Check that payments work
- Make a test sale at the till.
- Select card payment.
- Check that Viva.com Terminal opens on the same device and displays the correct amount.
- Complete the card payment and check that the approved payment result is returned to Vektori and the sale is completed normally.
Is the payment not transferred to Viva.com Terminal?
- Make sure both apps are on the same device and that you are using the Vektori Kassa app.
- Check the device’s internet connection and the activation of Viva.com Terminal.
- Check the merchant ID in the App2App section of Vektori Cloud.
- Check that Viva App2App has been selected in the till.
If the problem persists, submit a support request to Vektori. State the method being used, the device model and at which stage the problem occurs.
Comments
0 comments
Please sign in to leave a comment.