stripe 17.7.0-beta.1 → 17.8.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 17.8.0-beta.1 - 2025-03-18
+* [#2271](https://github.com/stripe/stripe-node/pull/2271) Beta SDK updates between Open API versions 1473 and 1505
+  
+  * Add support for `succeed_input_collection` and `timeout_input_collection` test helper methods on resource `Terminal.Reader`
+  * Change type of `Account.risk_controls.rejected_reason` from enum to enum | null
+  * Change `Checkout.Session.collected_information.shipping_details` and `Checkout.Session.collected_information` to be required
+  * Add support for `target_date` on `Order.payment.settings.payment_method_options.acss_debit`, `Order.payment.settings.payment_method_options.sepa_debit`, `OrderCreateParams.payment.settings.payment_method_options.acss_debit`, `OrderCreateParams.payment.settings.payment_method_options.sepa_debit`, `OrderUpdateParams.payment.settings.payment_method_options.acss_debit`, and `OrderUpdateParams.payment.settings.payment_method_options.sepa_debit`
+* [#2272](https://github.com/stripe/stripe-node/pull/2272) Merge master
+
 ## 17.7.0-beta.1 - 2025-02-07
 * [#2254](https://github.com/stripe/stripe-node/pull/2254) Update generated code for beta
   * Add support for `rejected_reason` on `Account.risk_controls`
@@ -11,6 +20,21 @@
   * Change `Checkout.Session.discounts` to be required
   * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
 
+## 17.7.0 - 2025-02-24
+* [#2256](https://github.com/stripe/stripe-node/pull/2256) Update generated code
+  * Add support for `prices` on `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, and `Billing.CreditGrantCreateParams.applicability_config.scope`
+  * Change `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type`, `Billing.CreditGrant.applicability_config.scope.price_type`, and `Billing.CreditGrantCreateParams.applicability_config.scope.price_type` to be optional
+  * Add support for `priority` on `Billing.CreditGrantCreateParams` and `Billing.CreditGrant`
+  * Add support for `target_date` on `Checkout.Session.payment_method_options.acss_debit`, `Checkout.Session.payment_method_options.au_becs_debit`, `Checkout.Session.payment_method_options.bacs_debit`, `Checkout.Session.payment_method_options.sepa_debit`, `Checkout.Session.payment_method_options.us_bank_account`, `Checkout.SessionCreateParams.payment_method_options.acss_debit`, `Checkout.SessionCreateParams.payment_method_options.au_becs_debit`, `Checkout.SessionCreateParams.payment_method_options.bacs_debit`, `Checkout.SessionCreateParams.payment_method_options.sepa_debit`, `Checkout.SessionCreateParams.payment_method_options.us_bank_account`, `PaymentIntent.payment_method_options.acss_debit`, `PaymentIntent.payment_method_options.au_becs_debit`, `PaymentIntent.payment_method_options.bacs_debit`, `PaymentIntent.payment_method_options.sepa_debit`, `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.acss_debit`, `PaymentIntentConfirmParams.payment_method_options.au_becs_debit`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit`, `PaymentIntentConfirmParams.payment_method_options.sepa_debit`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.acss_debit`, `PaymentIntentCreateParams.payment_method_options.au_becs_debit`, `PaymentIntentCreateParams.payment_method_options.bacs_debit`, `PaymentIntentCreateParams.payment_method_options.sepa_debit`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.acss_debit`, `PaymentIntentUpdateParams.payment_method_options.au_becs_debit`, `PaymentIntentUpdateParams.payment_method_options.bacs_debit`, `PaymentIntentUpdateParams.payment_method_options.sepa_debit`, and `PaymentIntentUpdateParams.payment_method_options.us_bank_account`
+  * Add support for `restrictions` on `Checkout.Session.payment_method_options.card` and `Checkout.SessionCreateParams.payment_method_options.card`
+  * Add support for `collected_information` on `Checkout.SessionUpdateParams` and `Checkout.Session`
+  * Change `Checkout.Session.discounts`, `Refund.destination_details.blik.network_decline_code`, and `Refund.destination_details.swish.network_decline_code` to be required
+  * Add support for `metadata` on `ProductCreateParams.default_price_data`
+  * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
+  * Add support for new value `2025-02-24.acacia` on enum `WebhookEndpointCreateParams.api_version`
+* [#2259](https://github.com/stripe/stripe-node/pull/2259) Add Next.js App Router webhook example that leverages Route Handlers
+* [#2257](https://github.com/stripe/stripe-node/pull/2257) Include `OPENAPI_VERSION` into npm bundle
+
 ## 17.6.0 - 2025-01-27
 * [#2250](https://github.com/stripe/stripe-node/pull/2250) Update generated code
   * Add support for `close` method on resource `Treasury.FinancialAccount`

package/OPENAPI_VERSION

@@ -1 +1 @@
-v1472
+v1505

package/VERSION

@@ -1 +1 @@
-17.7.0-beta.1
+17.8.0-beta.1

package/cjs/apiVersion.js

@@ -2,4 +2,4 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVersion = void 0;
-exports.ApiVersion = '2025-01-27.acacia';
+exports.ApiVersion = '2025-02-24.acacia';

package/cjs/resources/TestHelpers/Terminal/Readers.js

@@ -9,4 +9,12 @@ exports.Readers = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/test_helpers/terminal/readers/{reader}/present_payment_method',
     }),
+    succeedInputCollection: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/terminal/readers/{reader}/succeed_input_collection',
+    }),
+    timeoutInputCollection: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/terminal/readers/{reader}/timeout_input_collection',
+    }),
 });

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.7.0-beta.1';
+    Stripe.PACKAGE_VERSION = '17.8.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/apiVersion.js

