Ask for a tip on the card reader

On-Reader Tipping makes it really easy for your merchants to collect tips from their guests:
At the beginning of each transaction, the guest can be asked whether he wants to give a tip and then can enter the tip amount right on the card reader. You can also ask the guest to enter the total amount for the transaction including a potential tip!

Get in touch with your account manager to activate this feature on the LIVE system.

Please be aware that On-Reader Tipping is currently only available on the Miura card readers.

Ask for the tip amount

In order to ask the shopper to enter the tip amount, create TippingProcessStepParameters with askForTipAmount() and use them to create the TransactionProcessParameters. Then pass along the process parameters to createTransactionIntent:

TippingProcessStepParameters steps = new TippingProcessStepParameters.Builder()
	.askForTipAmount()
	.showConfirmationScreen(true) //deprecated way to enable add tip screen
    .showAddTipConfirmationScreen(true) //new way of enabling add tip screen
    .showTotalAmountConfirmationScreen(true) //enable the total amount confirmation screen 
    .maxTipAmount(new BigDecimal(2.0)) // enables the maximum acceptable tip amount check 
	.numberFormat(6, 2).build();

TransactionProcessParameters transactionProcessParameters = new TransactionProcessParameters.Builder()
	.addStep(steps)
	.build();

Intent intent = MposUi.getInitializedInstance().createTransactionIntent(params, transactionProcessParameters);
startActivityForResult(intent, MposUi.REQUEST_CODE_PAYMENT);

Ask for the total amount

In order to ask the shopper to enter the total amount (including a potential tip), create TippingProcessStepParameters with askForTotalAmount() and use them to create the TransactionProcessParameters. Then pass along the process parameters to createTransactionIntent:

TippingProcessStepParameters steps = new TippingProcessStepParameters.Builder()
	.askForTotalAmount()
	.showConfirmationScreen(false) //deprecated way to disable add tip screen
    .showAddTipConfirmationScreen(false) //new way of disabling add tip screen
    .showTotalAmountConfirmationScreen(true) //enable the total amount confirmation screen
    .maxTipAmount(new BigDecimal(2.0)) // enables the maximum acceptable tip amount check 
	.numberFormat(6, 2).build();

TransactionProcessParameters transactionProcessParameters = new TransactionProcessParameters.Builder()
	.addStep(steps)
	.build();

Intent intent = MposUi.getInitializedInstance().createTransactionIntent(params, transactionProcessParameters);
startActivityForResult(intent, MposUi.REQUEST_CODE_PAYMENT);

Both askForTipAmount() and askForTotalAmount() tipping strategies benefit from reader screen configuration when performing the transaction; while showAddTipConfirmationScreen() is used for the first confirmation screen that pops up, showTotalAmountConfirmationScreen() is managing the second confirmation screen that appears when confirming the total amount of the transaction. The screen configuring properties are optional and by default the add tip configuration screen is enabled and the total amount tip configuration screen is disabled. The maxTipAmount() is also optional, and when set is defining the upper limit for tip amounts above which shopper will be asked to enter a lower amount.

For both tipping strategies, the showConfirmationScreen() method that configures the first confirmation screen for tipping has been deprecated; instead, you can use showAddTipConfirmationScreen().

Get the included tip amount

You can access the included tip amount via the getDetails().getIncludedTipAmount() method of the Transaction object:

System.out.println("Included Tip: " + transaction.getDetails().getIncludedTipAmount());