Android app integration

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.
• 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 in the every request/response, 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	Tap on Phone, Viva Wallet One terminal. Mini Card Reader, Pocket Card Terminal connected via Bluetooth or USB to the Viva Wallet POS app for Android.

Get Support

If you have any questions about our solutions, or questions about how to integrate with our solutions, please refer to our Get Support page.