Tipping support in the Android SDK

This document provides an overview of tipping functionality available when taking card payments through Zettle Payments SDK for Android.

Description of tipping flow in the SDK

The usage of tipping is optional. For each call the requestor can specify if tipping should be part of the payment or not. If tipping is enabled, the payment will return both the total amount and the tipping amount.

Example: Merchant initiates a payment of 150 and tipping is enabled. The card holder decides to give an additional 20 as a tip. The total amount returned from the call would be 170 and the tipping amount would contain 20.

Different tipping styles in the card reader

The process to enter tips in the card reader may vary between markets due to to differences in tipping behaviour. From an integration perspective, there is no difference however. The market specific logic is handled by the SDK and the card reader.

Prerequisites

Please note that the following prerequisites are required to initiate tipping:

  • Tipping is only available on the Zettle reader
  • Usage of SDK version 1.4.0 or later
  • The card reader needs to contain the latest software versions.
  • Tipping needs to be enabled for the market connected to the Zettle account used by the merchant. See the list of supported markets for tipping.

Supported markets for tipping

Tipping will be made available on a market by market basis. The following markets are supported at the moment:

  • United States
  • Sweden
  • Norway
  • Denmark
  • Finland
  • United Kingdom
  • The Netherlands
  • France
  • Germany

Tipping FAQ

How does the tipping feature work in the Zettle SDK and Zettle Reader?

Zettle's tipping function allows customers to add an extra amount to the total sum of their bill (market specific versions: entering total sum or adding an extra amount), and they can do so straight into your card reader. This function only works with a Zettle Reader.

How do I activate the tipping function within the SDK?

Tipping is optional and is enabled on each call to the enableTipping function. Tipping is not supported by all accounts and card readers, so tipping may not be displayed even when tippingStyle is passed on the enableTipping call.

For help activating tipping, see Manage card payments.

Are there any prerequisites for using tipping?

See section prerequisites.

Why are there different flows in the card reader to collect tips?

Tipping methods differ by market. In some markets, users can include the tip in the total amount they enter. In some others, users prefer that the reader prompts them to enter the tip after which they add it. Starting with SDK version 1.36.8, in the US and UK markets, users can add a tip based on a percentage of the total amount.

Total amount tipping flow
Extra amount tipping flow
Percentage tipping flow
Total AmountExtra AmountPercentage

Are the tipping styles configurable?

The tipping style is pre-defined per market and is not configurable.

MarketTipping styleSupporting SDK version
United StatesPercentage tipping1.36.8
Extra Amount1.14.9
United KingdomPercentage tipping1.36.8
Extra Amount1.4.0
SwedenTotal Amount1.4.0
NorwayTotal Amount1.4.0
DenmarkExtra Amount1.4.0
FinlandTotal Amount1.4.0
FranceExtra Amount1.23.1
The NetherlandsTotal Amount1.4.0
GermanyTotal Amount1.4.0

Is there a MAX level for tip?

To avoid accidental or incorrect entries, the system verifies a maximum level that you can enter for the tip. For example, customers may accidentally input their PIN code instead of a tip amount. The maximum limit is 50% for Europe and 100% for the US. If the entered amount exceeds this level, the card reader will display a warning message stating "Too high amount."

Is there a MIN level for tip?

In markets where the tipping style is Total amount, there card holder is required to enter the amount to be charged including tips. If the user enters an amount that is less than the amount entered by the merchant, the card reader will show a “too low amount” warning message.

Is there a need to update the card reader software to use tipping?

Yes, tipping requires a minimum version of the card reader software. It’s highly recommended that merchants upgrade the card reader software prior to accepting payments with tips. The update will take a few minutes to be completed.

The SDK will verify that the correct software is installed on the Zettle card reader when requesting tips. If the card reader software doesn’t support tipping, a message will be displayed asking the merchant to update the card reader software.

Important

  • Make sure that the card reader and your smartphone or tablet are charged before you update the software.
  • Keep the smartphone or tablet close to the card reader during the update.

What happens if a tipping call is made using a Zettle account in a market that doesn’t support tipping?

The payment function will work as before when the tipping flow is not initiated in the card reader.

What are the plans to launch tipping for other Zettle markets?

Tipping is planned to be introduced in more markets. Information about the availability will be announced on Github and via email.