stripe 17.4.0-beta.3 → 17.5.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 17.5.0-beta.1 - 2024-11-21
+* [#2229](https://github.com/stripe/stripe-node/pull/2229) Update generated code for beta
+  * Add support for `network_advice_code` and `network_decline_code` on `Charge.outcome`, `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`
+  * Change `BillingPortal.Configuration.features.subscription_update.schedule_at_period_end` and `LineItem.description` to be required
+  * Add support for `funding` on `Charge.payment_method_details.amazon_pay` and `Charge.payment_method_details.revolut_pay`
+  * Add support for `amount_requested` and `partial_authorization` on `Charge.payment_method_details.card`
+  * Add support for `metadata` on `Checkout.SessionCreateParams.line_items[]` and `LineItem`
+  * Add support for `line_items` on `Checkout.Session.permissions.update`, `Checkout.SessionCreateParams.permissions.update`, and `Checkout.SessionUpdateParams`
+  * Add support for new value `invoice.overpaid` on enum `Event.type`
+  * Add support for `adjustable_quantity` and `display` on `LineItem`
+  * Change type of `LineItem.description` from `string` to `string | null`
+  * Add support for `request_partial_authorization` on `PaymentIntent.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card`, and `PaymentIntentUpdateParams.payment_method_options.card`
+  * Add support for `payment_method_options` on `PaymentIntentIncrementAuthorizationParams`
+  * Add support for new value `invoice.overpaid` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+
+## 17.4.0 - 2024-11-20
+* [#2222](https://github.com/stripe/stripe-node/pull/2222) This release changes the pinned API version to `2024-11-20.acacia`.
+  * Add support for `respond` test helper method on resource `Issuing.Authorization`
+  * Add support for `authorizer` on `AccountPersonsParams.relationship` and `TokenCreateParams.person.relationship`
+  * Change type of `Account.future_requirements.disabled_reason` and `Account.requirements.disabled_reason` from `string` to `enum`
+  * Change `AccountSession.components.account_management.features.disable_stripe_user_authentication`, `AccountSession.components.account_onboarding.features.disable_stripe_user_authentication`, `AccountSession.components.balances.features.disable_stripe_user_authentication`, `AccountSession.components.notification_banner.features.disable_stripe_user_authentication`, and `AccountSession.components.payouts.features.disable_stripe_user_authentication` to be required
+  * Add support for `adaptive_pricing` on `Checkout.SessionCreateParams` and `Checkout.Session`
+  * Add support for `mandate_options` on `Checkout.Session.payment_method_options.bacs_debit`, `Checkout.Session.payment_method_options.sepa_debit`, `Checkout.SessionCreateParams.payment_method_options.bacs_debit`, and `Checkout.SessionCreateParams.payment_method_options.sepa_debit`
+  * Add support for `request_extended_authorization`, `request_incremental_authorization`, `request_multicapture`, and `request_overcapture` on `Checkout.Session.payment_method_options.card` and `Checkout.SessionCreateParams.payment_method_options.card`
+  * Add support for `capture_method` on `Checkout.SessionCreateParams.payment_method_options.kakao_pay`, `Checkout.SessionCreateParams.payment_method_options.kr_card`, `Checkout.SessionCreateParams.payment_method_options.naver_pay`, `Checkout.SessionCreateParams.payment_method_options.payco`, and `Checkout.SessionCreateParams.payment_method_options.samsung_pay`
+  * Add support for new value `subscribe` on enums `Checkout.Session.submit_type`, `Checkout.SessionCreateParams.submit_type`, `PaymentLink.submit_type`, and `PaymentLinkCreateParams.submit_type`
+  * Add support for new value `li_vat` on enums `Checkout.Session.customer_details.tax_ids[].type`, `Invoice.customer_tax_ids[].type`, `Tax.Calculation.customer_details.tax_ids[].type`, `Tax.Transaction.customer_details.tax_ids[].type`, and `TaxId.type`
+  * Add support for new value `li_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `Tax.CalculationCreateParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+  * Add support for new value `financial_account_statement` on enums `File.purpose` and `FileListParams.purpose`
+  * Add support for `account_holder_address`, `account_holder_name`, `account_type`, and `bank_address` on `FundingInstructions.bank_transfer.financial_addresses[].aba`, `FundingInstructions.bank_transfer.financial_addresses[].swift`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].aba`, and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].swift`
+  * Add support for new value `service_tax` on enums `InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type`, `InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type`, `Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type`, `Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type`, `Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type`, `Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type`, `TaxRate.tax_type`, `TaxRateCreateParams.tax_type`, and `TaxRateUpdateParams.tax_type`
+  * Add support for `merchant_amount` and `merchant_currency` on `Issuing.AuthorizationCreateParams.testHelpers`
+  * Change `Issuing.AuthorizationCreateParams.testHelpers.amount` to be optional
+  * Add support for `fraud_challenges` and `verified_by_fraud_challenge` on `Issuing.Authorization`
+  * Add support for new value `link` on enums `PaymentIntent.payment_method_options.card.network`, `PaymentIntentConfirmParams.payment_method_options.card.network`, `PaymentIntentCreateParams.payment_method_options.card.network`, `PaymentIntentUpdateParams.payment_method_options.card.network`, `SetupIntent.payment_method_options.card.network`, `SetupIntentConfirmParams.payment_method_options.card.network`, `SetupIntentCreateParams.payment_method_options.card.network`, `SetupIntentUpdateParams.payment_method_options.card.network`, `Subscription.payment_settings.payment_method_options.card.network`, `SubscriptionCreateParams.payment_settings.payment_method_options.card.network`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.card.network`
+  * Add support for `submit_type` on `PaymentLinkUpdateParams`
+  * Add support for `trace_id` on `Payout`
+  * Add support for `network_decline_code` on `Refund.destination_details.blik` and `Refund.destination_details.swish`
+  * Change type of `Treasury.InboundTransfer.origin_payment_method` from `string` to `string | null`
+  * Add support for new value `2024-11-20.acacia` on enum `WebhookEndpointCreateParams.api_version`
+* [#2215](https://github.com/stripe/stripe-node/pull/2215) Remove empty resources created for service groupings
+  * Remove `Stripe.V2.BillingResource`, `Stripe.V2.CoreResource`, and `Stripe.V2Resource` types from the public interface as they are no longer needed.  SDK usage will not be affected but any references to these types in your application will need to be removed.
+
 ## 17.4.0-beta.3 - 2024-11-14
 * [#2226](https://github.com/stripe/stripe-node/pull/2226) Update generated code for beta
   * Add support for `account_holder_address` and `bank_address` on `FundingInstructions.bank_transfer.financial_addresses[].iban`, `FundingInstructions.bank_transfer.financial_addresses[].sort_code`, `FundingInstructions.bank_transfer.financial_addresses[].spei`, `FundingInstructions.bank_transfer.financial_addresses[].zengin`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei`, and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zengin`

package/VERSION

@@ -1 +1 @@
-17.4.0-beta.3
+17.5.0-beta.1

package/cjs/stripe.core.js

@@ -36,7 +36,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '17.4.0-beta.3';
+    Stripe.PACKAGE_VERSION = '17.5.0-beta.1';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.resources = resources;

package/esm/stripe.core.js

@@ -33,7 +33,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '17.4.0-beta.3';
+    Stripe.PACKAGE_VERSION = '17.5.0-beta.1';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;
     Stripe.resources = resources;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "17.4.0-beta.3",
+  "version": "17.5.0-beta.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/AccountSessions.d.ts

@@ -88,7 +88,7 @@ declare module 'stripe' {
         namespace AccountManagement {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication: boolean;
 
@@ -111,7 +111,7 @@ declare module 'stripe' {
         namespace AccountOnboarding {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication: boolean;
 
@@ -134,7 +134,7 @@ declare module 'stripe' {
         namespace Balances {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication: boolean;
 
@@ -224,7 +224,7 @@ declare module 'stripe' {
         namespace NotificationBanner {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication: boolean;
 
@@ -313,7 +313,7 @@ declare module 'stripe' {
         namespace Payouts {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication: boolean;
 

package/types/AccountSessionsResource.d.ts

@@ -158,7 +158,7 @@ declare module 'stripe' {
         namespace AccountManagement {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication?: boolean;
 
@@ -184,7 +184,7 @@ declare module 'stripe' {
         namespace AccountOnboarding {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication?: boolean;
 
@@ -252,7 +252,7 @@ declare module 'stripe' {
         namespace Balances {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication?: boolean;
 
@@ -373,7 +373,7 @@ declare module 'stripe' {
         namespace FinancialAccount {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication?: boolean;
 
@@ -507,7 +507,7 @@ declare module 'stripe' {
         namespace NotificationBanner {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication?: boolean;
 
@@ -621,7 +621,7 @@ declare module 'stripe' {
         namespace Payouts {
           interface Features {
             /**
-             * Disables Stripe user authentication for this embedded component. This feature can only be false for accounts where you're responsible for collecting updated information when requirements are due or change, like custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
+             * Disables Stripe user authentication for this embedded component. This feature can only be `true` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `false` when `external_account_collection` is enabled and `true` otherwise.
              */
             disable_stripe_user_authentication?: boolean;
 

package/types/BillingPortal/Configurations.d.ts

@@ -210,7 +210,7 @@ declare module 'stripe' {
              */
             proration_behavior: SubscriptionUpdate.ProrationBehavior;
 
-            schedule_at_period_end?: SubscriptionUpdate.ScheduleAtPeriodEnd;
+            schedule_at_period_end: SubscriptionUpdate.ScheduleAtPeriodEnd;
           }
 
           namespace SubscriptionUpdate {

package/types/Charges.d.ts

@@ -312,6 +312,16 @@ declare module 'stripe' {
       }
 
       interface Outcome {
+        /**
+         * For charges declined by the network, a 2 digit code which indicates the advice returned by the network on how to proceed with an error.
+         */
+        network_advice_code: string | null;
+
+        /**
+         * For charges declined by the network, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+         */
+        network_decline_code: string | null;
+
         /**
          * Possible values are `approved_by_network`, `declined_by_network`, `not_sent_to_network`, and `reversed_after_approval`. The value `reversed_after_approval` indicates the payment was [blocked by Stripe](https://stripe.com/docs/declines#blocked-payments) after bank authorization, and may temporarily appear as "pending" on a cardholder's statement.
          */
@@ -619,7 +629,54 @@ declare module 'stripe' {
 
         interface Alma {}
 
-        interface AmazonPay {}
+        interface AmazonPay {
+          funding?: AmazonPay.Funding;
+        }
+
+        namespace AmazonPay {
+          interface Funding {
+            card?: Funding.Card;
+
+            /**
+             * funding type of the underlying payment method.
+             */
+            type: 'card' | null;
+          }
+
+          namespace Funding {
+            interface Card {
+              /**
+               * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+               */
+              brand: string | null;
+
+              /**
+               * Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
+               */
+              country: string | null;
+
+              /**
+               * Two-digit number representing the card's expiration month.
+               */
+              exp_month: number | null;
+
+              /**
+               * Four-digit number representing the card's expiration year.
+               */
+              exp_year: number | null;
+
+              /**
+               * Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`.
+               */
+              funding: string | null;
+
+              /**
+               * The last four digits of the card.
+               */
+              last4: string | null;
+            }
+          }
+        }
 
         interface AuBecsDebit {
           /**
@@ -733,6 +790,11 @@ declare module 'stripe' {
            */
           amount_authorized: number | null;
 
+          /**
+           * The latest amount intended to be authorized by this charge.
+           */
+          amount_requested?: number | null;
+
           /**
            * Authorization code on the charge.
            */
@@ -837,6 +899,8 @@ declare module 'stripe' {
 
           overcapture?: Card.Overcapture;
 
+          partial_authorization?: Card.PartialAuthorization;
+
           /**
            * Populated if this transaction used 3D Secure authentication.
            */
@@ -960,6 +1024,21 @@ declare module 'stripe' {
             type Status = 'available' | 'unavailable';
           }
 
+          interface PartialAuthorization {
+            /**
+             * Indicates whether the transaction requested for partial authorization feature and the authorization outcome.
+             */
+            status: PartialAuthorization.Status;
+          }
+
+          namespace PartialAuthorization {
+            type Status =
+              | 'declined'
+              | 'fully_authorized'
+              | 'not_requested'
+              | 'partially_authorized';
+          }
+
           interface ThreeDSecure {
             /**
              * For authenticated transactions: how the customer was authenticated by
@@ -2087,7 +2166,54 @@ declare module 'stripe' {
 
         interface Rechnung {}
 
-        interface RevolutPay {}
+        interface RevolutPay {
+          funding?: RevolutPay.Funding;
+        }
+
+        namespace RevolutPay {
+          interface Funding {
+            card?: Funding.Card;
+
+            /**
+             * funding type of the underlying payment method.
+             */
+            type: 'card' | null;
+          }
+
+          namespace Funding {
+            interface Card {
+              /**
+               * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+               */
+              brand: string | null;
+
+              /**
+               * Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
+               */
+              country: string | null;
+
+              /**
+               * Two-digit number representing the card's expiration month.
+               */
+              exp_month: number | null;
+
+              /**
+               * Four-digit number representing the card's expiration year.
+               */
+              exp_year: number | null;
+
+              /**
+               * Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`.
+               */
+              funding: string | null;
+
+              /**
+               * The last four digits of the card.
+               */
+              last4: string | null;
+            }
+          }
+        }
 
         interface SamsungPay {
           /**

package/types/Checkout/Sessions.d.ts

@@ -2045,6 +2045,15 @@ 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 | null;
+
             /**
              * Determines which entity is allowed to update the shipping details.
              *
@@ -2056,6 +2065,8 @@ declare module 'stripe' {
           }
 
           namespace Update {
+            type LineItems = 'client_only' | 'server_only';
+
             type ShippingDetails = 'client_only' | 'server_only';
           }
         }

package/types/Checkout/SessionsResource.d.ts

@@ -304,7 +304,9 @@ declare module 'stripe' {
 
         interface AutomaticTax {
           /**
-           * Set to true to enable automatic taxes.
+           * Set to `true` to [calculate tax automatically](https://docs.stripe.com/tax) using the customer's location.
+           *
+           * Enabling this parameter causes Checkout to collect any billing address information necessary for tax calculation.
            */
           enabled: boolean;
 
@@ -685,6 +687,11 @@ declare module 'stripe' {
            */
           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`.
+           */
+          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.
            */
@@ -2207,6 +2214,15 @@ 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.
              *
@@ -2218,6 +2234,8 @@ declare module 'stripe' {
           }
 
           namespace Update {
+            type LineItems = 'client_only' | 'server_only';
+
             type ShippingDetails = 'client_only' | 'server_only';
           }
         }
@@ -2824,6 +2842,23 @@ declare module 'stripe' {
          */
         expand?: Array<string>;
 
+        /**
+         * A list of items the customer is purchasing.
+         *
+         * When updating line items, the entire array of line items must be retransmitted.
+         *
+         * To retain an existing line item, specify its `id`.
+         *
+         * To update an existing line item, specify its `id` along with the new values of the fields to be updated.
+         *
+         * To add a new line item, specify a `price` and `quantity`. Recurring prices are not supported yet.
+         *
+         * To remove an existing line item, omit the line item's ID from the retransmitted array.
+         *
+         * To reorder a line item, specify it at the desired position in the retransmitted array.
+         */
+        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`.
          */
@@ -2893,6 +2928,57 @@ declare module 'stripe' {
           }
         }
 
+        interface LineItem {
+          /**
+           * When set, provides configuration for this item's quantity to be adjusted by the customer during Checkout.
+           */
+          adjustable_quantity?: LineItem.AdjustableQuantity;
+
+          /**
+           * ID of an existing line item.
+           */
+          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`.
+           */
+          metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
+
+          /**
+           * The ID of the [Price](https://stripe.com/docs/api/prices).
+           */
+          price?: string;
+
+          /**
+           * The quantity of the line item being purchased.
+           */
+          quantity?: number;
+
+          /**
+           * The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item.
+           */
+          tax_rates?: Stripe.Emptyable<Array<string>>;
+        }
+
+        namespace LineItem {
+          interface AdjustableQuantity {
+            /**
+             * Set to true if the quantity can be adjusted to any positive integer. Setting to false will remove any previously specified constraints on quantity.
+             */
+            enabled: boolean;
+
+            /**
+             * The maximum quantity the customer can purchase for the Checkout Session. By default this value is 99. You can specify a value up to 999999.
+             */
+            maximum?: number;
+
+            /**
+             * The minimum quantity the customer must purchase for the Checkout Session. By default this value is 0.
+             */
+            minimum?: number;
+          }
+        }
+
         interface ShippingOption {
           /**
            * The ID of the Shipping Rate to use for this shipping option.

package/types/EventTypes.d.ts

@@ -110,6 +110,7 @@ declare module 'stripe' {
       | InvoiceFinalizedEvent
       | InvoiceMarkedUncollectibleEvent
       | InvoiceOverdueEvent
+      | InvoiceOverpaidEvent
       | InvoicePaidEvent
       | InvoicePaymentOverpaidEvent
       | InvoicePaymentActionRequiredEvent
@@ -1998,6 +1999,22 @@ declare module 'stripe' {
       }
     }
 
+    /**
+     * Occurs when an invoice transitions to paid with a non-zero amount_overpaid.
+     */
+    interface InvoiceOverpaidEvent extends EventBase {
+      type: 'invoice.overpaid';
+      data: InvoiceOverpaidEvent.Data;
+    }
+
+    namespace InvoiceOverpaidEvent {
+      interface Data extends Stripe.Event.Data {
+        object: Stripe.Invoice;
+
+        previous_attributes?: Partial<Stripe.Invoice>;
+      }
+    }
+
     /**
      * Occurs whenever an invoice payment attempt succeeds or an invoice is marked as paid out-of-band.
      */

package/types/Events.d.ts

@@ -194,6 +194,7 @@ declare module 'stripe' {
         | 'invoice.finalized'
         | 'invoice.marked_uncollectible'
         | 'invoice.overdue'
+        | 'invoice.overpaid'
         | 'invoice.paid'
         | 'invoice.payment.overpaid'
         | 'invoice.payment_action_required'

package/types/Invoices.d.ts

@@ -796,6 +796,16 @@ declare module 'stripe' {
          */
         message?: string;
 
+        /**
+         * For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
+         */
+        network_advice_code?: string;
+
+        /**
+         * For card errors resulting from a card issuer decline, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+         */
+        network_decline_code?: string;
+
         /**
          * If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
          */

package/types/InvoicesResource.d.ts

@@ -342,7 +342,7 @@ declare module 'stripe' {
         payment_method_options?: PaymentSettings.PaymentMethodOptions;
 
         /**
-         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice).
+         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice). Should not be specified with payment_method_configuration
          */
         payment_method_types?: Stripe.Emptyable<
           Array<PaymentSettings.PaymentMethodType>
@@ -1152,7 +1152,7 @@ declare module 'stripe' {
         payment_method_options?: PaymentSettings.PaymentMethodOptions;
 
         /**
-         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice).
+         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice). Should not be specified with payment_method_configuration
          */
         payment_method_types?: Stripe.Emptyable<
           Array<PaymentSettings.PaymentMethodType>

package/types/LineItems.d.ts

@@ -16,6 +16,8 @@ declare module 'stripe' {
        */
       object: 'item';
 
+      adjustable_quantity?: LineItem.AdjustableQuantity | null;
+
       /**
        * Total discount amount applied. If no discounts were applied, defaults to 0.
        */
@@ -44,13 +46,20 @@ declare module 'stripe' {
       /**
        * An arbitrary string attached to the object. Often useful for displaying to users. Defaults to product name.
        */
-      description?: string;
+      description: string | null;
 
       /**
        * The discounts applied to the line item.
        */
       discounts?: Array<LineItem.Discount>;
 
+      display?: LineItem.Display;
+
+      /**
+       * 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.
+       */
+      metadata?: Stripe.Metadata | null;
+
       /**
        * The price used to generate the line item.
        */
@@ -75,6 +84,14 @@ declare module 'stripe' {
     }
 
     namespace LineItem {
+      interface AdjustableQuantity {
+        enabled: boolean;
+
+        maximum: number | null;
+
+        minimum: number | null;
+      }
+
       interface Discount {
         /**
          * The amount discounted.
@@ -90,6 +107,14 @@ declare module 'stripe' {
         discount: Stripe.Discount;
       }
 
+      interface Display {
+        description: string | null;
+
+        images: Array<string>;
+
+        name: string;
+      }
+
       interface Tax {
         /**
          * Amount of tax applied for this rate.

package/types/PaymentIntents.d.ts

@@ -333,6 +333,16 @@ declare module 'stripe' {
          */
         message?: string;
 
+        /**
+         * For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
+         */
+        network_advice_code?: string;
+
+        /**
+         * For card errors resulting from a card issuer decline, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+         */
+        network_decline_code?: string;
+
         /**
          * If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
          */
@@ -2042,6 +2052,11 @@ declare module 'stripe' {
            */
           request_overcapture?: Card.RequestOvercapture;
 
+          /**
+           * Request partial authorization on this PaymentIntent.
+           */
+          request_partial_authorization?: Card.RequestPartialAuthorization;
+
           /**
            * 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.
            */
@@ -2210,6 +2225,8 @@ declare module 'stripe' {
 
           type RequestOvercapture = 'if_available' | 'never';
 
+          type RequestPartialAuthorization = 'if_available' | 'never';
+
           type RequestThreeDSecure = 'any' | 'automatic' | 'challenge';
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';

package/types/PaymentIntentsResource.d.ts

@@ -2325,6 +2325,11 @@ declare module 'stripe' {
            */
           request_overcapture?: Card.RequestOvercapture;
 
+          /**
+           * Request partial authorization on this PaymentIntent.
+           */
+          request_partial_authorization?: Card.RequestPartialAuthorization;
+
           /**
            * 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.
            */
@@ -2484,6 +2489,8 @@ declare module 'stripe' {
 
           type RequestOvercapture = 'if_available' | 'never';
 
+          type RequestPartialAuthorization = 'if_available' | 'never';
+
           type RequestThreeDSecure = 'any' | 'automatic' | 'challenge';
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
@@ -6081,6 +6088,11 @@ declare module 'stripe' {
            */
           request_overcapture?: Card.RequestOvercapture;
 
+          /**
+           * Request partial authorization on this PaymentIntent.
+           */
+          request_partial_authorization?: Card.RequestPartialAuthorization;
+
           /**
            * 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.
            */
@@ -6240,6 +6252,8 @@ declare module 'stripe' {
 
           type RequestOvercapture = 'if_available' | 'never';
 
+          type RequestPartialAuthorization = 'if_available' | 'never';
+
           type RequestThreeDSecure = 'any' | 'automatic' | 'challenge';
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
@@ -10592,6 +10606,11 @@ declare module 'stripe' {
            */
           request_overcapture?: Card.RequestOvercapture;
 
+          /**
+           * Request partial authorization on this PaymentIntent.
+           */
+          request_partial_authorization?: Card.RequestPartialAuthorization;
+
           /**
            * 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.
            */
@@ -10751,6 +10770,8 @@ declare module 'stripe' {
 
           type RequestOvercapture = 'if_available' | 'never';
 
+          type RequestPartialAuthorization = 'if_available' | 'never';
+
           type RequestThreeDSecure = 'any' | 'automatic' | 'challenge';
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
@@ -12191,6 +12212,11 @@ declare module 'stripe' {
        */
       metadata?: Stripe.MetadataParam;
 
+      /**
+       * Payment method-specific configuration for this PaymentIntent.
+       */
+      payment_method_options?: PaymentIntentIncrementAuthorizationParams.PaymentMethodOptions;
+
       /**
        * Text that appears on the customer's statement as the statement descriptor for a non-card or card charge. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see [the Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).
        */
@@ -12229,6 +12255,26 @@ declare module 'stripe' {
         }
       }
 
+      interface PaymentMethodOptions {
+        /**
+         * Configuration for any card payments attempted on this PaymentIntent.
+         */
+        card?: PaymentMethodOptions.Card;
+      }
+
+      namespace PaymentMethodOptions {
+        interface Card {
+          /**
+           * Request partial authorization on this PaymentIntent.
+           */
+          request_partial_authorization?: Card.RequestPartialAuthorization;
+        }
+
+        namespace Card {
+          type RequestPartialAuthorization = 'if_available' | 'never';
+        }
+      }
+
       interface TransferData {
         /**
          * The amount that will be transferred automatically when a charge succeeds.

package/types/PaymentLinksResource.d.ts

@@ -188,7 +188,9 @@ declare module 'stripe' {
 
       interface AutomaticTax {
         /**
-         * If `true`, tax will be calculated automatically using the customer's location.
+         * Set to `true` to [calculate tax automatically](https://docs.stripe.com/tax) using the customer's location.
+         *
+         * Enabling this parameter causes the payment link to collect any billing address information necessary for tax calculation.
          */
         enabled: boolean;
 
@@ -1188,7 +1190,9 @@ declare module 'stripe' {
 
       interface AutomaticTax {
         /**
-         * If `true`, tax will be calculated automatically using the customer's location.
+         * Set to `true` to [calculate tax automatically](https://docs.stripe.com/tax) using the customer's location.
+         *
+         * Enabling this parameter causes the payment link to collect any billing address information necessary for tax calculation.
          */
         enabled: boolean;
 

package/types/QuotePreviewInvoices.d.ts

@@ -770,6 +770,16 @@ declare module 'stripe' {
          */
         message?: string;
 
+        /**
+         * For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
+         */
+        network_advice_code?: string;
+
+        /**
+         * For card errors resulting from a card issuer decline, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+         */
+        network_decline_code?: string;
+
         /**
          * If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
          */

package/types/SetupAttempts.d.ts

@@ -589,6 +589,16 @@ declare module 'stripe' {
          */
         message?: string;
 
+        /**
+         * For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
+         */
+        network_advice_code?: string;
+
+        /**
+         * For card errors resulting from a card issuer decline, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+         */
+        network_decline_code?: string;
+
         /**
          * If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
          */

package/types/SetupIntents.d.ts

@@ -214,6 +214,16 @@ declare module 'stripe' {
          */
         message?: string;
 
+        /**
+         * For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
+         */
+        network_advice_code?: string;
+
+        /**
+         * For card errors resulting from a card issuer decline, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+         */
+        network_decline_code?: string;
+
         /**
          * If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
          */

package/types/Terminal/LocationsResource.d.ts

@@ -73,7 +73,7 @@ declare module 'stripe' {
 
       interface LocationUpdateParams {
         /**
-         * The full address of the location. If you're updating the `address` field, avoid changing the `country`. If you need to modify the `country` field, create a new `Location` object and re-register any existing readers to that location.
+         * The full address of the location. You can't change the location's `country`. If you need to modify the `country` field, create a new `Location` object and re-register any existing readers to that location.
          */
         address?: Stripe.AddressParam;
 

package/types/WebhookEndpointsResource.d.ts

@@ -256,6 +256,7 @@ declare module 'stripe' {
         | 'invoice.finalized'
         | 'invoice.marked_uncollectible'
         | 'invoice.overdue'
+        | 'invoice.overpaid'
         | 'invoice.paid'
         | 'invoice.payment.overpaid'
         | 'invoice.payment_action_required'
@@ -573,6 +574,7 @@ declare module 'stripe' {
         | 'invoice.finalized'
         | 'invoice.marked_uncollectible'
         | 'invoice.overdue'
+        | 'invoice.overpaid'
         | 'invoice.paid'
         | 'invoice.payment.overpaid'
         | 'invoice.payment_action_required'