> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# 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](https://developer.paddle.com/api-reference/subscriptions/preview-subscription-charge.md) operation to the Paddle API. You can use it to preview charge totals for a one-time charge before billing it.

{% api-endpoint method="POST" path="/subscriptions/{id}/charge/preview" /%}

## How it works

You can use the [create a one-time charge for a subscription](https://developer.paddle.com/api-reference/subscriptions/create-one-time-charge.md) 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](https://developer.paddle.com/api-reference/subscriptions/preview-subscription.md) 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 a customer in your frontend.

When you're ready, send the same request that you used to preview to the [`/subscriptions/{id}/charge`](https://developer.paddle.com/api-reference/subscriptions/create-one-time-charge.md) 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](https://developer.paddle.com/api-reference/subscriptions/preview-subscription-charge.md) to get started.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| POST Preview a one-time charge for a subscription | API operation | added | Subscriptions |  |