Android app integration

Information on our Android app integration solution.

• Overview
• Messages
• Callback activity
• Key to card terminal product categories
• Get Support

Overview

Please see below for information on integrating with Viva Wallet’s Android POS app.

Messages

The client app must implement a mechanism to send messages using Android intents and URI calls and to receive the result in a custom URI callback. Overall the following messages are available:

• Sale request originating from the client app to initiate a request for a new Sale transaction.
• Sale response originating from the card terminal app to return the result of a Sale transaction.
• Cancel request originating from the client app to initiate a request for a Cancel transaction.
• Cancel response originating from the card terminal app to return the result of a Cancel transaction.
• Abort request originating from the client app to abort (if possible) the last Sale request.
• Abort response originating from the card terminal app to return the result of an Abort request.
• Printing settings request originating from the client app to change the Printing Settings.
• Printing settings response originating from the Card terminal app to return the result of a Printing settings request.
• Foreground request originating from the client app to bring Card terminal app to foreground.
• Send logs request originating from the client app to trigger the application to upload logs
• Send logs response originating from the card terminal app to return the result of a Send Logs request
• Batch request originating from the client app to open or close a batch.
• Batch response originating from the card terminal app to return the result of a Batch request.
• Set mode request originating from the client app to set the card terminal mode.
• Set mode response originating from the card terminal the result of setting the card terminal mode.
• POS Activation request originating from the client app to trigger the POS activation.
• POS Activation response originating from the card terminal app to return the result of the POS activation request.

Callback activity

The client app must provide a callback activity declare in AndroidManifest.xml, in order to receive the response results.

<activity
          android:name="com.example.URLResponseActivity"
          android:label="Payment Result">
            <intent-filter>
                <action android:name="android.intent.action.VIEW"/>
                <action android:name="com.example.URLResponseActivity"/>
                <category android:name="android.intent.category.DEFAULT"/>
                <category android:name="android.intent.category.BROWSABLE"/>
                <!-- Provide your own scheme here and reference it when you send a message -->
                 <data
                   android:scheme="mycallbackscheme"
                   android:host="result"/>
            </intent-filter>
        </activity>

Key to card terminal product categories

To understand the icons used on the above table, see the below table.

Product category	Terminal models	Icon
Android Card Terminals	Android Card Terminal Ethernet, Android Card Terminal 4G, Mobile Card Terminal Plus, Mobile Card Terminal.
Viva Wallet POS app for Android	Mini Card Reader, Pocket Card Terminal connected via Bluetooth or USB to the Viva Wallet POS app for Android.
Linux Card Terminals	Countertop, IM20, S900, S800, D200.

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!