Tipping

When a customer adds a tip to their payment, it is booked to your liable account by default. However, you can book the entire tip amount directly to your user's balance account by providing an additional split item in the payment request.

You can only book the tip to your user's balance account when you use one of the following methods of tipping:

• Tipping from the POS app
• Tipping from the terminal

Book the tip to your user

1. When splitting a payment, add a split item for the tip.

   When adding a new split item, always include this in the total number of split items specified in the split.nrOfItems field.

2. For the split item of the tip, specify:

   Key	Description	Example
   split.item[ITEM_NUMBER].type	The type of split. Set this to Tip.	split.item3.type=Tip
   split.item[ITEM_NUMBER].account	Account that will receive the tip. This is the balanceAccountID of one of your user's balance accounts. You cannot split the tip between multiple balance accounts.	split.item3.account=BA00000000000000000000001
   split.item[ITEM_NUMBER].reference	Your reference for the tip, reflected in the Balance Platform Accounting Report.	split.item3.reference=reference_tip
   split.item[ITEM_NUMBER].description	Your description for the tip, reflected in the Balance Platform Accounting Report.	split.item3.description=description_tip

   You do not need to include the tip amount in the split.totalAmount or split.item[ITEM_NUMBER].amount fields, since the tip amount may not be known when creating the payment request.

For example, a payment of EUR 630.00 is split into:

• EUR 600.00 to be paid to your user's first balance account as the sale amount.
• The payment fee to be booked to your user's first balance account. This will be deducted from the sale amount.
• EUR 10.00 to be paid to your user's first balance account as the tip.
• EUR 20.00 to be paid to your liable account as your platform's commission.

In this case, set the split.nrOfItems to 4 and split.totalAmount to 62000 (the amounts for the tip and the payment fee are not known when sending the payment request).

The following tabs show how to book the tip to your user's balance account when the customer tips from the POS app and from the terminal.