stripe 13.2.0 → 13.3.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 13.3.0 - 2023-08-24
+* [#1879](https://github.com/stripe/stripe-node/pull/1879) Update generated code
+  * Add support for `retention` on `BillingPortal.Session.flow.subscription_cancel` and `BillingPortal.SessionCreateParams.flow_data.subscription_cancel`
+  * Add support for `prefetch` on `Checkout.Session.payment_method_options.us_bank_account.financial_connections`, `Checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections`, `FinancialConnections.SessionCreateParams`, `FinancialConnections.Session`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntent.payment_method_options.us_bank_account.financial_connections`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`
+  * Add support for `payment_method_details` on `Dispute`
+  * Change type of `PaymentIntentCreateParams.mandate_data` and `SetupIntentCreateParams.mandate_data` from `secret_key_param` to `emptyStringable(secret_key_param)`
+  * Change type of `PaymentIntentConfirmParams.mandate_data` and `SetupIntentConfirmParams.mandate_data` from `secret_key_param | client_key_param` to `emptyStringable(secret_key_param | client_key_param)`
+  * Add support for `balance_transaction` on `CustomerCashBalanceTransaction.adjusted_for_overdraft`
+* [#1882](https://github.com/stripe/stripe-node/pull/1882) Update v13.0.0 CHANGELOG.md
+* [#1880](https://github.com/stripe/stripe-node/pull/1880) Improved `maxNetworkRetries` options JSDoc
+
 ## 13.2.0 - 2023-08-17
 * [#1876](https://github.com/stripe/stripe-node/pull/1876) Update generated code
   * Add support for `flat_amount` on `Tax.TransactionCreateReversalParams`
@@ -19,7 +30,7 @@
 * [#1872](https://github.com/stripe/stripe-node/pull/1872) Update generated code
   * ⚠️Add support for new values `verification_directors_mismatch`, `verification_document_directors_mismatch`, `verification_extraneous_directors`, and `verification_missing_directors` on enums `Account.future_requirements.errors[].code`, `Account.requirements.errors[].code`, `BankAccount.future_requirements.errors[].code`, and `BankAccount.requirements.errors[].code`
   * ⚠️Remove support for values `custom_account_update` and `custom_account_verification` from enum `AccountLinkCreateParams.type`
-    * These values are not fully operational
+    * These values are not fully operational. Please use `account_update` and `account_onboarding` instead (see [API reference](https://stripe.com/docs/api/account_links/create#create_account_link-type)).
   * ⚠️Remove support for `available_on` on `BalanceTransactionListParams`
     * Use of this parameter is discouraged. Suppress the Typescript error with `// @ts-ignore` or `any` if sending the parameter is still required.
   * ⚠️Remove support for `alternate_statement_descriptors` and `dispute` on `Charge`

package/VERSION

@@ -1 +1 @@
-13.2.0
+13.3.0

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 = '13.2.0';
+    Stripe.PACKAGE_VERSION = '13.3.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.resources = resources;

package/esm/stripe.core.js

@@ -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 = '13.2.0';
+    Stripe.PACKAGE_VERSION = '13.3.0';
     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": "13.2.0",
+  "version": "13.3.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/BillingPortal/Sessions.d.ts

@@ -138,12 +138,40 @@ declare module 'stripe' {
           }
 
           interface SubscriptionCancel {
+            /**
+             * Specify a retention strategy to be used in the cancellation flow.
+             */
+            retention: SubscriptionCancel.Retention | null;
+
             /**
              * The ID of the subscription to be canceled.
              */
             subscription: string;
           }
 
+          namespace SubscriptionCancel {
+            interface Retention {
+              /**
+               * Configuration when `retention.type=coupon_offer`.
+               */
+              coupon_offer: Retention.CouponOffer | null;
+
+              /**
+               * Type of retention strategy that will be used.
+               */
+              type: 'coupon_offer';
+            }
+
+            namespace Retention {
+              interface CouponOffer {
+                /**
+                 * The ID of the coupon to be offered.
+                 */
+                coupon: string;
+              }
+            }
+          }
+
           interface SubscriptionUpdate {
             /**
              * The ID of the subscription to be updated.

package/types/BillingPortal/SessionsResource.d.ts

@@ -105,12 +105,40 @@ declare module 'stripe' {
           }
 
           interface SubscriptionCancel {
+            /**
+             * Specify a retention strategy to be used in the cancellation flow.
+             */
+            retention?: SubscriptionCancel.Retention;
+
             /**
              * The ID of the subscription to be canceled.
              */
             subscription: string;
           }
 
+          namespace SubscriptionCancel {
+            interface Retention {
+              /**
+               * Configuration when `retention.type=coupon_offer`.
+               */
+              coupon_offer: Retention.CouponOffer;
+
+              /**
+               * Type of retention strategy to use with the customer.
+               */
+              type: 'coupon_offer';
+            }
+
+            namespace Retention {
+              interface CouponOffer {
+                /**
+                 * The ID of the coupon to be offered.
+                 */
+                coupon: string;
+              }
+            }
+          }
+
           interface SubscriptionUpdate {
             /**
              * The ID of the subscription to be updated.

package/types/Cards.d.ts

@@ -125,7 +125,7 @@ declare module 'stripe' {
       /**
        * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
        *
-       * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+       * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
        */
       fingerprint?: string | null;
 

package/types/Charges.d.ts

@@ -709,7 +709,7 @@ declare module 'stripe' {
           /**
            * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
            *
-           * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+           * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
            */
           fingerprint?: string | null;
 
@@ -1011,7 +1011,7 @@ declare module 'stripe' {
           /**
            * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
            *
-           * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+           * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
            */
           fingerprint: string | null;
 
@@ -1369,7 +1369,7 @@ declare module 'stripe' {
           /**
            * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
            *
-           * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+           * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
            */
           fingerprint: string | null;
 

package/types/Checkout/Sessions.d.ts

@@ -1275,6 +1275,11 @@ declare module 'stripe' {
                */
               permissions?: Array<FinancialConnections.Permission>;
 
+              /**
+               * Data features requested to be retrieved upon account creation.
+               */
+              prefetch: Array<'balances'> | null;
+
               /**
                * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
                */

package/types/Checkout/SessionsResource.d.ts

@@ -204,7 +204,7 @@ declare module 'stripe' {
         shipping_address_collection?: SessionCreateParams.ShippingAddressCollection;
 
         /**
-         * The shipping rate options to apply to this Session.
+         * The shipping rate options to apply to this Session. Up to a maximum of 5.
          */
         shipping_options?: Array<SessionCreateParams.ShippingOption>;
 
@@ -783,7 +783,7 @@ declare module 'stripe' {
           transfer_data?: PaymentIntentData.TransferData;
 
           /**
-           * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts) for details.
+           * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
            */
           transfer_group?: string;
         }
@@ -1524,6 +1524,11 @@ declare module 'stripe' {
                * The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included. Valid permissions include: `balances`, `ownership`, `payment_method`, and `transactions`.
                */
               permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * List of data features that you would like to retrieve upon account creation.
+               */
+              prefetch?: Array<'balances'>;
             }
 
             namespace FinancialConnections {

package/types/CustomerCashBalanceTransactions.d.ts

@@ -67,6 +67,11 @@ declare module 'stripe' {
 
     namespace CustomerCashBalanceTransaction {
       interface AdjustedForOverdraft {
+        /**
+         * The [Balance Transaction](docs/api/balance_transactions/object) that corresponds to funds taken out of your Stripe balance.
+         */
+        balance_transaction: string | Stripe.BalanceTransaction;
+
         /**
          * The [Cash Balance Transaction](https://stripe.com/docs/api/cash_balance_transactions/object) that brought the customer balance negative, triggering the clawback of funds.
          */

package/types/Disputes.d.ts

@@ -76,6 +76,8 @@ declare module 'stripe' {
        */
       payment_intent: string | Stripe.PaymentIntent | null;
 
+      payment_method_details?: Dispute.PaymentMethodDetails;
+
       /**
        * Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Read more about [dispute reasons](https://stripe.com/docs/disputes/categories).
        */
@@ -247,6 +249,32 @@ declare module 'stripe' {
         submission_count: number;
       }
 
+      interface PaymentMethodDetails {
+        /**
+         * Card specific dispute details.
+         */
+        card: PaymentMethodDetails.Card | null;
+
+        /**
+         * Payment method type.
+         */
+        type: 'card';
+      }
+
+      namespace PaymentMethodDetails {
+        interface Card {
+          /**
+           * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           */
+          brand: string;
+
+          /**
+           * The card network's specific dispute reason code, which maps to one of Stripe's primary dispute categories to simplify response guidance. The [Network code map](https://stripe.com/docs/disputes/categories#network-code-map) lists all available dispute reason codes by network.
+           */
+          network_reason_code: string | null;
+        }
+      }
+
       type Status =
         | 'lost'
         | 'needs_response'

package/types/FinancialConnections/Sessions.d.ts

@@ -44,6 +44,11 @@ declare module 'stripe' {
          */
         permissions: Array<Session.Permission>;
 
+        /**
+         * Data features requested to be retrieved upon account creation.
+         */
+        prefetch: Array<Session.Prefetch> | null;
+
         /**
          * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
          */
@@ -84,6 +89,8 @@ declare module 'stripe' {
           | 'ownership'
           | 'payment_method'
           | 'transactions';
+
+        type Prefetch = 'balances' | 'ownership';
       }
     }
   }

package/types/FinancialConnections/SessionsResource.d.ts

@@ -26,6 +26,11 @@ declare module 'stripe' {
          */
         filters?: SessionCreateParams.Filters;
 
+        /**
+         * List of data features that you would like to retrieve upon account creation.
+         */
+        prefetch?: Array<SessionCreateParams.Prefetch>;
+
         /**
          * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
          */
@@ -66,6 +71,8 @@ declare module 'stripe' {
           | 'ownership'
           | 'payment_method'
           | 'transactions';
+
+        type Prefetch = 'balances' | 'ownership';
       }
 
       interface SessionRetrieveParams {

package/types/Invoices.d.ts

@@ -1025,6 +1025,11 @@ declare module 'stripe' {
                * The list of permissions to request. The `payment_method` permission must be included.
                */
               permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * Data features requested to be retrieved upon account creation.
+               */
+              prefetch: Array<'balances'> | null;
             }
 
             namespace FinancialConnections {

package/types/InvoicesResource.d.ts

@@ -398,6 +398,11 @@ declare module 'stripe' {
                * The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included. Valid permissions include: `balances`, `ownership`, `payment_method`, and `transactions`.
                */
               permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * List of data features that you would like to retrieve upon account creation.
+               */
+              prefetch?: Array<'balances'>;
             }
 
             namespace FinancialConnections {
@@ -991,6 +996,11 @@ declare module 'stripe' {
                * The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included. Valid permissions include: `balances`, `ownership`, `payment_method`, and `transactions`.
                */
               permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * List of data features that you would like to retrieve upon account creation.
+               */
+              prefetch?: Array<'balances'>;
             }
 
             namespace FinancialConnections {

package/types/PaymentIntents.d.ts

@@ -218,7 +218,7 @@ declare module 'stripe' {
       transfer_data: PaymentIntent.TransferData | null;
 
       /**
-       * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts) for details.
+       * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
        */
       transfer_group: string | null;
     }
@@ -1963,6 +1963,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * Data features requested to be retrieved upon account creation.
+             */
+            prefetch: Array<'balances'> | null;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */

package/types/PaymentIntentsResource.d.ts

@@ -67,7 +67,7 @@ declare module 'stripe' {
       /**
        * This hash contains details about the Mandate to create. This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-confirm).
        */
-      mandate_data?: PaymentIntentCreateParams.MandateData;
+      mandate_data?: Stripe.Emptyable<PaymentIntentCreateParams.MandateData>;
 
       /**
        * 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`.
@@ -154,7 +154,7 @@ declare module 'stripe' {
       transfer_data?: PaymentIntentCreateParams.TransferData;
 
       /**
-       * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts) for details.
+       * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
        */
       transfer_group?: string;
 
@@ -1903,6 +1903,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * List of data features that you would like to retrieve upon account creation.
+             */
+            prefetch?: Array<'balances'>;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */
@@ -3825,6 +3830,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * List of data features that you would like to retrieve upon account creation.
+             */
+            prefetch?: Array<'balances'>;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */
@@ -4066,9 +4076,10 @@ declare module 'stripe' {
       /**
        * This hash contains details about the Mandate to create
        */
-      mandate_data?:
+      mandate_data?: Stripe.Emptyable<
         | PaymentIntentConfirmParams.MandateData1
-        | PaymentIntentConfirmParams.MandateData2;
+        | PaymentIntentConfirmParams.MandateData2
+      >;
 
       /**
        * Set to `true` to indicate that the customer is not in your checkout flow during this payment attempt, and therefore is unable to authenticate. This parameter is intended for scenarios where you collect card details and [charge them later](https://stripe.com/docs/payments/cards/charging-saved-cards).
@@ -5887,6 +5898,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * List of data features that you would like to retrieve upon account creation.
+             */
+            prefetch?: Array<'balances'>;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */

package/types/PaymentMethods.d.ts

@@ -254,7 +254,7 @@ declare module 'stripe' {
         /**
          * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
          *
-         * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+         * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
          */
         fingerprint?: string | null;
 
@@ -457,7 +457,7 @@ declare module 'stripe' {
         /**
          * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
          *
-         * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+         * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
          */
         fingerprint: string | null;
 
@@ -691,7 +691,7 @@ declare module 'stripe' {
         /**
          * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
          *
-         * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+         * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
          */
         fingerprint: string | null;
 

package/types/Payouts.d.ts

@@ -95,7 +95,7 @@ declare module 'stripe' {
       metadata: Stripe.Metadata | null;
 
       /**
-       * The method used to send this payout, which can be `standard` or `instant`. `instant` is only supported for payouts to debit cards. (See [Instant payouts for marketplaces](https://stripe.com/blog/instant-payouts-for-marketplaces) for more information.)
+       * The method used to send this payout, which can be `standard` or `instant`. `instant` is supported for payouts to debit cards and bank accounts in certain countries. (See [Bank support for Instant Payouts](https://stripe.com/docs/payouts/instant-payouts-banks) for more information.)
        */
       method: string;
 

package/types/PayoutsResource.d.ts

@@ -34,7 +34,7 @@ declare module 'stripe' {
       metadata?: Stripe.MetadataParam;
 
       /**
-       * The method used to send this payout, which can be `standard` or `instant`. `instant` is only supported for payouts to debit cards. (See [Instant payouts for marketplaces for more information](https://stripe.com/blog/instant-payouts-for-marketplaces).)
+       * The method used to send this payout, which can be `standard` or `instant`. `instant` is supported for payouts to debit cards and bank accounts in certain countries. (See [Bank support for Instant Payouts](https://stripe.com/docs/payouts/instant-payouts-banks) for more information.)
        */
       method?: PayoutCreateParams.Method;
 

package/types/SetupAttempts.d.ts

@@ -217,7 +217,7 @@ declare module 'stripe' {
           /**
            * Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
            *
-           * *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*
+           * *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*
            */
           fingerprint?: string | null;
 

package/types/SetupIntents.d.ts

@@ -737,6 +737,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * Data features requested to be retrieved upon account creation.
+             */
+            prefetch: Array<'balances'> | null;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */

package/types/SetupIntentsResource.d.ts

@@ -47,7 +47,7 @@ declare module 'stripe' {
       /**
        * This hash contains details about the Mandate to create. This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/setup_intents/create#create_setup_intent-confirm).
        */
-      mandate_data?: SetupIntentCreateParams.MandateData;
+      mandate_data?: Stripe.Emptyable<SetupIntentCreateParams.MandateData>;
 
       /**
        * 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`.
@@ -955,6 +955,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * List of data features that you would like to retrieve upon account creation.
+             */
+            prefetch?: Array<'balances'>;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */
@@ -1857,6 +1862,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * List of data features that you would like to retrieve upon account creation.
+             */
+            prefetch?: Array<'balances'>;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */
@@ -1944,9 +1954,10 @@ declare module 'stripe' {
       /**
        * This hash contains details about the Mandate to create
        */
-      mandate_data?:
+      mandate_data?: Stripe.Emptyable<
         | SetupIntentConfirmParams.MandateData1
-        | SetupIntentConfirmParams.MandateData2;
+        | SetupIntentConfirmParams.MandateData2
+      >;
 
       /**
        * ID of the payment method (a PaymentMethod, Card, or saved Source object) to attach to this SetupIntent.
@@ -2846,6 +2857,11 @@ declare module 'stripe' {
              */
             permissions?: Array<FinancialConnections.Permission>;
 
+            /**
+             * List of data features that you would like to retrieve upon account creation.
+             */
+            prefetch?: Array<'balances'>;
+
             /**
              * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
              */

package/types/Subscriptions.d.ts

@@ -493,6 +493,11 @@ declare module 'stripe' {
                * The list of permissions to request. The `payment_method` permission must be included.
                */
               permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * Data features requested to be retrieved upon account creation.
+               */
+              prefetch: Array<'balances'> | null;
             }
 
             namespace FinancialConnections {

package/types/SubscriptionsResource.d.ts

@@ -564,6 +564,11 @@ declare module 'stripe' {
                * The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included. Valid permissions include: `balances`, `ownership`, `payment_method`, and `transactions`.
                */
               permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * List of data features that you would like to retrieve upon account creation.
+               */
+              prefetch?: Array<'balances'>;
             }
 
             namespace FinancialConnections {
@@ -1277,6 +1282,11 @@ declare module 'stripe' {
                * The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included. Valid permissions include: `balances`, `ownership`, `payment_method`, and `transactions`.
                */
               permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * List of data features that you would like to retrieve upon account creation.
+               */
+              prefetch?: Array<'balances'>;
             }
 
             namespace FinancialConnections {

package/types/lib.d.ts

@@ -53,8 +53,10 @@ declare module 'stripe' {
       typescript?: true;
 
       /**
-       * Enables automatic network retries with exponential backoff, up to the specified number of retries (default 0).
-       * Idempotency keys](https://stripe.com/docs/api/idempotent_requests) are added where appropriate to prevent duplication.
+       * Specifies maximum number of automatic network retries (default 1).
+       * Retries will be attempted with exponential backoff.
+       * Retries can be disabled by setting this option to 0.
+       * [Idempotency keys](https://stripe.com/docs/api/idempotent_requests) are added where appropriate to prevent duplication.
        * @docs https://github.com/stripe/stripe-node#network-retries
        */
       maxNetworkRetries?: number;