@@ -1,2 +1,2 @@
 // File generated from our OpenAPI spec
-export const ApiVersion = '2025-01-27.acacia';
+export const ApiVersion = '2025-02-24.acacia';

package/esm/resources/TestHelpers/Terminal/Readers.js

@@ -6,4 +6,12 @@ export const Readers = StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/test_helpers/terminal/readers/{reader}/present_payment_method',
     }),
+    succeedInputCollection: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/terminal/readers/{reader}/succeed_input_collection',
+    }),
+    timeoutInputCollection: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/terminal/readers/{reader}/timeout_input_collection',
+    }),
 });

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.7.0-beta.1';
+    Stripe.PACKAGE_VERSION = '17.8.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.7.0-beta.1",
+  "version": "17.8.0-beta.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Accounts.d.ts

@@ -1436,7 +1436,7 @@ declare module 'stripe' {
         /**
          * Represents the rejected reason of the account. Empty if account is not rejected, or rejected by Stripe. Please see [this page for more details](https://stripe.com/docs/connect/)
          */
-        rejected_reason?: RiskControls.RejectedReason;
+        rejected_reason?: RiskControls.RejectedReason | null;
       }
 
       namespace RiskControls {

package/types/Billing/CreditBalanceSummaryResource.d.ts

@@ -43,7 +43,7 @@ declare module 'stripe' {
             /**
              * The price type that credit grants can apply to. We currently only support the `metered` price type.
              */
-            price_type: 'metered';
+            price_type?: 'metered';
 
             /**
              * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.

package/types/Billing/CreditGrants.d.ts

@@ -63,6 +63,11 @@ declare module 'stripe' {
          */
         name: string | null;
 
+        /**
+         * The priority for applying this credit grant. The highest priority is 0 and the lowest is 100.
+         */
+        priority?: number | null;
+
         /**
          * ID of the test clock this credit grant belongs to.
          */

package/types/Billing/CreditGrantsResource.d.ts

@@ -10,7 +10,7 @@ declare module 'stripe' {
         amount: CreditGrantCreateParams.Amount;
 
         /**
-         * Configuration specifying what this credit grant applies to.
+         * Configuration specifying what this credit grant applies to. We currently only support `metered` prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
          */
         applicability_config: CreditGrantCreateParams.ApplicabilityConfig;
 
@@ -48,6 +48,11 @@ declare module 'stripe' {
          * A descriptive name shown in the Dashboard.
          */
         name?: string;
+
+        /**
+         * The desired priority for applying this credit grant. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.
+         */
+        priority?: number;
       }
 
       namespace CreditGrantCreateParams {
@@ -89,7 +94,7 @@ declare module 'stripe' {
             /**
              * The price type that credit grants can apply to. We currently only support the `metered` price type.
              */
-            price_type: 'metered';
+            price_type?: 'metered';
 
             /**
              * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.

package/types/Charges.d.ts

@@ -497,7 +497,7 @@ declare module 'stripe' {
         twint?: PaymentMethodDetails.Twint;
 
         /**
-         * The type of transaction-specific details of the payment method used in the payment, one of `ach_credit_transfer`, `ach_debit`, `acss_debit`, `alipay`, `au_becs_debit`, `bancontact`, `card`, `card_present`, `eps`, `giropay`, `ideal`, `klarna`, `multibanco`, `p24`, `sepa_debit`, `sofort`, `stripe_account`, or `wechat`.
+         * The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) for the full list of possible types.
          * An additional hash is included on `payment_method_details` with a name matching this value.
          * It contains information specific to the payment method.
          */

package/types/Checkout/Sessions.d.ts

@@ -82,7 +82,7 @@ declare module 'stripe' {
         /**
          * Information about the customer collected within the Checkout Session.
          */
-        collected_information?: Session.CollectedInformation | null;
+        collected_information: Session.CollectedInformation | null;
 
         /**
          * Results of `consent_collection` for this session.
@@ -421,7 +421,7 @@ declare module 'stripe' {
           /**
            * Shipping information for this Checkout Session.
            */
-          shipping_details?: CollectedInformation.ShippingDetails | null;
+          shipping_details: CollectedInformation.ShippingDetails | null;
 
           /**
            * Customer's tax ids for this Checkout Session.
@@ -1229,6 +1229,11 @@ declare module 'stripe' {
              */
             setup_future_usage?: AcssDebit.SetupFutureUsage;
 
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
+
             /**
              * Bank account verification method.
              */
@@ -1345,6 +1350,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://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: 'none';
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           interface BacsDebit {
@@ -1360,6 +1370,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://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: BacsDebit.SetupFutureUsage;
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           namespace BacsDebit {
@@ -1994,6 +2009,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://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: SepaDebit.SetupFutureUsage;
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           namespace SepaDebit {
@@ -2041,6 +2061,11 @@ declare module 'stripe' {
              */
             setup_future_usage?: UsBankAccount.SetupFutureUsage;
 
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
+
             /**
              * Bank account verification method.
              */

package/types/Checkout/SessionsResource.d.ts

@@ -1233,6 +1233,11 @@ declare module 'stripe' {
              */
             setup_future_usage?: AcssDebit.SetupFutureUsage;
 
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
+
             /**
              * Verification method for the intent
              */
@@ -1351,6 +1356,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://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: 'none';
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           interface BacsDebit {
@@ -1369,6 +1379,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://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: BacsDebit.SetupFutureUsage;
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           namespace BacsDebit {
@@ -2075,6 +2090,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://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: SepaDebit.SetupFutureUsage;
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           namespace SepaDebit {
@@ -2125,6 +2145,11 @@ declare module 'stripe' {
              */
             setup_future_usage?: UsBankAccount.SetupFutureUsage;
 
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
+
             /**
              * Verification method for the intent
              */
@@ -3159,6 +3184,63 @@ declare module 'stripe' {
         }
       }
 
+      namespace SessionUpdateParams {
+        interface CollectedInformation {
+          /**
+           * The shipping details to apply to this Session.
+           */
+          shipping_details?: CollectedInformation.ShippingDetails;
+        }
+
+        namespace CollectedInformation {
+          interface ShippingDetails {
+            /**
+             * The address of the customer
+             */
+            address: ShippingDetails.Address;
+
+            /**
+             * The name of customer
+             */
+            name: string;
+          }
+
+          namespace ShippingDetails {
+            interface Address {
+              /**
+               * City, district, suburb, town, or village.
+               */
+              city?: string;
+
+              /**
+               * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+               */
+              country: string;
+
+              /**
+               * Address line 1 (e.g., street, PO Box, or company name).
+               */
+              line1: string;
+
+              /**
+               * Address line 2 (e.g., apartment, suite, unit, or building).
+               */
+              line2?: string;
+
+              /**
+               * ZIP or postal code.
+               */
+              postal_code?: string;
+
+              /**
+               * State, county, province, or region.
+               */
+              state?: string;
+            }
+          }
+        }
+      }
+
       interface SessionListParams extends PaginationParams {
         /**
          * Only return Checkout Sessions that were created during the given date interval.

package/types/EventTypes.d.ts

@@ -2080,7 +2080,7 @@ declare module 'stripe' {
     }
 
     /**
-     * Occurs whenever an invoice payment attempt fails, due either to a declined payment or to the lack of a stored payment method.
+     * Occurs whenever an invoice payment attempt fails, due to either a declined payment, including soft decline, or to the lack of a stored payment method.
      */
     interface InvoicePaymentFailedEvent extends EventBase {
       type: 'invoice.payment_failed';

package/types/Identity/VerificationSessions.d.ts

@@ -81,7 +81,7 @@ declare module 'stripe' {
         redaction: VerificationSession.Redaction | null;
 
         /**
-         * Token referencing a Customer resource.
+         * Customer ID
          */
         related_customer: string | null;
 

package/types/Identity/VerificationSessionsResource.d.ts

@@ -30,7 +30,7 @@ declare module 'stripe' {
         provided_details?: VerificationSessionCreateParams.ProvidedDetails;
 
         /**
-         * Token referencing a Customer resource.
+         * Customer ID
          */
         related_customer?: string;
 

package/types/Orders.d.ts

@@ -310,6 +310,11 @@ declare module 'stripe' {
                */
               setup_future_usage?: AcssDebit.SetupFutureUsage;
 
+              /**
+               * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+               */
+              target_date?: string;
+
               /**
                * Bank account verification method.
                */
@@ -732,6 +737,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://stripe.com/strong-customer-authentication).
                */
               setup_future_usage?: SepaDebit.SetupFutureUsage;
+
+              /**
+               * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+               */
+              target_date?: string;
             }
 
             namespace SepaDebit {

package/types/OrdersResource.d.ts

@@ -455,6 +455,11 @@ declare module 'stripe' {
                */
               setup_future_usage?: Stripe.Emptyable<AcssDebit.SetupFutureUsage>;
 
+              /**
+               * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+               */
+              target_date?: string;
+
               /**
                * Bank account verification method.
                */
@@ -1004,6 +1009,11 @@ 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<SepaDebit.SetupFutureUsage>;
+
+              /**
+               * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+               */
+              target_date?: string;
             }
 
             namespace SepaDebit {
@@ -1874,6 +1884,11 @@ declare module 'stripe' {
                */
               setup_future_usage?: Stripe.Emptyable<AcssDebit.SetupFutureUsage>;
 
+              /**
+               * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+               */
+              target_date?: string;
+
               /**
                * Bank account verification method.
                */
@@ -2423,6 +2438,11 @@ 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<SepaDebit.SetupFutureUsage>;
+
+              /**
+               * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+               */
+              target_date?: string;
             }
 
             namespace SepaDebit {

package/types/PaymentIntents.d.ts

@@ -1781,6 +1781,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: AcssDebit.SetupFutureUsage;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */
@@ -1925,6 +1930,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://stripe.com/strong-customer-authentication).
            */
           setup_future_usage?: AuBecsDebit.SetupFutureUsage;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace AuBecsDebit {
@@ -1944,6 +1954,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://stripe.com/strong-customer-authentication).
            */
           setup_future_usage?: BacsDebit.SetupFutureUsage;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace BacsDebit {
@@ -3019,6 +3034,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://stripe.com/strong-customer-authentication).
            */
           setup_future_usage?: SepaDebit.SetupFutureUsage;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace SepaDebit {
@@ -3128,6 +3148,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: UsBankAccount.SetupFutureUsage;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */
@@ -3320,14 +3345,14 @@ declare module 'stripe' {
 
       interface TransferData {
         /**
-         * Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
+         * The amount transferred to the destination account. This transfer will occur automatically after the payment succeeds. If no amount is specified, by default the entire payment amount is transferred to the destination account.
+         *  The amount must be less than or equal to the [amount](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-amount), and must be a positive integer
+         *  representing how much to transfer in the smallest currency unit (e.g., 100 cents to charge $1.00).
          */
         amount?: number;
 
         /**
-         * The account (if any) that the payment is attributed to for tax
-         * reporting, and where funds from the payment are transferred to after
-         * payment success.
+         * The account (if any) that the payment is attributed to for tax reporting, and where funds from the payment are transferred to after payment success.
          */
         destination: string | Stripe.Account;
       }

package/types/PaymentIntentsResource.d.ts

@@ -2002,6 +2002,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: Stripe.Emptyable<AcssDebit.SetupFutureUsage>;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */
@@ -2172,6 +2177,11 @@ 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<AuBecsDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace AuBecsDebit {
@@ -2196,6 +2206,11 @@ 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<BacsDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace BacsDebit {
@@ -3539,6 +3554,11 @@ 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<SepaDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace SepaDebit {
@@ -3671,6 +3691,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: Stripe.Emptyable<UsBankAccount.SetupFutureUsage>;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */
@@ -5790,6 +5815,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: Stripe.Emptyable<AcssDebit.SetupFutureUsage>;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */
@@ -5960,6 +5990,11 @@ 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<AuBecsDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace AuBecsDebit {
@@ -5984,6 +6019,11 @@ 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<BacsDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace BacsDebit {
@@ -7327,6 +7367,11 @@ 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<SepaDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace SepaDebit {
@@ -7459,6 +7504,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: Stripe.Emptyable<UsBankAccount.SetupFutureUsage>;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */
@@ -10333,6 +10383,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: Stripe.Emptyable<AcssDebit.SetupFutureUsage>;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */
@@ -10503,6 +10558,11 @@ 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<AuBecsDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace AuBecsDebit {
@@ -10527,6 +10587,11 @@ 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<BacsDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace BacsDebit {
@@ -11870,6 +11935,11 @@ 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<SepaDebit.SetupFutureUsage>;
+
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
         }
 
         namespace SepaDebit {
@@ -12002,6 +12072,11 @@ declare module 'stripe' {
            */
           setup_future_usage?: Stripe.Emptyable<UsBankAccount.SetupFutureUsage>;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+           */
+          target_date?: string;
+
           /**
            * Bank account verification method.
            */

package/types/ProductsResource.d.ts

@@ -111,6 +111,11 @@ declare module 'stripe' {
          */
         custom_unit_amount?: DefaultPriceData.CustomUnitAmount;
 
+        /**
+         * 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 recurring components of a price such as `interval` and `interval_count`.
          */

package/types/Tax/Calculations.d.ts

@@ -446,7 +446,7 @@ declare module 'stripe' {
             percentage_decimal: string;
 
             /**
-             * Indicates the type of tax rate applied to the taxable amount. This value can be `null` when no tax applies to the location.
+             * Indicates the type of tax rate applied to the taxable amount. This value can be `null` when no tax applies to the location. This field is only present for TaxRates created by Stripe Tax.
              */
             rate_type: TaxRateDetails.RateType | null;
 

package/types/TaxRates.d.ts

@@ -86,7 +86,7 @@ declare module 'stripe' {
       percentage: number;
 
       /**
-       * Indicates the type of tax rate applied to the taxable amount. This value can be `null` when no tax applies to the location.
+       * Indicates the type of tax rate applied to the taxable amount. This value can be `null` when no tax applies to the location. This field is only present for TaxRates created by Stripe Tax.
        */
       rate_type: TaxRate.RateType | null;
 

package/types/TestHelpers/Terminal/ReadersResource.d.ts

@@ -50,6 +50,33 @@ declare module 'stripe' {
         }
       }
 
+      namespace Terminal {
+        interface ReaderSucceedInputCollectionParams {
+          /**
+           * Specifies which fields in the response should be expanded.
+           */
+          expand?: Array<string>;
+
+          /**
+           * Skip behavior for input collection.
+           */
+          skip_non_required_inputs?: ReaderSucceedInputCollectionParams.SkipNonRequiredInputs;
+        }
+
+        namespace ReaderSucceedInputCollectionParams {
+          type SkipNonRequiredInputs = 'all' | 'none';
+        }
+      }
+
+      namespace Terminal {
+        interface ReaderTimeoutInputCollectionParams {
+          /**
+           * Specifies which fields in the response should be expanded.
+           */
+          expand?: Array<string>;
+        }
+      }
+
       namespace Terminal {
         class ReadersResource {
           /**
@@ -64,6 +91,32 @@ declare module 'stripe' {
             id: string,
             options?: RequestOptions
           ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
+
+          /**
+           * Succeeds an input collection on a simulated reader. Can be used to simulate collecting inputs.
+           */
+          succeedInputCollection(
+            id: string,
+            params?: ReaderSucceedInputCollectionParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
+          succeedInputCollection(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
+
+          /**
+           * Completes an input collection with a timeout error on a simulated reader.
+           */
+          timeoutInputCollection(
+            id: string,
+            params?: ReaderTimeoutInputCollectionParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
+          timeoutInputCollection(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
         }
       }
     }

package/types/TokensResource.d.ts

@@ -719,7 +719,7 @@ declare module 'stripe' {
         /**
          * Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.
          */
-        political_exposure?: Person.PoliticalExposure;
+        political_exposure?: string;
 
         /**
          * The person's registered address.
@@ -826,8 +826,6 @@ declare module 'stripe' {
           }
         }
 
-        type PoliticalExposure = 'existing' | 'none';
-
         interface Relationship {
           /**
            * Whether the person is the authorizer of the account's representative.

package/types/WebhookEndpointsResource.d.ts

@@ -147,7 +147,8 @@ declare module 'stripe' {
         | '2024-10-28.acacia'
         | '2024-11-20.acacia'
         | '2024-12-18.acacia'
-        | '2025-01-27.acacia';
+        | '2025-01-27.acacia'
+        | '2025-02-24.acacia';
 
       type EnabledEvent =
         | '*'

package/types/lib.d.ts

@@ -27,7 +27,7 @@ declare module 'stripe' {
       }): (...args: any[]) => Response<ResponseObject>; //eslint-disable-line @typescript-eslint/no-explicit-any
       static MAX_BUFFERED_REQUEST_METRICS: number;
     }
-    export type LatestApiVersion = '2025-01-27.acacia';
+    export type LatestApiVersion = '2025-02-24.acacia';
     export type HttpAgent = Agent;
     export type HttpProtocol = 'http' | 'https';
 

package/types/test/typescriptTest.ts

@@ -9,7 +9,7 @@
 import Stripe from 'stripe';
 
 let stripe = new Stripe('sk_test_123', {
-  apiVersion: '2025-01-27.acacia',
+  apiVersion: '2025-02-24.acacia',
 });
 
 stripe = new Stripe('sk_test_123');
@@ -26,7 +26,7 @@ stripe = new Stripe('sk_test_123', {
 
 // Check config object.
 stripe = new Stripe('sk_test_123', {
-  apiVersion: '2025-01-27.acacia',
+  apiVersion: '2025-02-24.acacia',
   typescript: true,
   maxNetworkRetries: 1,
   timeout: 1000,
@@ -44,7 +44,7 @@ stripe = new Stripe('sk_test_123', {
     description: 'test',
   };
   const opts: Stripe.RequestOptions = {
-    apiVersion: '2025-01-27.acacia',
+    apiVersion: '2025-02-24.acacia',
   };
   const customer: Stripe.Customer = await stripe.customers.create(params, opts);