See the exchange rate and Paddle fee rate for payouts
Transactions now include the exchange rate and Paddle fee rate for payout totals.
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.
Summary of changes
This is a summary of the changes to fields in the Paddle API:
| Entity | Field | Change |
|---|---|---|
transaction | details.payout_totals.exchange_rate | New field |
transaction | details.adjusted_payout_totals.exchange_rate | New field |
transaction | details.payout_totals.fee_rate | New field |
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.