stripe 16.3.0-beta.1 → 16.4.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 16.4.0-beta.1 - 2024-07-11
+* [#2128](https://github.com/stripe/stripe-node/pull/2128) Update generated code for beta
+  * Change `ConfirmationToken.payment_method_options` and `CustomerSession.components.payment_element` to be required
+  * Add support for new value `not_qualified` on enum `Dispute.evidence_details.enhanced_eligibility.visa_compelling_evidence_3.status`
+* [#2134](https://github.com/stripe/stripe-node/pull/2134) Fix merge conflicts
+
 ## 16.3.0-beta.1 - 2024-07-05
 * [#2126](https://github.com/stripe/stripe-node/pull/2126) Update generated code for beta
   * ⚠️ Remove support for `payment_method_update` on `CustomerSession.components.payment_element.features` and `CustomerSessionCreateParams.components.payment_element.features`. Users are expected to completely migrate from using `payment_method_update`.
@@ -7,7 +13,13 @@
   * Add support for `list` and `retrieve` methods on resource `Institution`
   * Add support for `institution` on `Checkout.Session.payment_method_options.us_bank_account.financial_connections.filters`, `FinancialConnections.Session.filters`, `FinancialConnections.SessionCreateParams.filters`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.filters`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filters`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filters`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections.filters`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.filters`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections.filters`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.filters`, `SetupIntent.payment_method_options.us_bank_account.financial_connections.filters`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.filters`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections.filters`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.filters`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.filters`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filters`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filters`
   * Add support for `payment_method_allow_redisplay_filters`, `payment_method_redisplay_limit`, `payment_method_redisplay`, and `payment_method_save_usage` on `CustomerSession.components.payment_element.features` and `CustomerSessionCreateParams.components.payment_element.features`
-  * Add support for new value `balance` on enums `FinancialConnections.Account.subscriptions[]`, `FinancialConnections.AccountSubscribeParams.features[]`, and `FinancialConnections.AccountUnsubscribeParams.features[]`
+  * Add support for new value `balance` on enums `FinancialConnections.Account.subscriptions[]`, `FinancialConnections.AccountSubscribeParams.features[]`, and `FinancialConnections.AccountUnsubscribeParams.features[]`
+
+## 16.2.0 - 2024-07-05
+* [#2125](https://github.com/stripe/stripe-node/pull/2125) Update generated code
+  * Add support for `add_lines`, `remove_lines`, and `update_lines` methods on resource `Invoice`
+  * Add support for new value `payment_intent_fx_quote_invalid` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+  * Add support for `posted_at` on `Tax.TransactionCreateFromCalculationParams` and `Tax.Transaction`
 
 ## 16.2.0-beta.1 - 2024-06-27
 * [#2110](https://github.com/stripe/stripe-node/pull/2110) Update generated code for beta

package/VERSION

@@ -1 +1 @@
-16.3.0-beta.1
+16.4.0-beta.1

package/cjs/ResourceNamespace.js

@@ -5,6 +5,9 @@ exports.resourceNamespace = void 0;
 // It also works recursively, so you could do i.e. `stripe.billing.invoicing.pay`.
 function ResourceNamespace(stripe, resources) {
     for (const name in resources) {
+        if (!Object.prototype.hasOwnProperty.call(resources, name)) {
+            continue;
+        }
         const camelCaseName = name[0].toLowerCase() + name.substring(1);
         const resource = new resources[name](stripe);
         this[camelCaseName] = resource;

package/cjs/Webhooks.js

@@ -43,23 +43,16 @@ function createWebhooks(platformFunctions) {
          * @property {CryptoProvider} cryptoProvider - Crypto provider to use for computing the signature if none was provided. Defaults to NodeCryptoProvider.
          */
         generateTestHeaderString: function (opts) {
-            if (!opts) {
-                throw new Error_js_1.StripeError({
-                    message: 'Options are required',
-                });
-            }
-            opts.timestamp =
-                Math.floor(opts.timestamp) || Math.floor(Date.now() / 1000);
-            opts.scheme = opts.scheme || signature.EXPECTED_SCHEME;
-            opts.cryptoProvider = opts.cryptoProvider || getCryptoProvider();
-            opts.signature =
-                opts.signature ||
-                    opts.cryptoProvider.computeHMACSignature(opts.timestamp + '.' + opts.payload, opts.secret);
-            const generatedHeader = [
-                't=' + opts.timestamp,
-                opts.scheme + '=' + opts.signature,
-            ].join(',');
-            return generatedHeader;
+            const preparedOpts = prepareOptions(opts);
+            const signature = preparedOpts.signature ||
+                preparedOpts.cryptoProvider.computeHMACSignature(preparedOpts.payloadString, preparedOpts.secret);
+            return preparedOpts.generateHeaderString(signature);
+        },
+        generateTestHeaderStringAsync: async function (opts) {
+            const preparedOpts = prepareOptions(opts);
+            const signature = preparedOpts.signature ||
+                (await preparedOpts.cryptoProvider.computeHMACSignatureAsync(preparedOpts.payloadString, preparedOpts.secret));
+            return preparedOpts.generateHeaderString(signature);
         },
     };
     const signature = {
@@ -194,6 +187,25 @@ function createWebhooks(platformFunctions) {
         }
         return webhooksCryptoProviderInstance;
     }
+    function prepareOptions(opts) {
+        if (!opts) {
+            throw new Error_js_1.StripeError({
+                message: 'Options are required',
+            });
+        }
+        const timestamp = Math.floor(opts.timestamp) || Math.floor(Date.now() / 1000);
+        const scheme = opts.scheme || signature.EXPECTED_SCHEME;
+        const cryptoProvider = opts.cryptoProvider || getCryptoProvider();
+        const payloadString = `${timestamp}.${opts.payload}`;
+        const generateHeaderString = (signature) => {
+            return `t=${timestamp},${scheme}=${signature}`;
+        };
+        return Object.assign(Object.assign({}, opts), { timestamp,
+            scheme,
+            cryptoProvider,
+            payloadString,
+            generateHeaderString });
+    }
     Webhook.signature = signature;
     return Webhook;
 }

package/cjs/multipart.js

@@ -24,6 +24,9 @@ const multipartDataGenerator = (method, data, headers) => {
     }
     const flattenedData = (0, utils_js_1.flattenAndStringify)(data);
     for (const k in flattenedData) {
+        if (!Object.prototype.hasOwnProperty.call(flattenedData, k)) {
+            continue;
+        }
         const v = flattenedData[k];
         push(`--${segno}`);
         if (Object.prototype.hasOwnProperty.call(v, 'data')) {

package/cjs/stripe.core.js

@@ -2,14 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStripe = void 0;
 const _Error = require("./Error.js");
-const apiVersion_js_1 = require("./apiVersion.js");
-const resources = require("./resources.js");
-const HttpClient_js_1 = require("./net/HttpClient.js");
-const utils_js_1 = require("./utils.js");
-const CryptoProvider_js_1 = require("./crypto/CryptoProvider.js");
 const RequestSender_js_1 = require("./RequestSender.js");
 const StripeResource_js_1 = require("./StripeResource.js");
 const Webhooks_js_1 = require("./Webhooks.js");
+const apiVersion_js_1 = require("./apiVersion.js");
+const CryptoProvider_js_1 = require("./crypto/CryptoProvider.js");
+const HttpClient_js_1 = require("./net/HttpClient.js");
+const resources = require("./resources.js");
+const utils_js_1 = require("./utils.js");
 const DEFAULT_HOST = 'api.stripe.com';
 const DEFAULT_PORT = '443';
 const DEFAULT_BASE_PATH = '/v1/';
@@ -34,7 +34,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 = '16.3.0-beta.1';
+    Stripe.PACKAGE_VERSION = '16.4.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;
@@ -277,6 +277,9 @@ function createStripe(platformFunctions, requestSender = defaultRequestSenderFac
                 var _a;
                 const userAgent = {};
                 for (const field in seed) {
+                    if (!Object.prototype.hasOwnProperty.call(seed, field)) {
+                        continue;
+                    }
                     userAgent[field] = encodeURIComponent((_a = seed[field]) !== null && _a !== void 0 ? _a : 'null');
                 }
                 // URI-encode in case there are unusual characters in the system's uname.
@@ -320,6 +323,9 @@ function createStripe(platformFunctions, requestSender = defaultRequestSenderFac
          */
         _prepResources() {
             for (const name in resources) {
+                if (!Object.prototype.hasOwnProperty.call(resources, name)) {
+                    continue;
+                }
                 // @ts-ignore
                 this[(0, utils_js_1.pascalToCamelCase)(name)] = new resources[name](this);
             }

package/esm/ResourceNamespace.js

@@ -2,6 +2,9 @@
 // It also works recursively, so you could do i.e. `stripe.billing.invoicing.pay`.
 function ResourceNamespace(stripe, resources) {
     for (const name in resources) {
+        if (!Object.prototype.hasOwnProperty.call(resources, name)) {
+            continue;
+        }
         const camelCaseName = name[0].toLowerCase() + name.substring(1);
         const resource = new resources[name](stripe);
         this[camelCaseName] = resource;

package/esm/Webhooks.js

@@ -40,23 +40,16 @@ export function createWebhooks(platformFunctions) {
          * @property {CryptoProvider} cryptoProvider - Crypto provider to use for computing the signature if none was provided. Defaults to NodeCryptoProvider.
          */
         generateTestHeaderString: function (opts) {
-            if (!opts) {
-                throw new StripeError({
-                    message: 'Options are required',
-                });
-            }
-            opts.timestamp =
-                Math.floor(opts.timestamp) || Math.floor(Date.now() / 1000);
-            opts.scheme = opts.scheme || signature.EXPECTED_SCHEME;
-            opts.cryptoProvider = opts.cryptoProvider || getCryptoProvider();
-            opts.signature =
-                opts.signature ||
-                    opts.cryptoProvider.computeHMACSignature(opts.timestamp + '.' + opts.payload, opts.secret);
-            const generatedHeader = [
-                't=' + opts.timestamp,
-                opts.scheme + '=' + opts.signature,
-            ].join(',');
-            return generatedHeader;
+            const preparedOpts = prepareOptions(opts);
+            const signature = preparedOpts.signature ||
+                preparedOpts.cryptoProvider.computeHMACSignature(preparedOpts.payloadString, preparedOpts.secret);
+            return preparedOpts.generateHeaderString(signature);
+        },
+        generateTestHeaderStringAsync: async function (opts) {
+            const preparedOpts = prepareOptions(opts);
+            const signature = preparedOpts.signature ||
+                (await preparedOpts.cryptoProvider.computeHMACSignatureAsync(preparedOpts.payloadString, preparedOpts.secret));
+            return preparedOpts.generateHeaderString(signature);
         },
     };
     const signature = {
@@ -191,6 +184,25 @@ export function createWebhooks(platformFunctions) {
         }
         return webhooksCryptoProviderInstance;
     }
+    function prepareOptions(opts) {
+        if (!opts) {
+            throw new StripeError({
+                message: 'Options are required',
+            });
+        }
+        const timestamp = Math.floor(opts.timestamp) || Math.floor(Date.now() / 1000);
+        const scheme = opts.scheme || signature.EXPECTED_SCHEME;
+        const cryptoProvider = opts.cryptoProvider || getCryptoProvider();
+        const payloadString = `${timestamp}.${opts.payload}`;
+        const generateHeaderString = (signature) => {
+            return `t=${timestamp},${scheme}=${signature}`;
+        };
+        return Object.assign(Object.assign({}, opts), { timestamp,
+            scheme,
+            cryptoProvider,
+            payloadString,
+            generateHeaderString });
+    }
     Webhook.signature = signature;
     return Webhook;
 }

package/esm/multipart.js

@@ -21,6 +21,9 @@ const multipartDataGenerator = (method, data, headers) => {
     }
     const flattenedData = flattenAndStringify(data);
     for (const k in flattenedData) {
+        if (!Object.prototype.hasOwnProperty.call(flattenedData, k)) {
+            continue;
+        }
         const v = flattenedData[k];
         push(`--${segno}`);
         if (Object.prototype.hasOwnProperty.call(v, 'data')) {

package/esm/stripe.core.js

@@ -1,12 +1,12 @@
 import * as _Error from './Error.js';
-import { ApiVersion } from './apiVersion.js';
-import * as resources from './resources.js';
-import { HttpClient, HttpClientResponse } from './net/HttpClient.js';
-import { determineProcessUserAgentProperties, pascalToCamelCase, validateInteger, } from './utils.js';
-import { CryptoProvider } from './crypto/CryptoProvider.js';
 import { RequestSender } from './RequestSender.js';
 import { StripeResource } from './StripeResource.js';
 import { createWebhooks } from './Webhooks.js';
+import { ApiVersion } from './apiVersion.js';
+import { CryptoProvider } from './crypto/CryptoProvider.js';
+import { HttpClient, HttpClientResponse } from './net/HttpClient.js';
+import * as resources from './resources.js';
+import { determineProcessUserAgentProperties, pascalToCamelCase, validateInteger, } from './utils.js';
 const DEFAULT_HOST = 'api.stripe.com';
 const DEFAULT_PORT = '443';
 const DEFAULT_BASE_PATH = '/v1/';
@@ -31,7 +31,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 = '16.3.0-beta.1';
+    Stripe.PACKAGE_VERSION = '16.4.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;
@@ -274,6 +274,9 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
                 var _a;
                 const userAgent = {};
                 for (const field in seed) {
+                    if (!Object.prototype.hasOwnProperty.call(seed, field)) {
+                        continue;
+                    }
                     userAgent[field] = encodeURIComponent((_a = seed[field]) !== null && _a !== void 0 ? _a : 'null');
                 }
                 // URI-encode in case there are unusual characters in the system's uname.
@@ -317,6 +320,9 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
          */
         _prepResources() {
             for (const name in resources) {
+                if (!Object.prototype.hasOwnProperty.call(resources, name)) {
+                    continue;
+                }
                 // @ts-ignore
                 this[pascalToCamelCase(name)] = new resources[name](this);
             }

package/package.json

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

package/types/BillingPortal/Sessions.d.ts

@@ -17,7 +17,7 @@ declare module 'stripe' {
        * Create sessions on-demand when customers intend to manage their subscriptions
        * and billing details.
        *
-       * Learn more in the [integration guide](https://stripe.com/docs/billing/subscriptions/integrating-customer-portal).
+       * Related guide: [Customer management](https://stripe.com/customer-management)
        */
       interface Session {
         /**

package/types/Capital/FinancingSummary.d.ts

@@ -82,7 +82,7 @@ declare module 'stripe' {
         namespace Details {
           interface CurrentRepaymentInterval {
             /**
-             * The time at which the minimum payment amount will be due. If not met through withholding, the Connected account's linked bank account will be debited.
+             * The time at which the minimum payment amount will be due. If not met through withholding, the Connected account's linked bank account or account balance will be debited.
              * Given in seconds since unix epoch.
              */
             due_at: number;

package/types/ConfirmationTokens.d.ts

@@ -50,7 +50,7 @@ declare module 'stripe' {
       /**
        * Payment-method-specific configuration for this ConfirmationToken.
        */
-      payment_method_options?: ConfirmationToken.PaymentMethodOptions | null;
+      payment_method_options: ConfirmationToken.PaymentMethodOptions | null;
 
       /**
        * Payment details collected by the Payment Element, used to create a PaymentMethod when a PaymentIntent or SetupIntent is confirmed with this ConfirmationToken.

package/types/CustomerSessions.d.ts

@@ -55,7 +55,7 @@ declare module 'stripe' {
         /**
          * This hash contains whether the Payment Element is enabled and the features it supports.
          */
-        payment_element?: Components.PaymentElement;
+        payment_element: Components.PaymentElement;
 
         /**
          * This hash contains whether the pricing table is enabled.

package/types/Disputes.d.ts

@@ -406,6 +406,7 @@ declare module 'stripe' {
 
             type Status =
               | 'accepted'
+              | 'not_qualified'
               | 'partner_rejected'
               | 'qualified'
               | 'requires_action'

package/types/FinancialConnections/Institutions.d.ts

@@ -4,7 +4,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace FinancialConnections {
       /**
-       * An institution represents a banking institution which may be available for an end user to select in the Financial Connections authentication flow.
+       * An institution represents a financial institution to which an end user can connect using the Financial Connections authentication flow.
        */
       interface Institution {
         /**
@@ -30,7 +30,7 @@ declare module 'stripe' {
         name: string;
 
         /**
-         * A list of routing numbers which are known to correspond to this institution.
+         * A list of routing numbers which are known to correspond to this institution. Due to the many to many relationship between institutions and routing numbers, this list may not be comprehensive and routing numbers may also be shared between institutions.
          */
         routing_numbers: Array<string>;
 
@@ -40,7 +40,7 @@ declare module 'stripe' {
         status: Institution.Status;
 
         /**
-         * The URL for this institution's website.
+         * A URL corresponding to this institution. This URL is also displayed in the authentication flow to help end users confirm that they are authenticating with the right institution.
          */
         url: string | null;
       }

package/types/Invoices.d.ts

@@ -868,10 +868,6 @@ declare module 'stripe' {
           | 'bank_account_unverified'
           | 'bank_account_verification_failed'
           | 'billing_invalid_mandate'
-          | 'billing_policy_remote_function_response_invalid'
-          | 'billing_policy_remote_function_timeout'
-          | 'billing_policy_remote_function_unexpected_status_code'
-          | 'billing_policy_remote_function_unreachable'
           | 'bitcoin_upgrade_required'
           | 'capture_charge_authorization_expired'
           | 'capture_unauthorized_payment'
@@ -949,7 +945,6 @@ declare module 'stripe' {
           | 'parameters_exclusive'
           | 'payment_intent_action_required'
           | 'payment_intent_authentication_failure'
-          | 'payment_intent_fx_quote_invalid'
           | 'payment_intent_incompatible_payment_method'
           | 'payment_intent_invalid_parameter'
           | 'payment_intent_konbini_rejected_confirmation_number'

package/types/PaymentIntents.d.ts

@@ -405,10 +405,6 @@ declare module 'stripe' {
           | 'bank_account_unverified'
           | 'bank_account_verification_failed'
           | 'billing_invalid_mandate'
-          | 'billing_policy_remote_function_response_invalid'
-          | 'billing_policy_remote_function_timeout'
-          | 'billing_policy_remote_function_unexpected_status_code'
-          | 'billing_policy_remote_function_unreachable'
           | 'bitcoin_upgrade_required'
           | 'capture_charge_authorization_expired'
           | 'capture_unauthorized_payment'
@@ -486,7 +482,6 @@ declare module 'stripe' {
           | 'parameters_exclusive'
           | 'payment_intent_action_required'
           | 'payment_intent_authentication_failure'
-          | 'payment_intent_fx_quote_invalid'
           | 'payment_intent_incompatible_payment_method'
           | 'payment_intent_invalid_parameter'
           | 'payment_intent_konbini_rejected_confirmation_number'

package/types/Plans.d.ts

@@ -106,7 +106,7 @@ declare module 'stripe' {
       /**
        * The meter tracking the usage of a metered price
        */
-      meter?: string | null;
+      meter: string | null;
 
       /**
        * A brief description of the plan, hidden from customers.

package/types/Prices.d.ts

@@ -280,7 +280,7 @@ declare module 'stripe' {
         /**
          * The meter tracking the usage of a metered price
          */
-        meter?: string | null;
+        meter: string | null;
 
         /**
          * Default number of trial days when subscribing a customer to this price using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan).

package/types/QuotePreviewInvoices.d.ts

@@ -845,10 +845,6 @@ declare module 'stripe' {
           | 'bank_account_unverified'
           | 'bank_account_verification_failed'
           | 'billing_invalid_mandate'
-          | 'billing_policy_remote_function_response_invalid'
-          | 'billing_policy_remote_function_timeout'
-          | 'billing_policy_remote_function_unexpected_status_code'
-          | 'billing_policy_remote_function_unreachable'
           | 'bitcoin_upgrade_required'
           | 'capture_charge_authorization_expired'
           | 'capture_unauthorized_payment'
@@ -926,7 +922,6 @@ declare module 'stripe' {
           | 'parameters_exclusive'
           | 'payment_intent_action_required'
           | 'payment_intent_authentication_failure'
-          | 'payment_intent_fx_quote_invalid'
           | 'payment_intent_incompatible_payment_method'
           | 'payment_intent_invalid_parameter'
           | 'payment_intent_konbini_rejected_confirmation_number'

package/types/SetupAttempts.d.ts

@@ -645,10 +645,6 @@ declare module 'stripe' {
           | 'bank_account_unverified'
           | 'bank_account_verification_failed'
           | 'billing_invalid_mandate'
-          | 'billing_policy_remote_function_response_invalid'
-          | 'billing_policy_remote_function_timeout'
-          | 'billing_policy_remote_function_unexpected_status_code'
-          | 'billing_policy_remote_function_unreachable'
           | 'bitcoin_upgrade_required'
           | 'capture_charge_authorization_expired'
           | 'capture_unauthorized_payment'
@@ -726,7 +722,6 @@ declare module 'stripe' {
           | 'parameters_exclusive'
           | 'payment_intent_action_required'
           | 'payment_intent_authentication_failure'
-          | 'payment_intent_fx_quote_invalid'
           | 'payment_intent_incompatible_payment_method'
           | 'payment_intent_invalid_parameter'
           | 'payment_intent_konbini_rejected_confirmation_number'

package/types/SetupIntents.d.ts

@@ -311,10 +311,6 @@ declare module 'stripe' {
           | 'bank_account_unverified'
           | 'bank_account_verification_failed'
           | 'billing_invalid_mandate'
-          | 'billing_policy_remote_function_response_invalid'
-          | 'billing_policy_remote_function_timeout'
-          | 'billing_policy_remote_function_unexpected_status_code'
-          | 'billing_policy_remote_function_unreachable'
           | 'bitcoin_upgrade_required'
           | 'capture_charge_authorization_expired'
           | 'capture_unauthorized_payment'
@@ -392,7 +388,6 @@ declare module 'stripe' {
           | 'parameters_exclusive'
           | 'payment_intent_action_required'
           | 'payment_intent_authentication_failure'
-          | 'payment_intent_fx_quote_invalid'
           | 'payment_intent_incompatible_payment_method'
           | 'payment_intent_invalid_parameter'
           | 'payment_intent_konbini_rejected_confirmation_number'

package/types/SubscriptionsResource.d.ts

@@ -2271,7 +2271,7 @@ declare module 'stripe' {
       /**
        * Updates an existing subscription to match the specified parameters.
        * When changing prices or quantities, we optionally prorate the price we charge next month to make up for any price changes.
-       * To preview how the proration is calculated, use the [upcoming invoice](https://stripe.com/docs/api/invoices/upcoming) endpoint.
+       * To preview how the proration is calculated, use the [create preview](https://stripe.com/docs/api/invoices/create_preview) endpoint.
        *
        * By default, we prorate subscription changes. For example, if a customer signs up on May 1 for a 100 price, they'll be billed 100 immediately. If on May 15 they switch to a 200 price, then on June 1 they'll be billed 250 (200 for a renewal of her subscription, plus a 50 prorating adjustment for half of the previous month's 100 difference). Similarly, a downgrade generates a credit that is applied to the next invoice. We also prorate when you make quantity changes.
        *
@@ -2279,11 +2279,11 @@ declare module 'stripe' {
        *
        *
        * The billing interval is changed (for example, from monthly to yearly).
-       * The subscription moves from free to paid, or paid to free.
+       * The subscription moves from free to paid.
        * A trial starts or ends.
        *
        *
-       * In these cases, we apply a credit for the unused time on the previous price, immediately charge the customer using the new price, and reset the billing date.
+       * In these cases, we apply a credit for the unused time on the previous price, immediately charge the customer using the new price, and reset the billing date. Learn about how [Stripe immediately attempts payment for subscription changes](https://stripe.com/billing/subscriptions/upgrade-downgrade#immediate-payment).
        *
        * If you want to charge for an upgrade immediately, pass proration_behavior as always_invoice to create prorations, automatically invoice the customer for those proration adjustments, and attempt to collect payment. If you pass create_prorations, the prorations are created but not automatically invoiced. If you want to bill the customer for the prorations before the subscription's renewal date, you need to manually [invoice the customer](https://stripe.com/docs/api/invoices/create).
        *