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 settip_split.
Tipping with splits
When you use Split Payout, Dintero calculates thesplits 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 inconfiguration.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, settip_split.fee_split.
Covering the fee for tips must be activated by Dintero. Contact Dintero support to activate it.
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.