Card terminal apps
Information on our card terminal apps solutions.
Viva Wallet offers POS terminal apps for the two main OS platforms for mobile devices (Android/iOS). This POS app is able to receive requests for initiating transactions from third-party apps installed on the same mobile device.
Android app integration
The Viva Wallet POS app for Android can receive requests for initiating transactions from third-party apps installed on the same Android mobile device. Communication with the card terminal app is done by using Android intents. The client app creates an intent with parameters and starts the card terminal app’s pay activity. When the card terminal app’s pay activity finishes it returns the result to the caller app.
A sample app is also available for download from our public GitHub account. It demonstrates the inter-app communication ability and contains all the necessary Gradle build files.
App specs for Android POS terminals
To successfully upload an Android APK to the Viva Wallet PAX Store and distribute and update it to PAX Paydroid terminals, check the following two areas first. Provide the app and release information (1) and ensure the app can operate with restrictions (2). The final signing, uploading, and distribution of the app will be completed by Viva Wallet.
1. Android app and release information
The below requirements are similar to those of the Google Play Store:
- The unique package name in the store
- Signed APK*
- In each new release the version must be increased following the semantic versioning, e.g. 1.2.9 -> 1.3.0 -> 1.3.3
- In each new release the version code must be increased, e.g. 100 -> 110 -> 300
- A name, short description, and a description
- An icon
- 3 screenshots of the app
- Release notes
* To publish an APK on Google Play Store, any developer can choose to have the signature keypair stored by Google in its systems, linked to the developer account; or to have a local keystore file containing signature public and private key. To publish an APK on Viva Wallet PAX Store, the suggested method is to use a local keystore, and let Android Studio sign the APK. All the APK versions should be signed by the same developer signature.
2. PAX Android terminal restrictions
- Google Services are not available on the terminals
- Chrome or any other web browser are not available on the terminals
- Minimum support Android OS >= 5.1
iOS app integration
The Viva Wallet POS App for iOS can receive requests for initiating transactions from third-party apps installed on the same iOS mobile device. Communication with the VW POS App is done through the use of URL schemes and by implementing UIApplicationDelegate ’s instance method application(_:open:options:) on the AppDelegate file of the client’s app project. The client app should create an URL scheme using specific parameters that will initiate the VW POS App’s pay activity. When the VW POS App’s pay activity finishes it returns the transaction result to the caller app..
A sample app is also available for download from our public GitHub account. It demonstrates the inter-app communication ability and contains all necessary info.
Please see our child pages for further information on our app-based solutions:
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!