stripe 20.1.0-alpha.4 → 20.1.0

package/types/Checkout/SessionsResource.d.ts

@@ -39,8 +39,6 @@ declare module 'stripe' {
          */
         cancel_url?: string;
 
-        checkout_items?: Array<SessionCreateParams.CheckoutItem>;
-
         /**
          * A unique string to reference the Checkout Session. This can be a
          * customer ID, a cart ID, or similar, and can be used to reconcile the
@@ -71,15 +69,15 @@ declare module 'stripe' {
         /**
          * ID of an existing Customer, if one exists. In `payment` mode, the customer's most recently saved card
          * payment method will be used to prefill the email, name, card details, and billing address
-         * on the Checkout page. In `subscription` mode, the customer's [default payment method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method)
+         * on the Checkout page. In `subscription` mode, the customer's [default payment method](https://docs.stripe.com/api/customers/update#update_customer-invoice_settings-default_payment_method)
          * will be used if it's a card, otherwise the most recently saved card will be used. A valid billing address, billing name and billing email are required on the payment method for Checkout to prefill the customer's card details.
          *
-         * If the Customer already has a valid [email](https://stripe.com/docs/api/customers/object#customer_object-email) set, the email will be prefilled and not editable in Checkout.
+         * If the Customer already has a valid [email](https://docs.stripe.com/api/customers/object#customer_object-email) set, the email will be prefilled and not editable in Checkout.
          * If the Customer does not have a valid `email`, Checkout will set the email entered during the session on the Customer.
          *
          * If blank for Checkout Sessions in `subscription` mode or with `customer_creation` set as `always` in `payment` mode, Checkout will create a new Customer object based on information provided during the payment flow.
          *
-         * You can set [`payment_intent_data.setup_future_usage`](https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse.
+         * You can set [`payment_intent_data.setup_future_usage`](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse.
          */
         customer?: string;
 
@@ -89,12 +87,12 @@ declare module 'stripe' {
         customer_account?: string;
 
         /**
-         * Configure whether a Checkout Session creates a [Customer](https://stripe.com/docs/api/customers) during Session confirmation.
+         * Configure whether a Checkout Session creates a [Customer](https://docs.stripe.com/api/customers) during Session confirmation.
          *
          * When a Customer is not created, you can still retrieve email, address, and other customer data entered in Checkout
-         * with [customer_details](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-customer_details).
+         * with [customer_details](https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-customer_details).
          *
-         * Sessions that don't create Customers instead are grouped by [guest customers](https://stripe.com/docs/payments/checkout/guest-customers)
+         * Sessions that don't create Customers instead are grouped by [guest customers](https://docs.stripe.com/payments/checkout/guest-customers)
          * in the Dashboard. Promotion codes limited to first time customers will return invalid for these Sessions.
          *
          * Can only be set in `payment` and `setup` mode.
@@ -143,7 +141,7 @@ declare module 'stripe' {
         invoice_creation?: SessionCreateParams.InvoiceCreation;
 
         /**
-         * A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices). The parameter is required for `payment` and `subscription` mode.
+         * A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://docs.stripe.com/api/prices). The parameter is required for `payment` and `subscription` mode.
          *
          * For `payment` mode, there is a maximum of 100 line items, however it is recommended to consolidate line items if there are more than a few dozen.
          *
@@ -157,7 +155,7 @@ declare module 'stripe' {
         locale?: SessionCreateParams.Locale;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
          */
         metadata?: Stripe.MetadataParam;
 
@@ -171,12 +169,12 @@ declare module 'stripe' {
          *
          * You can configure Checkout to collect your customers' business names, individual names, or both. Each name field can be either required or optional.
          *
-         * If a [Customer](https://stripe.com/docs/api/customers) is created or provided, the names can be saved to the Customer object as well.
+         * If a [Customer](https://docs.stripe.com/api/customers) is created or provided, the names can be saved to the Customer object as well.
          */
         name_collection?: SessionCreateParams.NameCollection;
 
         /**
-         * A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices).
+         * A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://docs.stripe.com/api/prices).
          *
          * There is a maximum of 10 optional items allowed on a Checkout Session, and the existing limits on the number of line items allowed on a Checkout Session apply to the combined number of line items and optional items.
          *
@@ -202,7 +200,7 @@ declare module 'stripe' {
          *
          * Can only be set in `subscription` mode. Defaults to `always`.
          *
-         * If you'd like information on how to collect a payment method outside of Checkout, read the guide on configuring [subscriptions with a free trial](https://stripe.com/docs/payments/checkout/free-trials).
+         * If you'd like information on how to collect a payment method outside of Checkout, read the guide on configuring [subscriptions with a free trial](https://docs.stripe.com/payments/checkout/free-trials).
          */
         payment_method_collection?: SessionCreateParams.PaymentMethodCollection;
 
@@ -225,7 +223,7 @@ declare module 'stripe' {
          * A list of the types of payment methods (e.g., `card`) this Checkout Session can accept.
          *
          * You can omit this attribute to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods).
-         * See [Dynamic Payment Methods](https://stripe.com/docs/payments/payment-methods/integration-options#using-dynamic-payment-methods) for more details.
+         * See [Dynamic Payment Methods](https://docs.stripe.com/payments/payment-methods/integration-options#using-dynamic-payment-methods) for more details.
          *
          * Read more about the supported payment methods and their requirements in our [payment
          * method details guide](https://docs.stripe.com/docs/payments/checkout/payment-methods).
@@ -247,12 +245,12 @@ declare module 'stripe' {
          * Controls phone number collection settings for the session.
          *
          * We recommend that you review your privacy policy and check with your legal contacts
-         * before using this feature. Learn more about [collecting phone numbers with Checkout](https://stripe.com/docs/payments/checkout/phone-numbers).
+         * before using this feature. Learn more about [collecting phone numbers with Checkout](https://docs.stripe.com/payments/checkout/phone-numbers).
          */
         phone_number_collection?: SessionCreateParams.PhoneNumberCollection;
 
         /**
-         * This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://stripe.com/docs/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`.
+         * This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://docs.stripe.com/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`.
          */
         redirect_on_completion?: SessionCreateParams.RedirectOnCompletion;
 
@@ -301,7 +299,7 @@ declare module 'stripe' {
          * is complete.
          * This parameter is not allowed if ui_mode is `embedded` or `custom`. If you'd like to use
          * information from the successful Checkout Session on your page, read the
-         * guide on [customizing your success page](https://stripe.com/docs/payments/checkout/custom-success-page).
+         * guide on [customizing your success page](https://docs.stripe.com/payments/checkout/custom-success-page).
          */
         success_url?: string;
 
@@ -497,54 +495,6 @@ declare module 'stripe' {
           }
         }
 
-        interface CheckoutItem {
-          type: CheckoutItem.Type;
-
-          rate_card_subscription_item?: CheckoutItem.RateCardSubscriptionItem;
-
-          pricing_plan_subscription_item?: CheckoutItem.PricingPlanSubscriptionItem;
-        }
-
-        namespace CheckoutItem {
-          interface PricingPlanSubscriptionItem {
-            pricing_plan: string;
-
-            pricing_plan_version?: string;
-
-            metadata?: Stripe.MetadataParam;
-
-            component_configurations?: {
-              [key: string]: PricingPlanSubscriptionItem.ComponentConfigurations;
-            };
-          }
-
-          namespace PricingPlanSubscriptionItem {
-            interface ComponentConfigurations {
-              type: 'license_fee_component';
-
-              license_fee_component?: ComponentConfigurations.LicenseFeeComponent;
-            }
-
-            namespace ComponentConfigurations {
-              interface LicenseFeeComponent {
-                quantity: number;
-              }
-            }
-          }
-
-          interface RateCardSubscriptionItem {
-            rate_card: string;
-
-            metadata?: Stripe.MetadataParam;
-
-            rate_card_version?: string;
-          }
-
-          type Type =
-            | 'rate_card_subscription_item'
-            | 'pricing_plan_subscription_item';
-        }
-
         interface ConsentCollection {
           /**
            * Determines the display of payment method reuse agreement text in the UI. If set to `hidden`, it will hide legal text related to the reuse of a payment method.
@@ -785,55 +735,12 @@ declare module 'stripe' {
            */
           coupon?: string;
 
-          /**
-           * Data used to generate a new [Coupon](https://stripe.com/docs/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts.
-           */
-          coupon_data?: Discount.CouponData;
-
           /**
            * The ID of a promotion code to apply to this Session.
            */
           promotion_code?: string;
         }
 
-        namespace Discount {
-          interface CouponData {
-            /**
-             * A positive integer representing the amount to subtract from an invoice total (required if `percent_off` is not passed).
-             */
-            amount_off?: number;
-
-            /**
-             * Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `amount_off` parameter (required if `amount_off` is passed).
-             */
-            currency?: string;
-
-            /**
-             * Specifies how long the discount will be in effect if used on a subscription. Defaults to `once`.
-             */
-            duration?: CouponData.Duration;
-
-            /**
-             * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-             */
-            metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
-
-            /**
-             * Name of the coupon displayed to customers on, for instance invoices, or receipts. By default the `id` is shown if `name` is not set.
-             */
-            name?: string;
-
-            /**
-             * A positive float larger than 0, and smaller or equal to 100, that represents the discount the coupon will apply (required if `amount_off` is not passed).
-             */
-            percent_off?: number;
-          }
-
-          namespace CouponData {
-            type Duration = 'forever' | 'once' | 'repeating';
-          }
-        }
-
         type ExcludedPaymentMethodType =
           | 'acss_debit'
           | 'affirm'
@@ -854,7 +761,6 @@ declare module 'stripe' {
           | 'eps'
           | 'fpx'
           | 'giropay'
-          | 'gopay'
           | 'grabpay'
           | 'ideal'
           | 'kakao_pay'
@@ -872,17 +778,13 @@ declare module 'stripe' {
           | 'payco'
           | 'paynow'
           | 'paypal'
-          | 'paypay'
           | 'payto'
           | 'pix'
           | 'promptpay'
-          | 'qris'
-          | 'rechnung'
           | 'revolut_pay'
           | 'samsung_pay'
           | 'satispay'
           | 'sepa_debit'
-          | 'shopeepay'
           | 'sofort'
           | 'swish'
           | 'twint'
@@ -930,7 +832,7 @@ declare module 'stripe' {
             issuer?: InvoiceData.Issuer;
 
             /**
-             * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+             * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
              */
             metadata?: Stripe.MetadataParam;
 
@@ -996,22 +898,22 @@ declare module 'stripe' {
           adjustable_quantity?: LineItem.AdjustableQuantity;
 
           /**
-           * The [tax rates](https://stripe.com/docs/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU.
+           * The [tax rates](https://docs.stripe.com/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU.
            */
           dynamic_tax_rates?: Array<string>;
 
           /**
-           * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
            */
           metadata?: Stripe.MetadataParam;
 
           /**
-           * The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. One of `price` or `price_data` is required.
+           * The ID of the [Price](https://docs.stripe.com/api/prices) or [Plan](https://docs.stripe.com/api/plans) object. One of `price` or `price_data` is required.
            */
           price?: string;
 
           /**
-           * Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
+           * Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required.
            */
           price_data?: LineItem.PriceData;
 
@@ -1021,7 +923,7 @@ declare module 'stripe' {
           quantity?: number;
 
           /**
-           * The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item.
+           * The [tax rates](https://docs.stripe.com/api/tax_rates) which apply to this line item.
            */
           tax_rates?: Array<string>;
         }
@@ -1066,7 +968,7 @@ declare module 'stripe' {
             recurring?: PriceData.Recurring;
 
             /**
-             * Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+             * Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
              */
             tax_behavior?: PriceData.TaxBehavior;
 
@@ -1094,7 +996,7 @@ declare module 'stripe' {
               images?: Array<string>;
 
               /**
-               * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+               * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
                */
               metadata?: Stripe.MetadataParam;
 
@@ -1104,7 +1006,7 @@ declare module 'stripe' {
               name: string;
 
               /**
-               * A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
+               * A [tax code](https://docs.stripe.com/tax/tax-categories) ID.
                */
               tax_code?: string;
 
@@ -1224,7 +1126,7 @@ declare module 'stripe' {
           adjustable_quantity?: OptionalItem.AdjustableQuantity;
 
           /**
-           * The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object.
+           * The ID of the [Price](https://docs.stripe.com/api/prices) or [Plan](https://docs.stripe.com/api/plans) object.
            */
           price: string;
 
@@ -1257,7 +1159,7 @@ declare module 'stripe' {
 
         interface PaymentIntentData {
           /**
-           * The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
+           * The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts).
            */
           application_fee_amount?: number;
 
@@ -1272,7 +1174,7 @@ declare module 'stripe' {
           description?: string;
 
           /**
-           * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
            */
           metadata?: Stripe.MetadataParam;
 
@@ -1289,7 +1191,7 @@ declare module 'stripe' {
           receipt_email?: string;
 
           /**
-           * Indicates that you intend to [make future payments](https://stripe.com/docs/payments/payment-intents#future-usage) with the payment
+           * Indicates that you intend to [make future payments](https://docs.stripe.com/payments/payment-intents#future-usage) with the payment
            * method collected by this Checkout Session.
            *
            * When setting this to `on_session`, Checkout will show a notice to the
@@ -1331,12 +1233,12 @@ declare module 'stripe' {
 
           /**
            * The parameters used to automatically create a Transfer when the payment succeeds.
-           * For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
+           * For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts).
            */
           transfer_data?: PaymentIntentData.TransferData;
 
           /**
-           * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
+           * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers) for details.
            */
           transfer_group?: string;
         }
@@ -1891,11 +1793,6 @@ declare module 'stripe' {
              */
             installments?: Card.Installments;
 
-            /**
-             * Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this CheckoutSession.
-             */
-            request_decremental_authorization?: Card.RequestDecrementalAuthorization;
-
             /**
              * Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this CheckoutSession.
              */
@@ -1917,7 +1814,7 @@ declare module 'stripe' {
             request_overcapture?: Card.RequestOvercapture;
 
             /**
-             * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
+             * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
              */
             request_three_d_secure?: Card.RequestThreeDSecure;
 
@@ -1957,8 +1854,6 @@ declare module 'stripe' {
               enabled?: boolean;
             }
 
-            type RequestDecrementalAuthorization = 'if_available' | 'never';
-
             type RequestExtendedAuthorization = 'if_available' | 'never';
 
             type RequestIncrementalAuthorization = 'if_available' | 'never';
@@ -2432,7 +2327,7 @@ declare module 'stripe' {
             capture_method?: Stripe.Emptyable<'manual'>;
 
             /**
-             * [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to.
+             * [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to.
              */
             preferred_locale?: Paypal.PreferredLocale;
 
@@ -2441,11 +2336,6 @@ declare module 'stripe' {
              */
             reference?: string;
 
-            /**
-             * A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
-             */
-            reference_id?: string;
-
             /**
              * The risk correlation ID for an on-session payment using a saved PayPal payment method.
              */
@@ -2463,11 +2353,6 @@ declare module 'stripe' {
              * If you've already set `setup_future_usage` and you're performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
              */
             setup_future_usage?: Stripe.Emptyable<Paypal.SetupFutureUsage>;
-
-            /**
-             * The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
-             */
-            subsellers?: Array<string>;
           }
 
           namespace Paypal {
@@ -2520,37 +2405,39 @@ declare module 'stripe' {
               /**
                * Amount that will be collected. It is required when `amount_type` is `fixed`.
                */
-              amount?: number;
+              amount?: Stripe.Emptyable<number>;
 
               /**
                * The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.
                */
-              amount_type?: MandateOptions.AmountType;
+              amount_type?: Stripe.Emptyable<MandateOptions.AmountType>;
 
               /**
                * Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
                */
-              end_date?: string;
+              end_date?: Stripe.Emptyable<string>;
 
               /**
                * The periodicity at which payments will be collected. Defaults to `adhoc`.
                */
-              payment_schedule?: MandateOptions.PaymentSchedule;
+              payment_schedule?: Stripe.Emptyable<
+                MandateOptions.PaymentSchedule
+              >;
 
               /**
                * The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
                */
-              payments_per_period?: number;
+              payments_per_period?: Stripe.Emptyable<number>;
 
               /**
                * The purpose for which payments are made. Has a default value based on your merchant category code.
                */
-              purpose?: MandateOptions.Purpose;
+              purpose?: Stripe.Emptyable<MandateOptions.Purpose>;
 
               /**
                * Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
                */
-              start_date?: string;
+              start_date?: Stripe.Emptyable<string>;
             }
 
             namespace MandateOptions {
@@ -2594,11 +2481,6 @@ declare module 'stripe' {
              */
             expires_after_seconds?: number;
 
-            /**
-             * Additional fields for mandate creation.
-             */
-            mandate_options?: Pix.MandateOptions;
-
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
              *
@@ -2608,68 +2490,11 @@ declare module 'stripe' {
              *
              * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication).
              */
-            setup_future_usage?: Pix.SetupFutureUsage;
+            setup_future_usage?: 'none';
           }
 
           namespace Pix {
             type AmountIncludesIof = 'always' | 'never';
-
-            interface MandateOptions {
-              /**
-               * Amount to be charged for future payments. Required when `amount_type=fixed`. If not provided for `amount_type=maximum`, defaults to 40000.
-               */
-              amount?: number;
-
-              /**
-               * Determines if the amount includes the IOF tax. Defaults to `never`.
-               */
-              amount_includes_iof?: MandateOptions.AmountIncludesIof;
-
-              /**
-               * Type of amount. Defaults to `maximum`.
-               */
-              amount_type?: MandateOptions.AmountType;
-
-              /**
-               * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Only `brl` is supported currently.
-               */
-              currency?: string;
-
-              /**
-               * Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
-               */
-              end_date?: string;
-
-              /**
-               * Schedule at which the future payments will be charged. Defaults to `weekly`.
-               */
-              payment_schedule?: MandateOptions.PaymentSchedule;
-
-              /**
-               * Subscription name displayed to buyers in their bank app. Defaults to the displayable business name.
-               */
-              reference?: string;
-
-              /**
-               * Start date of the mandate, in `YYYY-MM-DD`. Start date should be at least 3 days in the future. Defaults to 3 days after the current date.
-               */
-              start_date?: string;
-            }
-
-            namespace MandateOptions {
-              type AmountIncludesIof = 'always' | 'never';
-
-              type AmountType = 'fixed' | 'maximum';
-
-              type PaymentSchedule =
-                | 'halfyearly'
-                | 'monthly'
-                | 'quarterly'
-                | 'weekly'
-                | 'yearly';
-            }
-
-            type SetupFutureUsage = 'none' | 'off_session';
           }
 
           interface RevolutPay {
@@ -2823,11 +2648,7 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch =
-                | 'balances'
-                | 'inferred_balances'
-                | 'ownership'
-                | 'transactions';
+              type Prefetch = 'balances' | 'ownership' | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
@@ -2883,7 +2704,6 @@ declare module 'stripe' {
           | 'eps'
           | 'fpx'
           | 'giropay'
-          | 'gopay'
           | 'grabpay'
           | 'ideal'
           | 'kakao_pay'
@@ -2902,17 +2722,13 @@ declare module 'stripe' {
           | 'payco'
           | 'paynow'
           | 'paypal'
-          | 'paypay'
           | 'payto'
           | 'pix'
           | 'promptpay'
-          | 'qris'
-          | 'rechnung'
           | 'revolut_pay'
           | 'samsung_pay'
           | 'satispay'
           | 'sepa_debit'
-          | 'shopeepay'
           | 'sofort'
           | 'swish'
           | 'twint'
@@ -2921,27 +2737,6 @@ declare module 'stripe' {
           | 'zip';
 
         interface Permissions {
-          /**
-           * Permissions for updating the Checkout Session.
-           */
-          update?: Permissions.Update;
-
-          /**
-           * Determines which entity is allowed to update the discounts (coupons or promotion codes) that apply to this session.
-           *
-           * Default is `client_only`. Stripe Checkout client will automatically handle discount updates. If set to `server_only`, only your server is allowed to update discounts.
-           */
-          update_discounts?: Permissions.UpdateDiscounts;
-
-          /**
-           * Determines which entity is allowed to update the line items.
-           *
-           * Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
-           *
-           * When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
-           */
-          update_line_items?: Permissions.UpdateLineItems;
-
           /**
            * Determines which entity is allowed to update the shipping details.
            *
@@ -2953,36 +2748,6 @@ declare module 'stripe' {
         }
 
         namespace Permissions {
-          interface Update {
-            /**
-             * Determines which entity is allowed to update the line items.
-             *
-             * Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
-             *
-             * When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
-             */
-            line_items?: Update.LineItems;
-
-            /**
-             * Determines which entity is allowed to update the shipping details.
-             *
-             * Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
-             *
-             * When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
-             */
-            shipping_details?: Update.ShippingDetails;
-          }
-
-          namespace Update {
-            type LineItems = 'client_only' | 'server_only';
-
-            type ShippingDetails = 'client_only' | 'server_only';
-          }
-
-          type UpdateDiscounts = 'client_only' | 'server_only';
-
-          type UpdateLineItems = 'client_only' | 'server_only';
-
           type UpdateShippingDetails = 'client_only' | 'server_only';
         }
 
@@ -3031,7 +2796,7 @@ declare module 'stripe' {
           description?: string;
 
           /**
-           * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
            */
           metadata?: Stripe.MetadataParam;
 
@@ -3321,7 +3086,7 @@ declare module 'stripe' {
             fixed_amount?: ShippingRateData.FixedAmount;
 
             /**
-             * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+             * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
              */
             metadata?: Stripe.MetadataParam;
 
@@ -3331,7 +3096,7 @@ declare module 'stripe' {
             tax_behavior?: ShippingRateData.TaxBehavior;
 
             /**
-             * A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
+             * A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
              */
             tax_code?: string;
 
@@ -3457,7 +3222,7 @@ declare module 'stripe' {
           /**
            * The subscription's description, meant to be displayable to the customer.
            * Use this field to optionally store an explanation of the subscription
-           * for rendering in the [customer portal](https://stripe.com/docs/customer-management).
+           * for rendering in the [customer portal](https://docs.stripe.com/customer-management).
            */
           description?: string;
 
@@ -3467,7 +3232,7 @@ declare module 'stripe' {
           invoice_settings?: SubscriptionData.InvoiceSettings;
 
           /**
-           * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
            */
           metadata?: Stripe.MetadataParam;
 
@@ -3637,31 +3402,16 @@ declare module 'stripe' {
       }
 
       interface SessionUpdateParams {
-        /**
-         * Settings for automatic tax lookup for this session and resulting payments, invoices, and subscriptions.
-         */
-        automatic_tax?: SessionUpdateParams.AutomaticTax;
-
         /**
          * Information about the customer collected within the Checkout Session. Can only be set when updating `embedded` or `custom` sessions.
          */
         collected_information?: SessionUpdateParams.CollectedInformation;
 
-        /**
-         * List of coupons and promotion codes attached to the Checkout Session.
-         */
-        discounts?: Stripe.Emptyable<Array<SessionUpdateParams.Discount>>;
-
         /**
          * Specifies which fields in the response should be expanded.
          */
         expand?: Array<string>;
 
-        /**
-         * Generate a post-purchase Invoice for one-time payments.
-         */
-        invoice_creation?: SessionUpdateParams.InvoiceCreation;
-
         /**
          * A list of items the customer is purchasing.
          *
@@ -3680,7 +3430,7 @@ declare module 'stripe' {
         line_items?: Array<SessionUpdateParams.LineItem>;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
          */
         metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
@@ -3690,39 +3440,9 @@ declare module 'stripe' {
         shipping_options?: Stripe.Emptyable<
           Array<SessionUpdateParams.ShippingOption>
         >;
-
-        /**
-         * A subset of parameters to be passed to subscription creation for Checkout Sessions in `subscription` mode.
-         */
-        subscription_data?: SessionUpdateParams.SubscriptionData;
       }
 
       namespace SessionUpdateParams {
-        interface AutomaticTax {
-          /**
-           * The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
-           */
-          liability?: AutomaticTax.Liability;
-        }
-
-        namespace AutomaticTax {
-          interface Liability {
-            /**
-             * The connected account being referenced when `type` is `account`.
-             */
-            account?: string;
-
-            /**
-             * Type of the account referenced in the request.
-             */
-            type: Liability.Type;
-          }
-
-          namespace Liability {
-            type Type = 'account' | 'self';
-          }
-        }
-
         interface CollectedInformation {
           /**
            * The shipping details to apply to this Session.
@@ -3771,97 +3491,13 @@ declare module 'stripe' {
               postal_code?: string;
 
               /**
-               * State, county, province, or region.
+               * State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
                */
               state?: string;
             }
           }
         }
 
-        interface Discount {
-          /**
-           * The ID of the [Coupon](https://stripe.com/docs/api/coupons) to apply to this Session. One of `coupon` or `coupon_data` is required when updating discounts.
-           */
-          coupon?: string;
-
-          /**
-           * Data used to generate a new [Coupon](https://stripe.com/docs/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts.
-           */
-          coupon_data?: Discount.CouponData;
-        }
-
-        namespace Discount {
-          interface CouponData {
-            /**
-             * A positive integer representing the amount to subtract from an invoice total (required if `percent_off` is not passed).
-             */
-            amount_off?: number;
-
-            /**
-             * Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `amount_off` parameter (required if `amount_off` is passed).
-             */
-            currency?: string;
-
-            /**
-             * Specifies how long the discount will be in effect if used on a subscription. Defaults to `once`.
-             */
-            duration?: CouponData.Duration;
-
-            /**
-             * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-             */
-            metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
-
-            /**
-             * Name of the coupon displayed to customers on, for instance invoices, or receipts. By default the `id` is shown if `name` is not set.
-             */
-            name?: string;
-
-            /**
-             * A positive float larger than 0, and smaller or equal to 100, that represents the discount the coupon will apply (required if `amount_off` is not passed).
-             */
-            percent_off?: number;
-          }
-
-          namespace CouponData {
-            type Duration = 'forever' | 'once' | 'repeating';
-          }
-        }
-
-        interface InvoiceCreation {
-          /**
-           * Parameters passed when creating invoices for payment-mode Checkout Sessions.
-           */
-          invoice_data?: InvoiceCreation.InvoiceData;
-        }
-
-        namespace InvoiceCreation {
-          interface InvoiceData {
-            /**
-             * The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
-             */
-            issuer?: InvoiceData.Issuer;
-          }
-
-          namespace InvoiceData {
-            interface Issuer {
-              /**
-               * The connected account being referenced when `type` is `account`.
-               */
-              account?: string;
-
-              /**
-               * Type of the account referenced in the request.
-               */
-              type: Issuer.Type;
-            }
-
-            namespace Issuer {
-              type Type = 'account' | 'self';
-            }
-          }
-        }
-
         interface LineItem {
           /**
            * When set, provides configuration for this item's quantity to be adjusted by the customer during Checkout.
@@ -3874,17 +3510,17 @@ declare module 'stripe' {
           id?: string;
 
           /**
-           * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
            */
           metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
           /**
-           * The ID of the [Price](https://stripe.com/docs/api/prices). One of `price` or `price_data` is required when creating a new line item.
+           * The ID of the [Price](https://docs.stripe.com/api/prices). One of `price` or `price_data` is required when creating a new line item.
            */
           price?: string;
 
           /**
-           * Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required when creating a new line item.
+           * Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required when creating a new line item.
            */
           price_data?: LineItem.PriceData;
 
@@ -3894,7 +3530,7 @@ declare module 'stripe' {
           quantity?: number;
 
           /**
-           * The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item.
+           * The [tax rates](https://docs.stripe.com/api/tax_rates) which apply to this line item.
            */
           tax_rates?: Stripe.Emptyable<Array<string>>;
         }
@@ -3939,7 +3575,7 @@ declare module 'stripe' {
             recurring?: PriceData.Recurring;
 
             /**
-             * Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+             * Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
              */
             tax_behavior?: PriceData.TaxBehavior;
 
@@ -3967,7 +3603,7 @@ declare module 'stripe' {
               images?: Array<string>;
 
               /**
-               * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+               * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
                */
               metadata?: Stripe.MetadataParam;
 
@@ -3977,7 +3613,7 @@ declare module 'stripe' {
               name: string;
 
               /**
-               * A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
+               * A [tax code](https://docs.stripe.com/tax/tax-categories) ID.
                */
               tax_code?: string;
 
@@ -4037,7 +3673,7 @@ declare module 'stripe' {
             fixed_amount?: ShippingRateData.FixedAmount;
 
             /**
-             * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+             * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
              */
             metadata?: Stripe.MetadataParam;
 
@@ -4047,7 +3683,7 @@ declare module 'stripe' {
             tax_behavior?: ShippingRateData.TaxBehavior;
 
             /**
-             * A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
+             * A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
              */
             tax_code?: string;
 
@@ -4144,50 +3780,6 @@ declare module 'stripe' {
             type TaxBehavior = 'exclusive' | 'inclusive' | 'unspecified';
           }
         }
-
-        interface SubscriptionData {
-          /**
-           * All invoices will be billed using the specified settings.
-           */
-          invoice_settings?: SubscriptionData.InvoiceSettings;
-
-          /**
-           * Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. Has to be at least 48 hours in the future.
-           */
-          trial_end?: number;
-
-          /**
-           * Integer representing the number of trial period days before the customer is charged for the first time. Has to be at least 1.
-           */
-          trial_period_days?: Stripe.Emptyable<number>;
-        }
-
-        namespace SubscriptionData {
-          interface InvoiceSettings {
-            /**
-             * The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
-             */
-            issuer?: InvoiceSettings.Issuer;
-          }
-
-          namespace InvoiceSettings {
-            interface Issuer {
-              /**
-               * The connected account being referenced when `type` is `account`.
-               */
-              account?: string;
-
-              /**
-               * Type of the account referenced in the request.
-               */
-              type: Issuer.Type;
-            }
-
-            namespace Issuer {
-              type Type = 'account' | 'self';
-            }
-          }
-        }
       }
 
       interface SessionListParams extends PaginationParams {