---
title: "Preview the Stripe subscription price"
method: POST
path: "/zephr/payment/stripe/create-subscription-previews"
tags: ["Stripe Payments"]
---

# Preview the Stripe subscription price

`POST /zephr/payment/stripe/create-subscription-previews`

## Request

- Base URL: `https://demo-site`
- URL: `https://demo-site/zephr/payment/stripe/create-subscription-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 total price and tax amount that Stripe will charge the customer if they
create a new subscription for the specified plan.

**Note**: This method does not create any entities in Stripe and does not result in any payments being made.

## Request body

- object
  - `product_id` string, required: The ID of the new Zephr product.
  - `plan_id` string, required: The new Stripe price plan ID.
  - `promo_code` string: The Stripe promo code that will be attached to the subscription.
  - `billing_country` string: The user's billing country, for tax calculation purposes.
  - `billing_post_code` string: The user's billing postal code, for tax calculation purposes.

## Response `200`

OK

- object
  - `total` number: The total amount the user will be initially charged for the subscription in the relevant currency's lowest denomination (e.g. pence), i.e. for a monthly subscription, the first month's cost.
  - `sub_total` number: The total amount minus tax for the initial charge in the relevant currency's lowest denomination (e.g. pence).
  - `tax` number: The tax amount for the initial charge in the relevant currency's lowest denomination (e.g. pence).
  - `discount` number: The discount amount for the initial charge in the relevant currency's lowest denomination (e.g. pence).

## Other responses

- `400`: Bad Request

---

[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)