stripe 16.2.0-beta.1 → 16.3.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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`.
+  * Add support for new resource `FinancialConnections.Institution`
+  * 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[]`
+
 ## 16.2.0-beta.1 - 2024-06-27
 * [#2110](https://github.com/stripe/stripe-node/pull/2110) Update generated code for beta
   * Remove support for `payment_method_set_as_default` on `CustomerSession.components.payment_element.features` and `CustomerSessionCreateParams.components.payment_element.features`

package/VERSION

@@ -1 +1 @@
-16.2.0-beta.1
+16.3.0-beta.1

package/cjs/resources/FinancialConnections/Institutions.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Institutions = void 0;
+const StripeResource_js_1 = require("../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Institutions = StripeResource_js_1.StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/financial_connections/institutions/{institution}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/financial_connections/institutions',
+        methodType: 'list',
+    }),
+});

package/cjs/resources.js

@@ -31,6 +31,7 @@ const FinancingTransactions_js_1 = require("./resources/Capital/FinancingTransac
 const Forms_js_1 = require("./resources/Tax/Forms.js");
 const InboundTransfers_js_1 = require("./resources/TestHelpers/Treasury/InboundTransfers.js");
 const InboundTransfers_js_2 = require("./resources/Treasury/InboundTransfers.js");
+const Institutions_js_1 = require("./resources/FinancialConnections/Institutions.js");
 const Locations_js_1 = require("./resources/Terminal/Locations.js");
 const MeterEventAdjustments_js_1 = require("./resources/Billing/MeterEventAdjustments.js");
 const MeterEvents_js_1 = require("./resources/Billing/MeterEvents.js");
@@ -216,6 +217,7 @@ exports.Entitlements = (0, ResourceNamespace_js_1.resourceNamespace)('entitlemen
 });
 exports.FinancialConnections = (0, ResourceNamespace_js_1.resourceNamespace)('financialConnections', {
     Accounts: Accounts_js_1.Accounts,
+    Institutions: Institutions_js_1.Institutions,
     Sessions: Sessions_js_3.Sessions,
     Transactions: Transactions_js_2.Transactions,
 });

package/cjs/stripe.core.js

@@ -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.2.0-beta.1';
+    Stripe.PACKAGE_VERSION = '16.3.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/resources/FinancialConnections/Institutions.js

@@ -0,0 +1,14 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Institutions = StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/financial_connections/institutions/{institution}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/financial_connections/institutions',
+        methodType: 'list',
+    }),
+});

package/esm/resources.js

@@ -27,6 +27,7 @@ import { FinancingTransactions as CapitalFinancingTransactions } from './resourc
 import { Forms as TaxForms } from './resources/Tax/Forms.js';
 import { InboundTransfers as TestHelpersTreasuryInboundTransfers } from './resources/TestHelpers/Treasury/InboundTransfers.js';
 import { InboundTransfers as TreasuryInboundTransfers } from './resources/Treasury/InboundTransfers.js';
+import { Institutions as FinancialConnectionsInstitutions } from './resources/FinancialConnections/Institutions.js';
 import { Locations as TerminalLocations } from './resources/Terminal/Locations.js';
 import { MeterEventAdjustments as BillingMeterEventAdjustments } from './resources/Billing/MeterEventAdjustments.js';
 import { MeterEvents as BillingMeterEvents } from './resources/Billing/MeterEvents.js';
@@ -156,6 +157,7 @@ export const Entitlements = resourceNamespace('entitlements', {
 });
 export const FinancialConnections = resourceNamespace('financialConnections', {
     Accounts: FinancialConnectionsAccounts,
+    Institutions: FinancialConnectionsInstitutions,
     Sessions: FinancialConnectionsSessions,
     Transactions: FinancialConnectionsTransactions,
 });

package/esm/stripe.core.js

@@ -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.2.0-beta.1';
+    Stripe.PACKAGE_VERSION = '16.3.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": "16.2.0-beta.1",
+  "version": "16.3.0-beta.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Billing/MeterEventSummaries.d.ts

