See adjusted totals for transactions more easily

What's new?

We added two new objects to transaction.details to make it easier to work with adjustments.

These objects complement the existing transaction.details.totals and transaction.details.payout_totals objects. They show how the transaction totals and payout totals are impacted by any adjustments.

How it works

Paddle returns details.totals and details.payout_totals for transactions. However, these objects aren't impacted by adjustments.

This made it difficult to see how much a transaction is for and what you earned. You'd need to use the include parameter to return adjustments, then sum transaction.adjustments[].totals.total, then deduct this from the transaction totals.

The new objects return adjusted totals without the need to include adjustments or do any of your own calculations.

Examples

77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
77          "tax_rate": "0.08875",
78          "totals": {
79            "subtotal": "40000",
80            "discount": "0",
81            "tax": "3549",
82            "total": "43549"
83          }
84        }
85      ],
86      "totals": {
87        "subtotal": "40000",
88        "tax": "3549",
89        "discount": "0",
90        "total": "43549",
91        "grand_total": "12567",
92        "fee": "2227",
93        "credit": "30982",
94        "balance": "0",
95        "earnings": "37773",
96        "currency_code": "USD"

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 or get a transaction using the API to see the new objects.

Learn more