Get Printing Settings request
An overview of the Get Printing Settings request message for Android.
- Overview
- Get Printing Settings request
- Get Printing Settings response
- Key to card terminal product categories
- Get Support
Overview
👉 The Get Printing Settings request is used to retrieve the current configuration of the printing-related settings of the POS application.
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.
- Get Printing Settings request originating from the client app to get the Printing Settings of the POS application.
- Get Printing Settings response originating from the Card terminal app to return the result of the Get Printing settings request.
Get Printing Settings request
For a typical Get Printing Settings request, the client app must provide the following information:
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=getPrintingSettings"
+ "&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);
Get Printing Settings response
After executing the get printing settings request, the Card Terminal App responds with the details of printing settings.
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 get printing settings response looks as follows:
mycallbackscheme://result?status=success&message=Printing settings updated&action=get_printing_settings&businessDescriptionType=businessName&printLogoOnMerchantReceipt=false&printVATOnMerchantReceipt=false&isBarcodeEnabled=false&businessDescriptionEnabled=false&printAddressOnReceipt=false&isMerchantReceiptEnabled=false&isCustomerReceiptEnabled=false
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 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!