> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# See the fees that Paddle retains for chargebacks and refunds

Transactions and adjustments now include a field for the fees that Paddle retains for chargebacks and refunds in payout totals.

---

## What's new?

We've added a new `retained_fee` field that you can use to see the fees Paddle retains when processing refunds and chargebacks. This is returned for all payout totals against adjustments and transactions.

- **retained_fee** (string): Paddle fees retained for this adjustment or transaction.. Example: `300`

## How it works

To help you better understand how payout totals are calculated, we've added a `retained_fee` field to the `payout_totals` and `adjusted_payout_totals` objects for [transactions](https://developer.paddle.com/api-reference/transactions/overview.md) and [adjustments](https://developer.paddle.com/api-reference/adjustments/overview.md). This field shows the Paddle fees retained for the transaction or adjustment.

Learn more about how fees are calculated for chargebacks and refunds in the Paddle.com seller handbook.

[Learn more](https://www.paddle.com/seller-guides/seller-handbook)

You can use the `retained_fee` field alongside the `fee` and `chargeback_fee` fields to understand how much Paddle retains for a transaction or adjustment.

`retained_fee` and `balance_currency_retained_fee` are available as new column headings in the [adjustments report](https://developer.paddle.com/build/finance/generate-reports.md), too.

## Next steps

This change is available now in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can work with [adjustments](https://developer.paddle.com/api-reference/adjustments/overview.md) or [transactions](https://developer.paddle.com/api-reference/transactions/overview.md) using the API to see the new field.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `totals.retained_fee` | Field | added | Adjustment |  |
| `payout_totals.retained_fee` | Field | added | Adjustment |  |
| `details.adjusted_totals.retained_fee` | Field | added | Transaction |  |
| `details.adjusted_payout_totals.retained_fee` | Field | added | Transaction |  |