API version 2022-08-01 removed Checkout Session Create's line_items[amount] but still available in Typescript API?

[davidbielik]

Describe the bug

Hi, I'm upgrading from API 2020-08-27 to 2022-08-01, and have upgraded my stripe-node to the latest version (v10.13.0) specifying apiVersion: '2022-08-01'.

The Upgrade Guide mentions:

The following parameters have been removed from create Checkout Session: line_items[amount],...

Yet in the Stripe Node Library, those types were not removed from Stripe.Checkout.SessionCreateParams:

stripe-node/types/2022-08-01/Checkout/Sessions.d.ts

Lines 1726 to 1729 in db94c29

	/**
	* [Deprecated] The amount to be collected per unit of the line item. If specified, must also pass `currency` and `name`.
	*/
	amount?: number;

To Reproduce

Upgrade API to 2022-08-01 and in typescript use:

import Stripe from 'stripe';
const stripe = new Stripe(key, {
  apiVersion: '2022-08-01'
});
const params: Stripe.Checkout.SessionCreateParams = {
    cancel_url: "",
    success_url: "",
    billing_address_collection: 'auto', //'required',
    customer: "",
    locale: 'auto',
    mode: 'payment',
    line_items: [
      {
        amount: 100,
        currency: 'USD',
        name: "",
        quantity: 1,
        description: "",
        images: ""
      },
    ],
}

Expected behavior

If the 2022-08-01 API removed Create Checkout Session's line_items fields, then it should have been removed from the typescript definitions?

Code snippets

The API returns:

You cannot use line_items.amount, line_items.currency, line_items.name, line_items.description, or line_items.images in this API version. Please use line_items.price or line_items.price_data. Please see https://stripe.com/docs/payments/checkout/migrating-prices for more information.

OS

macOS

Node version

Node v16.14.2

Library version

stripe-node v10.13.0

API version

2022-08-01

Additional context

[richardm-stripe]

Hello @davidbielik, thanks for reporting this.

I've investigated and this does appear to be an error in the Typescript bindings (and other SDKs too, such as stripe-java), not in the upgrade guide:

if you attempt to actually send these parameters on the latest API version, you get a 400

{
  "error": {
    "message": "You cannot use `line_items.amount`, `line_items.currency`, `line_items.name`, `line_items.description`, or `line_items.images` in this API version. Please use `line_items.price` or `line_items.price_data`. Please see https://stripe.com/docs/payments/checkout/migrating-prices for more information.",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_Izj3zTug4QVnyU?t=1665450540",
    "type": "invalid_request_error"
  }
}

so it seems the types should be removed.