The Prices API adds new features and flexibility to how you charge customers. This new integration offers:
- More unified modeling for Checkout items—instead of plans, SKUs, and inline line items, every item is now a price.
- The ability to render product images for recurring items.
For the client and server integration, the Prices API unlocks the ability to:
- Create a reusable product and price catalog instead of one-time line items
- Create inline pricing for subscriptions
- Apply dynamic tax rates to subscriptions and one-time payments
Don’t want to migrate? You can continue to use your current integration, but new features are not supported. Any new plans or recurring prices you create can be used in the
plan parameter of your existing API calls.
Products and prices overview
Prices are a new, core entity within Stripe that works with subscriptions, invoices, and Checkout. Each price is tied to a single Product, and each product can have multiple prices. Different physical goods or levels of service should be represented by products. Pricing of that product should be represented by prices.
Prices define the base price, currency, and—for recurring products—the billing cycle. This allows you to change and add prices without needing to change the details of what you offer. For example, you might have a single “gold” product that has prices for 10 USD/month, 100 USD/year, 9 EUR/month, and 90 EUR/year. Or you might have a blue t-shirt with 20 USD and 15 EUR prices.
Response object changes
Instead of listing items with
display_items, the Checkout Session object uses
line_items field does not render by default as
display_items did, but you can include it using expand when creating a Checkout Session:
line_items is includable, the
checkout.session.completed webhook response no longer list items by default. The smaller response object enables you to receive your Checkout webhooks faster. You can retrieve items with the new
For more details, see fulfilling orders with Checkout.