@@ -24,7 +24,7 @@ declare module 'stripe' {
         aggregated_value: number;
 
         /**
-         * End timestamp for this event summary (inclusive).
+         * End timestamp for this event summary (exclusive). Must be aligned with minute boundaries.
          */
         end_time: number;
 
@@ -39,7 +39,7 @@ declare module 'stripe' {
         meter: string;
 
         /**
-         * Start timestamp for this event summary (inclusive).
+         * Start timestamp for this event summary (inclusive). Must be aligned with minute boundaries.
          */
         start_time: number;
       }

package/types/Billing/MetersResource.d.ts

@@ -123,12 +123,12 @@ declare module 'stripe' {
         customer: string;
 
         /**
-         * The timestamp from when to stop aggregating meter events (exclusive).
+         * The timestamp from when to stop aggregating meter events (exclusive). Must be aligned with minute boundaries.
          */
         end_time: number;
 
         /**
-         * The timestamp from when to start aggregating meter events (inclusive).
+         * The timestamp from when to start aggregating meter events (inclusive). Must be aligned with minute boundaries.
          */
         start_time: number;
 

package/types/Checkout/Sessions.d.ts

@@ -1547,6 +1547,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * The institution to use to filter for possible accounts to link.
+                 */
+                institution?: string;
               }
 
               namespace Filters {

package/types/CustomerSessions.d.ts

@@ -3,8 +3,8 @@
 declare module 'stripe' {
   namespace Stripe {
     /**
-     * A customer session allows you to grant client access to Stripe's frontend SDKs (like StripeJs)
-     * control over a customer.
+     * A Customer Session allows you to grant Stripe's frontend SDKs (like Stripe.js) client-side access
+     * control over a Customer.
      */
     interface CustomerSession {
       /**
@@ -13,14 +13,14 @@ declare module 'stripe' {
       object: 'customer_session';
 
       /**
-       * The client secret of this customer session. Used on the client to set up secure access to the given `customer`.
+       * The client secret of this Customer Session. Used on the client to set up secure access to the given `customer`.
        *
        * The client secret can be used to provide access to `customer` from your frontend. It should not be stored, logged, or exposed to anyone other than the relevant customer. Make sure that you have TLS enabled on any page that includes the client secret.
        */
       client_secret: string;
 
       /**
-       * Configuration for the components supported by this customer session.
+       * Configuration for the components supported by this Customer Session.
        */
       components?: CustomerSession.Components;
 
@@ -30,12 +30,12 @@ declare module 'stripe' {
       created: number;
 
       /**
-       * The customer the customer session was created for.
+       * The Customer the Customer Session was created for.
        */
       customer: string | Stripe.Customer;
 
       /**
-       * The timestamp at which this customer session will expire.
+       * The timestamp at which this Customer Session will expire.
        */
       expires_at: number;
 
@@ -53,7 +53,7 @@ declare module 'stripe' {
         buy_button: Components.BuyButton;
 
         /**
-         * This hash contains whether the payment element is enabled and the features it supports.
+         * This hash contains whether the Payment Element is enabled and the features it supports.
          */
         payment_element?: Components.PaymentElement;
 
@@ -73,12 +73,12 @@ declare module 'stripe' {
 
         interface PaymentElement {
           /**
-           * Whether the payment element is enabled.
+           * Whether the Payment Element is enabled.
            */
           enabled: boolean;
 
           /**
-           * This hash defines whether the payment element supports certain features.
+           * This hash defines whether the Payment Element supports certain features.
            */
           features: PaymentElement.Features | null;
         }
@@ -86,31 +86,59 @@ declare module 'stripe' {
         namespace PaymentElement {
           interface Features {
             /**
-             * Controls whether the Payment Element displays the option to remove a saved payment method."
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the Payment Element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
+             */
+            payment_method_redisplay: Features.PaymentMethodRedisplay;
+
+            /**
+             * Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `10`.
+             */
+            payment_method_redisplay_limit: number | null;
+
+            /**
+             * Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
              *
              * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
              */
             payment_method_remove: Features.PaymentMethodRemove;
 
             /**
-             * Controls whether the Payment Element displays a checkbox offering to save a new payment method.
+             * Controls whether the Payment Element displays a checkbox offering to save a new payment method. This parameter defaults to `disabled`.
              *
              * If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
              */
             payment_method_save: Features.PaymentMethodSave;
 
             /**
-             * Controls whether the Payment Element displays the option to update a saved payment method.
+             * When using PaymentIntents and the customer checks the save checkbox, this field determines the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value used to confirm the PaymentIntent.
+             *
+             * When using SetupIntents, directly configure the [`usage`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-usage) value on SetupIntent creation.
              */
-            payment_method_update: Features.PaymentMethodUpdate;
+            payment_method_save_usage: Features.PaymentMethodSaveUsage | null;
           }
 
           namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRedisplay = 'disabled' | 'enabled';
+
             type PaymentMethodRemove = 'disabled' | 'enabled';
 
             type PaymentMethodSave = 'disabled' | 'enabled';
 
-            type PaymentMethodUpdate = 'disabled' | 'enabled';
+            type PaymentMethodSaveUsage = 'off_session' | 'on_session';
           }
         }
 

package/types/CustomerSessionsResource.d.ts

@@ -9,7 +9,7 @@ declare module 'stripe' {
       components: CustomerSessionCreateParams.Components;
 
       /**
-       * The ID of an existing customer for which to create the customer session.
+       * The ID of an existing customer for which to create the Customer Session.
        */
       customer: string;
 
@@ -27,7 +27,7 @@ declare module 'stripe' {
         buy_button?: Components.BuyButton;
 
         /**
-         * Configuration for the payment element.
+         * Configuration for the Payment Element.
          */
         payment_element?: Components.PaymentElement;
 
@@ -47,12 +47,12 @@ declare module 'stripe' {
 
         interface PaymentElement {
           /**
-           * Whether the payment element is enabled.
+           * Whether the Payment Element is enabled.
            */
           enabled: boolean;
 
           /**
-           * This hash defines whether the payment element supports certain features.
+           * This hash defines whether the Payment Element supports certain features.
            */
           features?: PaymentElement.Features;
         }
@@ -60,31 +60,59 @@ declare module 'stripe' {
         namespace PaymentElement {
           interface Features {
             /**
-             * Controls whether the Payment Element displays the option to remove a saved payment method."
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the Payment Element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters?: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
+             */
+            payment_method_redisplay?: Features.PaymentMethodRedisplay;
+
+            /**
+             * Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `10`.
+             */
+            payment_method_redisplay_limit?: number;
+
+            /**
+             * Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
              *
              * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
              */
             payment_method_remove?: Features.PaymentMethodRemove;
 
             /**
-             * Controls whether the Payment Element displays a checkbox offering to save a new payment method.
+             * Controls whether the Payment Element displays a checkbox offering to save a new payment method. This parameter defaults to `disabled`.
              *
              * If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
              */
             payment_method_save?: Features.PaymentMethodSave;
 
             /**
-             * Controls whether the Payment Element displays the option to update a saved payment method.
+             * When using PaymentIntents and the customer checks the save checkbox, this field determines the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value used to confirm the PaymentIntent.
+             *
+             * When using SetupIntents, directly configure the [`usage`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-usage) value on SetupIntent creation.
              */
-            payment_method_update?: Features.PaymentMethodUpdate;
+            payment_method_save_usage?: Features.PaymentMethodSaveUsage;
           }
 
           namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRedisplay = 'disabled' | 'enabled';
+
             type PaymentMethodRemove = 'disabled' | 'enabled';
 
             type PaymentMethodSave = 'disabled' | 'enabled';
 
-            type PaymentMethodUpdate = 'disabled' | 'enabled';
+            type PaymentMethodSaveUsage = 'off_session' | 'on_session';
           }
         }
 
@@ -99,7 +127,7 @@ declare module 'stripe' {
 
     class CustomerSessionsResource {
       /**
-       * Creates a customer session object that includes a single-use client secret that you can use on your front-end to grant client-side API access for certain customer resources.
+       * Creates a Customer Session object that includes a single-use client secret that you can use on your front-end to grant client-side API access for certain customer resources.
        */
       create(
         params: CustomerSessionCreateParams,

package/types/Customers.d.ts

@@ -109,7 +109,7 @@ declare module 'stripe' {
       name?: string | null;
 
       /**
-       * The suffix of the customer's next invoice number (for example, 0001).
+       * The suffix of the customer's next invoice number (for example, 0001). When the account uses account level sequencing, this parameter is ignored in API requests and the field omitted in API responses.
        */
       next_invoice_sequence?: number;
 

package/types/EventTypes.d.ts

@@ -1271,7 +1271,7 @@ declare module 'stripe' {
     }
 
     /**
-     * Occurs whenever a card or source will expire at the end of the month.
+     * Occurs whenever a card or source will expire at the end of the month. This event only works with legacy integrations using Card or Source objects. If you use the PaymentMethod API, this event won't occur.
      */
     interface CustomerSourceExpiringEvent extends EventBase {
       type: 'customer.source.expiring';

package/types/FinancialConnections/Accounts.d.ts

@@ -283,7 +283,7 @@ declare module 'stripe' {
           | 'other'
           | 'savings';
 
-        type Subscription = 'inferred_balances' | 'transactions';
+        type Subscription = 'balance' | 'inferred_balances' | 'transactions';
 
         type SupportedPaymentMethodType = 'link' | 'us_bank_account';
 

package/types/FinancialConnections/AccountsResource.d.ts

@@ -100,7 +100,7 @@ declare module 'stripe' {
       }
 
       namespace AccountSubscribeParams {
-        type Feature = 'inferred_balances' | 'transactions';
+        type Feature = 'balance' | 'inferred_balances' | 'transactions';
       }
 
       interface AccountUnsubscribeParams {
@@ -116,7 +116,7 @@ declare module 'stripe' {
       }
 
       namespace AccountUnsubscribeParams {
-        type Feature = 'inferred_balances' | 'transactions';
+        type Feature = 'balance' | 'inferred_balances' | 'transactions';
       }
 
       class AccountsResource {

package/types/FinancialConnections/Institutions.d.ts

@@ -0,0 +1,93 @@
+// File generated from our OpenAPI spec
+
+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.
+       */
+      interface Institution {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'financial_connections.institution';
+
+        features: Institution.Features;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        /**
+         * The name of this institution.
+         */
+        name: string;
+
+        /**
+         * A list of routing numbers which are known to correspond to this institution.
+         */
+        routing_numbers: Array<string>;
+
+        /**
+         * The status of this institution in the Financial Connections authentication flow.
+         */
+        status: Institution.Status;
+
+        /**
+         * The URL for this institution's website.
+         */
+        url: string | null;
+      }
+
+      namespace Institution {
+        interface Features {
+          balances: Features.Balances;
+
+          ownership: Features.Ownership;
+
+          payment_method: Features.PaymentMethod;
+
+          transactions: Features.Transactions;
+        }
+
+        namespace Features {
+          interface Balances {
+            /**
+             * Whether the given feature is supported by this institution.
+             */
+            supported: boolean;
+          }
+
+          interface Ownership {
+            /**
+             * Whether the given feature is supported by this institution.
+             */
+            supported: boolean;
+          }
+
+          interface PaymentMethod {
+            /**
+             * Whether the given feature is supported by this institution.
+             */
+            supported: boolean;
+          }
+
+          interface Transactions {
+            /**
+             * Whether the given feature is supported by this institution.
+             */
+            supported: boolean;
+          }
+        }
+
+        type Status = 'active' | 'degraded' | 'inactive';
+      }
+    }
+  }
+}

package/types/FinancialConnections/InstitutionsResource.d.ts

@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace FinancialConnections {
+      interface InstitutionRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface InstitutionListParams extends PaginationParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class InstitutionsResource {
+        /**
+         * Retrieves the details of a Financial Connections Institution.
+         */
+        retrieve(
+          id: string,
+          params?: InstitutionRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.FinancialConnections.Institution>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.FinancialConnections.Institution>>;
+
+        /**
+         * Returns a list of Financial Connections Institution objects.
+         */
+        list(
+          params?: InstitutionListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.FinancialConnections.Institution>;
+        list(
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.FinancialConnections.Institution>;
+      }
+    }
+  }
+}

package/types/FinancialConnections/Sessions.d.ts

@@ -98,6 +98,11 @@ declare module 'stripe' {
            * List of countries from which to filter accounts.
            */
           countries: Array<string> | null;
+
+          /**
+           * Stripe ID of the institution with which the customer should be directed to log in.
+           */
+          institution?: string;
         }
 
         namespace Filters {

package/types/FinancialConnections/SessionsResource.d.ts

@@ -79,6 +79,11 @@ declare module 'stripe' {
            * List of countries from which to collect accounts.
            */
           countries?: Array<string>;
+
+          /**
+           * Stripe ID of the institution with which the customer should be directed to log in.
+           */
+          institution?: string;
         }
 
         namespace Filters {

package/types/Invoices.d.ts

@@ -896,6 +896,7 @@ declare module 'stripe' {
           | 'email_invalid'
           | 'expired_card'
           | 'financial_connections_account_inactive'
+          | 'financial_connections_institution_unavailable'
           | 'financial_connections_no_successful_transaction_refresh'
           | 'forwarding_api_inactive'
           | 'forwarding_api_invalid_parameter'
@@ -948,6 +949,7 @@ 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'
@@ -1208,6 +1210,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * The institution to use to filter for possible accounts to link.
+                 */
+                institution?: string;
               }
 
               namespace Filters {

package/types/InvoicesResource.d.ts

@@ -551,6 +551,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * ID of the institution to use to filter for selectable accounts.
+                 */
+                institution?: string;
               }
 
               namespace Filters {
@@ -1324,6 +1329,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * ID of the institution to use to filter for selectable accounts.
+                 */
+                institution?: string;
               }
 
               namespace Filters {
@@ -8977,7 +8987,7 @@ declare module 'stripe' {
       expand?: 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`. For `type=recurring` line items, the incoming metadata specified on the request is directly used to set this value, in contrast to `type=invoiceitem` line items, where any existing metadata on the invoice line is merged with the incoming data.
+       * 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`. For [type=subscription](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data.
        */
       invoice_metadata?: Stripe.Emptyable<{
         [key: string]: string;
@@ -9017,7 +9027,7 @@ declare module 'stripe' {
         margins?: Stripe.Emptyable<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`. For `type=recurring` line items, the incoming metadata specified on the request is directly used to set this value, in contrast to `type=invoiceitem` line items, where any existing metadata on the invoice line is merged with the incoming data.
+         * 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`. For [type=subscription](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data.
          */
         metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
@@ -9302,7 +9312,7 @@ declare module 'stripe' {
       margins?: Stripe.Emptyable<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`. For `type=recurring` line items, the incoming metadata specified on the request is directly used to set this value, in contrast to `type=invoiceitem` line items, where any existing metadata on the invoice line is merged with the incoming data.
+       * 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`. For [type=subscription](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data.
        */
       metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 

package/types/PaymentIntents.d.ts

@@ -433,6 +433,7 @@ declare module 'stripe' {
           | 'email_invalid'
           | 'expired_card'
           | 'financial_connections_account_inactive'
+          | 'financial_connections_institution_unavailable'
           | 'financial_connections_no_successful_transaction_refresh'
           | 'forwarding_api_inactive'
           | 'forwarding_api_invalid_parameter'
@@ -485,6 +486,7 @@ 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'
@@ -2745,6 +2747,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * The institution to use to filter for possible accounts to link.
+               */
+              institution?: string;
             }
 
             namespace Filters {

package/types/PaymentIntentsResource.d.ts

@@ -3158,6 +3158,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * ID of the institution to use to filter for selectable accounts.
+               */
+              institution?: string;
             }
 
             namespace Filters {
@@ -6387,6 +6392,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * ID of the institution to use to filter for selectable accounts.
+               */
+              institution?: string;
             }
 
             namespace Filters {
@@ -10340,6 +10350,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * ID of the institution to use to filter for selectable accounts.
+               */
+              institution?: string;
             }
 
             namespace Filters {

package/types/QuotePreviewInvoices.d.ts

@@ -873,6 +873,7 @@ declare module 'stripe' {
           | 'email_invalid'
           | 'expired_card'
           | 'financial_connections_account_inactive'
+          | 'financial_connections_institution_unavailable'
           | 'financial_connections_no_successful_transaction_refresh'
           | 'forwarding_api_inactive'
           | 'forwarding_api_invalid_parameter'
@@ -925,6 +926,7 @@ 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'
@@ -1185,6 +1187,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * The institution to use to filter for possible accounts to link.
+                 */
+                institution?: string;
               }
 
               namespace Filters {

package/types/SetupAttempts.d.ts

@@ -673,6 +673,7 @@ declare module 'stripe' {
           | 'email_invalid'
           | 'expired_card'
           | 'financial_connections_account_inactive'
+          | 'financial_connections_institution_unavailable'
           | 'financial_connections_no_successful_transaction_refresh'
           | 'forwarding_api_inactive'
           | 'forwarding_api_invalid_parameter'
@@ -725,6 +726,7 @@ 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

@@ -339,6 +339,7 @@ declare module 'stripe' {
           | 'email_invalid'
           | 'expired_card'
           | 'financial_connections_account_inactive'
+          | 'financial_connections_institution_unavailable'
           | 'financial_connections_no_successful_transaction_refresh'
           | 'forwarding_api_inactive'
           | 'forwarding_api_invalid_parameter'
@@ -391,6 +392,7 @@ 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'
@@ -887,6 +889,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * The institution to use to filter for possible accounts to link.
+               */
+              institution?: string;
             }
 
             namespace Filters {

package/types/SetupIntentsResource.d.ts

@@ -1307,6 +1307,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * ID of the institution to use to filter for selectable accounts.
+               */
+              institution?: string;
             }
 
             namespace Filters {
@@ -2577,6 +2582,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * ID of the institution to use to filter for selectable accounts.
+               */
+              institution?: string;
             }
 
             namespace Filters {
@@ -3896,6 +3906,11 @@ declare module 'stripe' {
                * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                */
               account_subcategories?: Array<Filters.AccountSubcategory>;
+
+              /**
+               * ID of the institution to use to filter for selectable accounts.
+               */
+              institution?: string;
             }
 
             namespace Filters {

package/types/Subscriptions.d.ts

@@ -613,6 +613,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * The institution to use to filter for possible accounts to link.
+                 */
+                institution?: string;
               }
 
               namespace Filters {

package/types/SubscriptionsResource.d.ts

@@ -903,6 +903,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * ID of the institution to use to filter for selectable accounts.
+                 */
+                institution?: string;
               }
 
               namespace Filters {
@@ -1932,6 +1937,11 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * ID of the institution to use to filter for selectable accounts.
+                 */
+                institution?: string;
               }
 
               namespace Filters {

package/types/Tax/Transactions.d.ts

@@ -51,6 +51,11 @@ declare module 'stripe' {
          */
         metadata: Stripe.Metadata | null;
 
+        /**
+         * The Unix timestamp representing when the tax liability is assumed or reduced.
+         */
+        posted_at: number;
+
         /**
          * A custom unique identifier, such as 'myOrder_123'.
          */

package/types/Tax/TransactionsResource.d.ts

@@ -30,6 +30,11 @@ declare module 'stripe' {
          * 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 Unix timestamp representing when the tax liability is assumed or reduced, which determines the liability posting period and handling in tax liability reports. The timestamp must fall within the `tax_date` and the current time, unless the `tax_date` is scheduled in advance. Defaults to the current time.
+         */
+        posted_at?: number;
       }
 
       interface TransactionCreateReversalParams {

package/types/index.d.ts

@@ -46,6 +46,7 @@
 ///<reference path='./FileLinksResource.d.ts' />
 ///<reference path='./FilesResource.d.ts' />
 ///<reference path='./FinancialConnections/AccountsResource.d.ts' />
+///<reference path='./FinancialConnections/InstitutionsResource.d.ts' />
 ///<reference path='./FinancialConnections/SessionsResource.d.ts' />
 ///<reference path='./FinancialConnections/TransactionsResource.d.ts' />
 ///<reference path='./Forwarding/RequestsResource.d.ts' />
@@ -190,6 +191,7 @@
 ///<reference path='./FinancialConnections/AccountOwners.d.ts' />
 ///<reference path='./FinancialConnections/AccountOwnerships.d.ts' />
 ///<reference path='./FinancialConnections/Accounts.d.ts' />
+///<reference path='./FinancialConnections/Institutions.d.ts' />
 ///<reference path='./FinancialConnections/Sessions.d.ts' />
 ///<reference path='./FinancialConnections/Transactions.d.ts' />
 ///<reference path='./Forwarding/Requests.d.ts' />
@@ -390,6 +392,7 @@ declare module 'stripe' {
     };
     financialConnections: {
       accounts: Stripe.FinancialConnections.AccountsResource;
+      institutions: Stripe.FinancialConnections.InstitutionsResource;
       sessions: Stripe.FinancialConnections.SessionsResource;
       transactions: Stripe.FinancialConnections.TransactionsResource;
     };