Skip to main content
Customers can add a tip on the terminal when they pay. The terminal adds the tip to the order as an item with type: tip. You control which payout destinations receive the tip when you create the session.

Prerequisites

  • A store and terminal set up as described in Terminal onboarding.
  • Tipping enabled for the store or terminal.

Enable tipping

Tipping is currently not self-service. Contact Dintero support to enable tipping for terminals. We support customers choosing percentages (for example, 5%, 10%, or 15%) or typing a custom amount. Tell us which configuration you want and which terminals or stores should have tipping enabled.

Tipping without splits

If the session has no splits, the whole tip goes to the session’s payout destination. You do not need to set tip_split.

Tipping with splits

When you use Split Payout, Dintero calculates the splits of the tip item for you.
  • Without tip_split: the tip is split proportionally across the split destinations of the other order items, weighted by each destination’s split amount.
  • With tip_split: the tip is split between the destinations and percentages you set in configuration.payout.tip_split.

Configure tip_split

Set configuration.payout.tip_split when you create the terminal session. You can only set it on the session, not on the payment profile.
See POST /sessions-profile for the full schema.

Cover the payment fee for tips

By default, the payment fee for the tip is shared by the destinations that receive the tip. If you want to cover the fee yourself, so the tip destinations receive the full tip, set tip_split.fee_split.
Covering the fee for tips must be activated by Dintero. Contact Dintero support to activate it.
Set fee_split.type to equal_fee_only and add the payout destination that pays the fee to fee_split.destinations. These destinations must not be in tip_split.destinations. They receive no part of the tip, only the fee.

Tips in settlement reports

Settlement reports show the tip amount for each transaction, in addition to including it in the captured amount. See Tips in the settlement report formats. Example reports with tipping:
Last modified on November 17, 2026