Preview charge totals before billing one-time charges to a subscription
Present charge totals to a customer before billing a one-time charge to a subscription using the new preview a one-time charge for a subscription operation.
What's new?
We added the preview a one-time charge for a subscription operation to the Paddle API. You can use it to preview charge totals for a one-time charge before billing it.
How it works
You can use the create a one-time charge for a subscription operation to bill non-recurring prices to a subscription. It's typically used for one-off items, like setup or onboarding fees or support incident charges. You can choose to bill one-time charges now, or bill for them on the next renewal.
Send a request to the new /subscriptions/{id}/charge/preview endpoint to preview billing a one-time charge to a subscription. It works similarly to the preview an update to a subscription operation, accepting an array of objects where each object contains a price ID and quantity.
The response contains immediate_transaction and next_transaction objects that you can use to get charging information to present to your customer in your frontend.
When you're ready, send the same request that you used to preview to the /subscriptions/{id}/charge endpoint to bill for it.
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.
Check out the preview a one-time charge for a subscription operation docs to get started.
