Preview a one-time charge for a subscription
POST {{baseUrl}}/subscriptions/:subscription_id/charge/preview
Previews creating a one-time charge for a subscription without billing that charge. Typically used for previewing calculations before making changes to a subscription.
One-time charges are non-recurring items. These are price entities where the billing_cycle
is null
.
If successful, your response includes immediate_transaction
, next_transaction
, and recurring_transaction_details
so you can see expected transactions for the changes.
Request Body
{"effective_from"=>"<string>", "items"=>[{"quantity"=>"<integer>", "price_id"=>"<string>"}, {"quantity"=>"<integer>", "price_id"=>"<string>"}], "on_payment_failure"=>"prevent_change"}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |