Skip to main content

Enable Tipping

Configure the terminal to prompt customers for tips during payment. Once enabled, a tipping screen appears before every transaction.

Prerequisites​

  • Understand EPOS communication
  • Access to the Terminal Management System (TMS)
  • Terminal connected to the internet

Steps​

  1. Open the Terminal Management System (TMS) at paxemea.whatspos.com.
  2. Navigate to your terminal's configuration.
  3. Go to the Plugin tab.
  4. In the tipping plugin field, enter:
com.paynt.tipping_plugin
  1. Click Next and then Activate to push the configuration.

How It Works​

After enabling tipping:

  1. Your EPOS sends a sale request as normal.
  2. The terminal displays the tipping screen before the payment screen.
  3. The customer selects a tip amount or skips.
  4. The terminal processes the total (sale + tip).
  5. The transaction response includes the tip amount.

Tipping Screen​

The tipping screen allows customers to:

  • Select a preset tip percentage
  • Enter a custom tip amount
  • Skip tipping entirely

Transaction Response with Tip​

When tipping is enabled, the transaction status includes additional fields:

{
    "transApproved": true,
    "transAmount": 100,
    "gratuity": 15,
    "gratuityFee": 25,
    "totalAmount": 140,
    ...
}
FieldDescription
transAmountOriginal sale amount
gratuityTip amount added by customer
gratuityFeeService fee (if configured)
totalAmountFinal charged amount

Disabling Tipping​

To disable tipping:

  1. Open TMS and navigate to your terminal.
  2. Go to the Plugin tab.
  3. Turn off the TIP toggle.
  4. Push the configuration.