Add a tip

POSLink can support tipping on the card machine and ePOS.

In addition to the merchant enabling tipping on your ePOS, they will also need to enable tipping on the card machine via the manage feature settings menu.

Handling tips in payment requests

Tips are handled as a number in minor units in a new field, separate from the amount. HUF is the exception: it is currently treated without minor units, so a 500 Ft tip is 500, not 50000.

The requested_amount object will contain the amount field and the tip field separately. In the below scenario, the amount field represents the total amount to be paid, including the tip amount. The tip field is optional in the payment request, and defaults to 0 in the payment response.

Example: $2.00 tip, $10.00 basket, $12.00 total.

{
  ...
  "requested_amount": {
    "currency": "USD",
    "amount": 1000
  }
  ...
}

{
  ...
  "requested_amount": {
    "currency": "USD",
    "amount": 1200,
    "tip": 200
  }
  ...
}

{
  ...
  "requested_amount": {
    "currency": "USD",
    "amount": 1200,
    "tip": 200
  }
  ...
}

{
  ...
  "requested_amount": {
    "currency": "USD",
    "amount": 1200,
    "tip": 200
  }
  ...
}

Card Machine tip logic

We have introduced logic on the card machine to ensure the merchant doesn't prompt the customer twice for tips.

Tip experience

Tip on card machine

Tip on ePOS