Check the update summary object returned when previewing an update to a subscription or billing for a one-time charge to get an overview of any prorated credits and charges created as a result of the change.
Impact of this subscription change. Includes whether the change results in a charge or credit, and totals for prorated amounts.
Details of any credit adjustments. Paddle creates adjustments against existing transactions when prorating.
Details of the transaction to be created for this update. Paddle creates a transaction to bill for new charges.
Details of the result of credits and charges. Where the total of any credit adjustments is greater than the total charge, the result is a prorated credit; otherwise, the result is a prorated charge.
The response includes
recurring_transaction_details objects, which let you preview any transactions created as a result of your change, as well as the impact on the regular amount that a customer is charged.
Previously, to determine whether a change resulted in a prorated charge or credit, you'd need to add up the totals of any
adjustments and deduct from the total for the
next_transaction total. If the result is negative, the change results in a prorated credit; if positive, a prorated charge.
update_summary object returns totals for prorated credits and charges, along with a
result object that tells you whether the change results in a credit or charge overall. You don't need to do any of your own calculations.
This change is available in version
1 of the Paddle API.
It's a non-breaking change, meaning it doesn't impact existing integrations.