Card terminal devices
Information on our card terminal devices solutions.
- Overview
- Whitelist the Viva Wallet 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 Wallet’s POS terminals via one of the following APIs. Integration allows an application to initiate transactions on a Viva Wallet terminal and get informed on the result.
We constantly update our Viva Wallet 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 Wallet card terminal, we recommend building your integration on the Viva Wallet API.
Whitelist the Viva Wallet addresses
You might need to configure your network settings and whitelist the below domains/IPs in case an ECR integration takes place.
| 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 Wallet card terminals if they have implemented one of the following APIs:
- Viva Wallet API (also supports earlier Cardlink POS integrations)
- Viva Wallet API (also supports earlier Atos-Worldline POS integrations)
- Viva Wallet API (also supports earlier 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 Wallet One | 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:
- REST API
- Migrating from a previous Cardlink integration
- Ready
- Sale Request
- Cancel Request
- Preauth Request
- Abort
- Get Last Receipt
- Set Printing Settings
- Batch Management
- Migrating from a previous Atos-Worldline integration
- Migrating from a previous CCV integration
- AP Concert ECR Integration Protocol
- SDKs
Get Support
If you would like to integrate with Viva Wallet, or if you have any queries about our products and solutions, please see our Get Support page to see how we can help!