What's new?
We updated details.payout_totals and details.adjusted_payout_totals objects against transactions to include details about the Paddle fee rate and exchange rate applied to a payout for a transaction.
Breakdown of the payout total for a completed transaction.
Currency exchange rate, including margin if applicable. 1.0 if the transaction currency matches your payout currency
Paddle fee rate that was applied to this transaction.
Breakdown of the payout total for a transaction after adjustments.
Currency exchange rate, including margin if applicable. 1.0 if the transaction currency matches your payout currency
How it works
details.payout_totals and details.adjusted_payout_totals give you a breakdown of the payout total for a completed transaction.
To help you better understand how a payout total is calculated, we've added an exchange_rate field to the payout_totals and adjusted_payout_totals objects. This field shows the exchange rate applied to the payout total, including margin if applicable.
We also added a fee_rate field to the payout_totals object. This field shows the Paddle fee rate that was applied.
You can learn more about Paddle fees on the help center.
Next steps
This change is available in version 1 of the Paddle API.
It's a non-breaking change, meaning it doesn't impact existing integrations.
You can list transactions using the API to see the new fields.
Summary of changes
| Entity | Field | Change | Type |
|---|---|---|---|
| transaction | details.payout_totals.exchange_rate | + Added | Field |
| transaction | details.adjusted_payout_totals.exchange_rate | + Added | Field |
| transaction | details.payout_totals.fee_rate | + Added | Field |