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.
300 Paddle fees retained for this adjustment or transaction.
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 and adjustments. 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.
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, 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 or transactions using the API to see the new field.
Summary of changes
| Entity | Field | Change | Type |
|---|---|---|---|
| Adjustment | totals.retained_fee | + Added | Field |
| Adjustment | payout_totals.retained_fee | + Added | Field |
| Transaction | details.adjusted_totals.retained_fee | + Added | Field |
| Transaction | details.adjusted_payout_totals.retained_fee | + Added | Field |