---
title: "Preview the Stripe subscription change"
method: POST
path: "/zephr/payment/stripe/subscription/{subscriptionId}/change-previews"
tags: ["Stripe Payments"]
---

# Preview the Stripe subscription change

`POST /zephr/payment/stripe/subscription/{subscriptionId}/change-previews`

## Request

- Base URL: `https://demo-site`
- URL: `https://demo-site/zephr/payment/stripe/subscription/{subscriptionId}/change-previews`
- Auth: one of:
  - API key in cookie `blaize_session`
  - API key in query parameter `jwt`
  - API key in header `x-blaize-jwt`
  - API key in header `x-zephr-jwt`
  - HTTP bearer
  - API key in cookie `blaize_jwt`

Generates a preview of the invoice that Stripe will create for the customer if their
subscription is changed to a new plan. The invoice will be a prorated invoice for the
price difference between current and new subscription plans for the remainder of the current billing period.
The invoice will be billed immediately upon changing subscription.
The invoice amount may be negative if the customer is changing to a lower-priced plan.

**Note**: This method does not modify the user's subscription.

## Path parameters

- `subscriptionId` string, required

## Request body

- object
  - `plan_id` string, required: The new Stripe price plan ID.

## Response `200`

OK

- object
  - `total` number: The total amount of the prorate invoice in the relevant currency's lowest denomination (e.g. pence).
  - `sub_total` number: The total amount of the prorate invoice minus tax in the relevant currency's lowest denomination (e.g. pence).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/zuora/apis/zuora-2.md) - [All operations](https://skmtc.dev/zuora/apis/zuora-2/llms.txt) - [OpenAPI document](https://skmtc.dev/zuora/apis/zuora-2/revisions/678190d04c40?raw)