While you are not required to update your integration, we recommend that you upgrade to use the Prices API with Checkout so that you can take advantage of the following:
You’ll be able to render images with subscriptions in Checkout!
Products and prices are the unified way to model items in Stripe moving forward. You can use them across Subscriptions and Invoices. As Checkout adds new features (coupons, taxes, and beyond), it will have first-class support with Prices.
Instead of moving between various objects depending on how you integrate, Prices work with any Checkout integration:
|server||one-time||dynamic line item||Price, dynamic Price|
|server||recurring||Plan||Price, dynamic Price|
Check out our migration guide for details on how to update your integration.
No, everything is backwards compatible. You can continue to use your old integration, and use Prices in place of Plans in the old integration flows.
Currently, no. You must first at least create a Product, then create a Price on top of it or use
price_data on Checkout Session creation. You can continue to use the old integration if you prefer, but you cannot combine the ad-hoc line items with Prices.
modeif I have one time and recurring items?
mode=subscription if you are creating a Checkout Session with both recurring and one-time items. Use
mode=payment if there are only one-time items.
Yes. The following combinations are possible:
|Integration type||API type||Objects||Allow input?||Output Behavior|
||Plans and/or SKUs||return both
||includes Prices||throw invalid request error linking to migration docs|
||Plans, SKUs, and/or Prices||
||Plans and/or custom line item||
||throw invalid request error linking to migration docs|
||includes Prices with one-time custom line items||
||throw invalid request error
||Plans and/or Prices||