Payment Terminal API
Information on our card terminal devices solutions.
- Overview
- Whitelist the Viva addresses
- Third-party card terminal providers
- Card terminals thermal paper dimensions
- Further Information
- Get Support
Overview
Minimise customer serving times by integrating a cash register or ordering application with one of Viva’s POS terminals via one of the following APIs. Integration allows an application to initiate transactions on a Viva terminal and get informed on the result.
We constantly update our Viva POS terminals to support communication based on additional third-party card terminal APIs
If you need to start from scratch with integrating your existing card register or ordering application with a Viva card terminal, we recommend building your integration on the Viva API.
Whitelist the Viva addresses
You might need to configure your network settings and whitelist the below domains/IPs for integrations with Viva.com.
| No | Protocol Type | Target Device | Destination Port |
|---|---|---|---|
| 1. | tcp/udp | DNS Server | 53 |
| 2. | tcp | 23.97.152.28 | 8580 |
| 8680 | |||
| 3. | https | *.vivapayments.com | 443 |
| *.vivawallet.com | |||
| *.crashlytics.com | |||
| *.fabric.io | |||
| *.amazonaws.com | |||
| *.qq.com | |||
| *.edgekey.net | |||
| *.akamaiedge.net | |||
| *.pool.ntp.org | |||
| *.googleapis.com | |||
| https://portal.ext.payconiq.com | |||
| https://portal.payconiq.com | |||
| https://pay.playground.klarna.com | |||
| https://pay.klarna.com | |||
| *.whatspos.com | |||
| 3000 | |||
| *.izatcloud.net | 80 | ||
| The displayed domains/hosts may have CNAME records that point to additional domains (for instance amazon or akamai domains). If the firewall solution requires detailed URL ACLs based not only on the initial host but also on the intermediate DNS records, then the client may need to make additions to the domains allowed. | |||
Third-party card terminal providers
Cash registers or ordering applications that support other existing payment providers’ card terminals can also work with Viva card terminals if they have implemented one of the following APIs:
- Viva API (Cardlink POS integrations)
- Viva API (Atos-Worldline POS integrations)
- Viva API (CCV POS integrations)
- AP Concert ECR Integration Protocol
- Ciontek CS30 SDK
Card terminals thermal paper dimensions
Not all terminal devices use thermal paper (or thermal printing tape) of the same dimensions. Please see the table below:
| Card terminal model | Paper width | Paper diameter |
|---|---|---|
| Viva Contactless Terminal powered by Google Play | 58mm | 40mm |
| A920 Pro, A920, A910 | 58mm | 40mm |
| A80 | 58mm | 50mm |
| S900 | 58mm | 40mm |
| S800 | 58mm | 50mm |
Further Information
Please see our child pages for further information on our device-based solutions:
- Cloud Terminal API
- Local Terminal API
- ECR Protocol
- Ready
- Sale Request
- Preauth Request
- Cancel Request
- Abort
- Batch Management
- Get Last Receipt
- Reprint
- Set Printing Settings
- AP Concert Protocol
Get Support
If you would like to integrate with Viva, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!