An overview of the Reset request message for Android.
👉 The Reset request is used to perform either a soft or full reset of the Viva Terminal App.
The two types of reset (‘soft’ and ‘full’) differ as follows:
- A ‘soft’ reset (or ‘settings’ reset) will reset the app settings to their defaults without erasing your previously entered account information
- A ‘full’ Reset will reset the app settings to their defaults, erasing your previously entered account information
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.
- Reset request originating from client app to reset the Viva Terminal App.
- Reset response originating from card terminal app to return the result of the Reset request.
For a typical Reset request, the client app must provide the following information:
The above information elements must create a URI call, i.e.
Intent payIntent = new Intent(Intent.ACTION_VIEW, Uri.parse("vivapayclient://pay/v1" + "?merchantKey=MY_MERCHANT_KEY" + "&appId=com.example.myapp" + "&action=reset" + "&softReset=true" + "&callback=mycallbackscheme://result")); payIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); payIntent.addFlags(Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS); startActivity(payIntent);
After executing a Reset request, the Card Terminal App responds with a response result to indicate if the Reset request has been successful or not.
The result is received as a URI in the callback activity intent:
Uri result = getIntent().getData();
The table below summarises the contents of an approved response.
A Reset response result looks as follows:
mycallbackscheme://result?action=reset&message=Full reset successfully completed!&status=success`
Key to card terminal product categories
To understand the icons used on the above tables, 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.|
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!