{"title":"Tipping from the POS app","category":"default","creationDate":1681720800,"content":"

Here we describe how to implement tipping in your payment flow where the payment request that you send from your POS app includes a tip amount. The terminal shows the original transaction amount and the tip amount. The customer then uses the terminal to confirm the tip, change the amount, or decline giving a tip.<\/p>\n

Requirements<\/h2>\n

Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nA Terminal API<\/a> with payment terminals.<\/td>\n<\/tr>\n
Hardware<\/strong><\/td>\nAll terminal models are supported, except unattended terminals.<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\nImplement logic in your POS app to provide the tip amount for payment requests.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Set up tipping in your POS app<\/h2>\n

The tip amount to propose to your customer on the terminal can be a percentage of the transaction amount, a fixed amount, one of various fixed amounts depending on the transaction amount, and so on.
\nYou need to implement logic on your end to ensure your POS app provides the tip amount that you need to include in your payment request.<\/p>\n

Make a payment<\/h2>\n

After you configured tipping in your POS system, you are ready to make a payment request that includes a TipAmount<\/code>. This shows the transaction amount and the proposed tip amount on the terminal display.<\/p>\n

    \n
  1. \n

    Make a payment request<\/a>, specifying:<\/p>\n