Foreground request
An overview of the Foreground request message for Android.
Overview
👉 The Foreground request is used to bring to the Viva Terminal App to the foreground when desired.
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.
- Foreground request originating from the client app to bring Card terminal app to foreground.
Foreground request
For a typical Foreground request, the client app must provide the following information:
This action does not send back a response.
The above information elements must create a URI call, i.e.
String reqStr = "vivapayclient://pay/v1"
+ "?merchantKey="MY_MERCHANT_KEY"
+ "&appId=com.example.myapp"
+ "&action=foreground"
+ "&callback=mycallbackscheme://result";
Intent payIntent = new Intent(Intent.ACTION_VIEW, Uri.parse( reqStr));
payIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
payIntent.addFlags(Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
startActivity(payIntent);
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 Terminal App for Android | Mini Card Reader, Pocket Card Terminal connected via Bluetooth or USB to the Viva Terminal 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 Contact & Support page to see how we can help!