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 MPTransactionProcessTippingStepParameters with tippingAmountParametersWithOptionalsBlock and use them to create the MPTransactionProcessParameters. Then pass them along as processParameters to createTransactionViewControllerWithTransactionParameters:

MPTransactionProcessTippingStepParameters *params =
	[MPTransactionProcessTippingStepParameters tippingAmountParametersWithOptionalsBlock:
		^(id<MPTransactionProcessTippingAmountStepParametersOptionals>  _Nonnull optionals)
		{
			[optionals setShowConfirmationScreen:YES];
			[optionals setFormatWithIntegerDigits:6 fractionDigits:2];
		}];


MPTransactionProcessParameters *pp =
	[MPTransactionProcessParameters parametersWithSteps:
		^(id<MPTransactionProcessParametersSteps> steps)
		{
			[steps setTippingStepParameters:params];
		}];


UIViewController *viewController =
	[ui createTransactionViewControllerWithTransactionParameters:tp
											   processParameters:pp
													   completed:/*...*/];

Ask for the total amount


In order to ask the shopper to enter the total amount (including a potential tip), create MPTransactionProcessTippingStepParameters with tippingTotaltParametersWithOptionalsBlock and use them to create the MPTransactionProcessParameters. Then pass them along as processParameters to createTransactionViewControllerWithTransactionParameters:

MPTransactionProcessTippingStepParameters *params =
	[MPTransactionProcessTippingStepParameters tippingTotaltParametersWithOptionalsBlock:
		^(id<MPTransactionProcessTippingTotalStepParametersOptionals>  _Nonnull optionals)
		{
			[optionals setShowConfirmationScreen:NO];
			[optionals setFormatWithIntegerDigits:6 fractionDigits:2];
		}];
    
    
MPTransactionProcessParameters *pp =
	[MPTransactionProcessParameters parametersWithSteps:
		^(id<MPTransactionProcessParametersSteps> steps)
		{
			[steps setTippingStepParameters:params];
		}];
         
UIViewController *viewController =
	[ui createTransactionViewControllerWithTransactionParameters:tp
											   processParameters:pp
													   completed:/*...*/];

Get the tip amount

After the transaction has been completed, you can access the included tip amount via the details.includedTipAmount property of the MPTransaction object that you receive as part of the completed block:

NSLog(@"Included Tip: %@",transaction.details.includedTipAmount);

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)
    .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)
	.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);

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());

Can we help you?

If you cannot find your answer, contact us and we'll get in touch with you soon.

© Copyright 2017 Payworks GmbH. Legal.