> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipping

> Let customers add a tip on Dintero payment terminals and control which payout destinations receive the tip with tip_split.

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](https://docs.dintero.com/docs/checkout/in-person/terminal-onboarding.md).
* Tipping enabled for the store or terminal.

## Enable tipping

Tipping is currently not self-service. [Contact Dintero support](mailto:support@dintero.com) 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](https://docs.dintero.com/docs/checkout/split-payment/split-overview.md), 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](https://docs.dintero.com/docs/checkout/in-person/creating-terminal-session.md). You can only set it on the session, not on the payment profile.

```json lines highlight={10-17} theme={null}
{
  "configuration": {
    "channel": "in_store",
    "publish": [
      {
        "channel": "push",
        "type": "terminal"
      }
    ],
    "payout": {
      "tip_split": {
        "destinations": [
          { "payout_destination_id": "seller-1", "percentage": 70 },
          { "payout_destination_id": "seller-2", "percentage": 30 }
        ]
      }
    }
  }
}
```

| Field | Required | Description |
| - | - | - |
| `tip_split.destinations` | Yes | The payout destinations that receive the tip. At least one. |
| `tip_split.destinations[].payout_destination_id` | Yes | The payout destination that receives a share of the tip. |
| `tip_split.destinations[].percentage` | Yes | The share of the tip, as a whole number from 1 to 100. The percentages must add up to 100. |
| `tip_split.fee_split` | No | How the payment fee for the tip is shared. See [Cover the payment fee for tips](#cover-the-payment-fee-for-tips). |

See [`POST /sessions-profile`](https://docs.dintero.com/api-reference/session/checkout_session_profile_post) 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`.

> [!NOTE]
>
> Covering the fee for tips must be activated by Dintero. [Contact Dintero support](mailto:support@dintero.com) 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.

```json lines highlight={8-11} theme={null}
{
  "configuration": {
    "payout": {
      "tip_split": {
        "destinations": [
          { "payout_destination_id": "seller-1", "percentage": 60 },
          { "payout_destination_id": "seller-2", "percentage": 40 }
        ],
        "fee_split": {
          "type": "equal_fee_only",
          "destinations": ["seller-3"]
        }
      }
    }
  }
}
```

| `fee_split.type` | Who pays the fee for the tip |
| - | - |
| `proportional` | The destinations in `fee_split.destinations`, weighted by their share of the tip. Every destination must also be in `tip_split.destinations`. |
| `equal_fee_only` | The destinations in `fee_split.destinations`, shared equally. The destinations must not be in `tip_split.destinations`. |

## Tips in settlement reports

Settlement reports show the tip amount for each transaction, in addition to including it in the captured amount. See [Tips](https://docs.dintero.com/docs/checkout/payout-reports-dintero-reports.md#tips) in the settlement report formats.

Example reports with tipping:

| Format | Example |
| - | - |
| PDF | [PDF](https://docs.dintero.com/assets/payout-report-examples/tipping/example_settlement.pdf) |
| XML | [XML](https://docs.dintero.com/assets/payout-report-examples/tipping/example_settlement.xml) - [XSD](https://docs.dintero.com/assets/payout-report-examples/tipping/dintero-settlement-1.0.xsd) |
| CSV | [CSV](https://docs.dintero.com/assets/payout-report-examples/tipping/example_settlement.csv) |
| JSON | [JSON](https://docs.dintero.com/assets/payout-report-examples/tipping/example_settlement.json) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.