stripe 19.2.0-beta.1 → 19.3.0-beta.1

package/types/V2/Core/AccountsResource.d.ts

@@ -121,6 +121,7 @@ declare module 'stripe' {
                 type LocationSource =
                   | 'identity_address'
                   | 'ip_address'
+                  | 'payment_method'
                   | 'shipping_address';
               }
 
@@ -1056,6 +1057,11 @@ declare module 'stripe' {
                    * Can hold storage-type funds on Stripe in GBP.
                    */
                   gbp?: HoldsCurrencies.Gbp;
+
+                  /**
+                   * Can hold storage-type funds on Stripe in USD.
+                   */
+                  usd?: HoldsCurrencies.Usd;
                 }
 
                 namespace HoldsCurrencies {
@@ -1065,6 +1071,13 @@ declare module 'stripe' {
                      */
                     requested: boolean;
                   }
+
+                  interface Usd {
+                    /**
+                     * To request a new Capability for an account, pass true. There can be a delay before the requested Capability becomes active.
+                     */
+                    requested: boolean;
+                  }
                 }
 
                 interface InboundTransfers {
@@ -1295,7 +1308,11 @@ declare module 'stripe' {
             }
 
             namespace Responsibilities {
-              type FeesCollector = 'application' | 'stripe';
+              type FeesCollector =
+                | 'application'
+                | 'application_custom'
+                | 'application_express'
+                | 'stripe';
 
               type LossesCollector = 'application' | 'stripe';
             }
@@ -1303,7 +1320,7 @@ declare module 'stripe' {
 
           interface Identity {
             /**
-             * Attestations from the identity's key people, e.g. owners, executives, directors.
+             * Attestations from the identity's key people, e.g. owners, executives, directors, representatives.
              */
             attestations?: Identity.Attestations;
 
@@ -1345,6 +1362,11 @@ declare module 'stripe' {
                */
               persons_provided?: Attestations.PersonsProvided;
 
+              /**
+               * This hash is used to attest that the representative is authorized to act as the representative of their legal entity.
+               */
+              representative_declaration?: Attestations.RepresentativeDeclaration;
+
               /**
                * Attestations of accepted terms of service agreements.
                */
@@ -1414,6 +1436,23 @@ declare module 'stripe' {
                   | 'qualifies_as_financial_institution';
               }
 
+              interface RepresentativeDeclaration {
+                /**
+                 * The time marking when the representative attestation was made. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
+                 */
+                date?: string;
+
+                /**
+                 * The IP address from which the representative attestation was made.
+                 */
+                ip?: string;
+
+                /**
+                 * The user agent of the browser from which the representative attestation was made.
+                 */
+                user_agent?: string;
+              }
+
               interface TermsOfService {
                 /**
                  * Details on the Account's acceptance of the [Stripe Services Agreement](https://docs.stripe.com/connect/updating-accounts#tos-acceptance).
@@ -2702,6 +2741,7 @@ declare module 'stripe' {
                 type LocationSource =
                   | 'identity_address'
                   | 'ip_address'
+                  | 'payment_method'
                   | 'shipping_address';
 
                 type ValidateLocation = 'auto' | 'deferred' | 'immediately';
@@ -3625,6 +3665,11 @@ declare module 'stripe' {
                    * Can hold storage-type funds on Stripe in GBP.
                    */
                   gbp?: HoldsCurrencies.Gbp;
+
+                  /**
+                   * Can hold storage-type funds on Stripe in USD.
+                   */
+                  usd?: HoldsCurrencies.Usd;
                 }
 
                 namespace HoldsCurrencies {
@@ -3634,6 +3679,13 @@ declare module 'stripe' {
                      */
                     requested?: boolean;
                   }
+
+                  interface Usd {
+                    /**
+                     * To request a new Capability for an account, pass true. There can be a delay before the requested Capability becomes active.
+                     */
+                    requested?: boolean;
+                  }
                 }
 
                 interface InboundTransfers {
@@ -3864,7 +3916,11 @@ declare module 'stripe' {
             }
 
             namespace Responsibilities {
-              type FeesCollector = 'application' | 'stripe';
+              type FeesCollector =
+                | 'application'
+                | 'application_custom'
+                | 'application_express'
+                | 'stripe';
 
               type LossesCollector = 'application' | 'stripe';
             }
@@ -3872,7 +3928,7 @@ declare module 'stripe' {
 
           interface Identity {
             /**
-             * Attestations from the identity's key people, e.g. owners, executives, directors.
+             * Attestations from the identity's key people, e.g. owners, executives, directors, representatives.
              */
             attestations?: Identity.Attestations;
 
@@ -3914,6 +3970,11 @@ declare module 'stripe' {
                */
               persons_provided?: Attestations.PersonsProvided;
 
+              /**
+               * This hash is used to attest that the representative is authorized to act as the representative of their legal entity.
+               */
+              representative_declaration?: Attestations.RepresentativeDeclaration;
+
               /**
                * Attestations of accepted terms of service agreements.
                */
@@ -3983,12 +4044,34 @@ declare module 'stripe' {
                   | 'qualifies_as_financial_institution';
               }
 
+              interface RepresentativeDeclaration {
+                /**
+                 * The time marking when the representative attestation was made. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
+                 */
+                date?: string;
+
+                /**
+                 * The IP address from which the representative attestation was made.
+                 */
+                ip?: string;
+
+                /**
+                 * The user agent of the browser from which the representative attestation was made.
+                 */
+                user_agent?: string;
+              }
+
               interface TermsOfService {
                 /**
                  * Details on the Account's acceptance of the [Stripe Services Agreement](https://docs.stripe.com/connect/updating-accounts#tos-acceptance).
                  */
                 account?: TermsOfService.Account;
 
+                /**
+                 * Details on the Account's acceptance of Crypto-storer-specific terms of service.
+                 */
+                crypto_storer?: TermsOfService.CryptoStorer;
+
                 /**
                  * Details on the Account's acceptance of Treasury-specific terms of service.
                  */
@@ -4013,6 +4096,23 @@ declare module 'stripe' {
                   user_agent?: string;
                 }
 
+                interface CryptoStorer {
+                  /**
+                   * The time when the Account's representative accepted the terms of service. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
+                   */
+                  date?: string;
+
+                  /**
+                   * The IP address from which the Account's representative accepted the terms of service.
+                   */
+                  ip?: string;
+
+                  /**
+                   * The user agent of the browser from which the Account's representative accepted the terms of service.
+                   */
+                  user_agent?: string;
+                }
+
                 interface Storer {
                   /**
                    * The time when the Account's representative accepted the terms of service. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
@@ -4904,6 +5004,11 @@ declare module 'stripe' {
            */
           applied_configurations?: Array<string>;
 
+          /**
+           * Filter by whether the account is closed. If omitted, returns only Accounts that are not closed.
+           */
+          closed?: boolean;
+
           /**
            * The upper limit on the number of accounts returned by the List Account request.
            */
@@ -4981,7 +5086,7 @@ declare module 'stripe' {
           ): ApiListPromise<Stripe.V2.Core.Account>;
 
           /**
-           * Removes access to the Account and its associated resources.
+           * Removes access to the Account and its associated resources. Closed Accounts can no longer be operated on, but limited information can still be retrieved through the API in order to be able to track their history.
            */
           close(
             id: string,

package/types/V2/Core/EventTypes.d.ts

@@ -5,7 +5,6 @@ declare module 'stripe' {
     export type Event =
       | Stripe.Events.V1BillingMeterErrorReportTriggeredEvent
       | Stripe.Events.V1BillingMeterNoMeterFoundEvent
-      | Stripe.Events.V2BillingBillSettingUpdatedEvent
       | Stripe.Events.V2CoreAccountClosedEvent
       | Stripe.Events.V2CoreAccountCreatedEvent
       | Stripe.Events.V2CoreAccountUpdatedEvent
@@ -71,7 +70,6 @@ declare module 'stripe' {
     export type EventNotification =
       | Stripe.Events.V1BillingMeterErrorReportTriggeredEventNotification
       | Stripe.Events.V1BillingMeterNoMeterFoundEventNotification
-      | Stripe.Events.V2BillingBillSettingUpdatedEventNotification
       | Stripe.Events.V2CoreAccountClosedEventNotification
       | Stripe.Events.V2CoreAccountCreatedEventNotification
       | Stripe.Events.V2CoreAccountUpdatedEventNotification
@@ -355,38 +353,6 @@ declare module 'stripe' {
       }
     }
 
-    /**
-     * This event occurs when a bill setting is updated.
-     */
-    export interface V2BillingBillSettingUpdatedEvent
-      extends V2.Core.EventBase {
-      type: 'v2.billing.bill_setting.updated';
-      // Retrieves data specific to this event.
-      data: V2BillingBillSettingUpdatedEvent.Data;
-      // Object containing the reference to API resource relevant to the event.
-      related_object: V2.Core.Events.RelatedObject;
-      // Retrieves the object associated with the event.
-      fetchRelatedObject(): Promise<V2.Billing.BillSetting>;
-    }
-    export interface V2BillingBillSettingUpdatedEventNotification
-      extends V2.Core.EventNotificationBase {
-      type: 'v2.billing.bill_setting.updated';
-      // Object containing the reference to API resource relevant to the event.
-      related_object: V2.Core.Events.RelatedObject;
-      // Retrieves the object associated with the event.
-      fetchRelatedObject(): Promise<V2.Billing.BillSetting>;
-      fetchEvent(): Promise<V2BillingBillSettingUpdatedEvent>;
-    }
-
-    namespace V2BillingBillSettingUpdatedEvent {
-      export interface Data {
-        /**
-         * Timestamp of when the object was updated.
-         */
-        updated: string;
-      }
-    }
-
     /**
      * This event occurs when an account is closed.
      */
@@ -1702,6 +1668,8 @@ declare module 'stripe' {
     export interface V2MoneyManagementTransactionCreatedEvent
       extends V2.Core.EventBase {
       type: 'v2.money_management.transaction.created';
+      // Retrieves data specific to this event.
+      data: V2MoneyManagementTransactionCreatedEvent.Data;
       // Object containing the reference to API resource relevant to the event.
       related_object: V2.Core.Events.RelatedObject;
       // Retrieves the object associated with the event.
@@ -1717,6 +1685,15 @@ declare module 'stripe' {
       fetchEvent(): Promise<V2MoneyManagementTransactionCreatedEvent>;
     }
 
+    namespace V2MoneyManagementTransactionCreatedEvent {
+      export interface Data {
+        /**
+         * Id of the v1 Transaction corresponding to this Transaction.
+         */
+        v1_id?: string;
+      }
+    }
+
     /**
      * Occurs when a Transaction is updated.
      */

package/types/V2/Core/EventsResource.d.ts

@@ -12,14 +12,39 @@ declare module 'stripe' {
       namespace Core {
         interface EventListParams {
           /**
-           * Primary object ID used to retrieve related events.
+           * Filter for events created after the specified timestamp.
            */
-          object_id: string;
+          gt?: string;
+
+          /**
+           * Filter for events created at or after the specified timestamp.
+           */
+          gte?: string;
 
           /**
            * The page size.
            */
           limit?: number;
+
+          /**
+           * Filter for events created before the specified timestamp.
+           */
+          lt?: string;
+
+          /**
+           * Filter for events created at or before the specified timestamp.
+           */
+          lte?: string;
+
+          /**
+           * Primary object ID used to retrieve related events.
+           */
+          object_id?: string;
+
+          /**
+           * An array of up to 20 strings containing specific event names.
+           */
+          types?: Array<string>;
         }
       }
 
@@ -42,9 +67,10 @@ declare module 'stripe' {
            * List events, going back up to 30 days.
            */
           list(
-            params: EventListParams,
+            params?: EventListParams,
             options?: RequestOptions
           ): ApiListPromise<Stripe.V2.Core.Event>;
+          list(options?: RequestOptions): ApiListPromise<Stripe.V2.Core.Event>;
         }
       }
     }

package/types/V2/Core/Vault/GbBankAccountsResource.d.ts

@@ -63,6 +63,17 @@ declare module 'stripe' {
         }
       }
 
+      namespace Core {
+        namespace Vault {
+          interface GbBankAccountListParams {
+            /**
+             * Optionally set the maximum number of results per page. Defaults to 10.
+             */
+            limit?: number;
+          }
+        }
+      }
+
       namespace Core {
         namespace Vault {
           interface GbBankAccountAcknowledgeConfirmationOfPayeeParams {}
@@ -119,6 +130,17 @@ declare module 'stripe' {
               options?: RequestOptions
             ): Promise<Stripe.Response<Stripe.V2.Core.Vault.GbBankAccount>>;
 
+            /**
+             * List objects that can be used as destinations for outbound money movement via OutboundPayment.
+             */
+            list(
+              params?: GbBankAccountListParams,
+              options?: RequestOptions
+            ): ApiListPromise<Stripe.V2.Core.Vault.GbBankAccount>;
+            list(
+              options?: RequestOptions
+            ): ApiListPromise<Stripe.V2.Core.Vault.GbBankAccount>;
+
             /**
              * Confirm that you have received the result of the Confirmation of Payee request, and that you are okay with
              * proceeding to pay out to this bank account despite the account not matching, partially matching, or the service

package/types/V2/Core/Vault/UsBankAccounts.d.ts

@@ -58,10 +58,56 @@ declare module 'stripe' {
              * The ACH routing number of the bank account.
              */
             routing_number?: string;
+
+            /**
+             * The bank account verification details.
+             */
+            verification: UsBankAccount.Verification;
           }
 
           namespace UsBankAccount {
             type BankAccountType = 'checking' | 'savings';
+
+            interface Verification {
+              /**
+               * The microdeposit verification details if the status is awaiting verification.
+               */
+              microdeposit_verification_details?: Verification.MicrodepositVerificationDetails;
+
+              /**
+               * The bank account verification status.
+               */
+              status: Verification.Status;
+            }
+
+            namespace Verification {
+              interface MicrodepositVerificationDetails {
+                /**
+                 * Time when microdeposits will expire and have to be re-sent.
+                 */
+                expires: string;
+
+                /**
+                 * Microdeposit type can be amounts or descriptor_type.
+                 */
+                microdeposit_type: MicrodepositVerificationDetails.MicrodepositType;
+
+                /**
+                 * Time when microdeposits were sent.
+                 */
+                sent: string;
+              }
+
+              namespace MicrodepositVerificationDetails {
+                type MicrodepositType = 'amounts' | 'descriptor_code';
+              }
+
+              type Status =
+                | 'awaiting_verification'
+                | 'unverified'
+                | 'verification_failed'
+                | 'verified';
+            }
           }
         }
       }

package/types/V2/Core/Vault/UsBankAccountsResource.d.ts

@@ -55,12 +55,50 @@ declare module 'stripe' {
         }
       }
 
+      namespace Core {
+        namespace Vault {
+          interface UsBankAccountListParams {
+            /**
+             * Optionally set the maximum number of results per page. Defaults to 10.
+             */
+            limit?: number;
+
+            /**
+             * Optionally filter by verification status. Mutually exclusive with `unverified`, `verified`, `awaiting_verification`, and `verification_failed`.
+             */
+            verification_status?: string;
+          }
+        }
+      }
+
       namespace Core {
         namespace Vault {
           interface UsBankAccountArchiveParams {}
         }
       }
 
+      namespace Core {
+        namespace Vault {
+          interface UsBankAccountConfirmMicrodepositsParams {
+            /**
+             * Two amounts received through Send Microdeposits must match the input to Confirm Microdeposits to verify US Bank Account.
+             */
+            amounts?: Array<number>;
+
+            /**
+             * Descriptor code received through Send Microdeposits must match the input to Confirm Microdeposits to verify US Bank Account.
+             */
+            descriptor_code?: string;
+          }
+        }
+      }
+
+      namespace Core {
+        namespace Vault {
+          interface UsBankAccountSendMicrodepositsParams {}
+        }
+      }
+
       namespace Core {
         namespace Vault {
           class UsBankAccountsResource {
@@ -100,6 +138,17 @@ declare module 'stripe' {
               options?: RequestOptions
             ): Promise<Stripe.Response<Stripe.V2.Core.Vault.UsBankAccount>>;
 
+            /**
+             * List USBankAccount objects. Optionally filter by verification status.
+             */
+            list(
+              params?: UsBankAccountListParams,
+              options?: RequestOptions
+            ): ApiListPromise<Stripe.V2.Core.Vault.UsBankAccount>;
+            list(
+              options?: RequestOptions
+            ): ApiListPromise<Stripe.V2.Core.Vault.UsBankAccount>;
+
             /**
              * Archive a USBankAccount object. USBankAccount objects will not be automatically archived by Stripe.
              * Archived USBankAccount objects cannot be used as outbound destinations
@@ -115,6 +164,32 @@ declare module 'stripe' {
               id: string,
               options?: RequestOptions
             ): Promise<Stripe.Response<Stripe.V2.Core.Vault.UsBankAccount>>;
+
+            /**
+             * Confirm microdeposits amounts or descriptor code that you have received from the Send Microdeposits request. Once you correctly confirm this, this US Bank Account will be verified and eligible to transfer funds with.
+             */
+            confirmMicrodeposits(
+              id: string,
+              params?: UsBankAccountConfirmMicrodepositsParams,
+              options?: RequestOptions
+            ): Promise<Stripe.Response<Stripe.V2.Core.Vault.UsBankAccount>>;
+            confirmMicrodeposits(
+              id: string,
+              options?: RequestOptions
+            ): Promise<Stripe.Response<Stripe.V2.Core.Vault.UsBankAccount>>;
+
+            /**
+             * Send microdeposits in order to verify your US Bank Account so it is eligible to transfer funds. This will start the verification process and you must Confirm Microdeposits to successfully verify your US Bank Account.
+             */
+            sendMicrodeposits(
+              id: string,
+              params?: UsBankAccountSendMicrodepositsParams,
+              options?: RequestOptions
+            ): Promise<Stripe.Response<Stripe.V2.Core.Vault.UsBankAccount>>;
+            sendMicrodeposits(
+              id: string,
+              options?: RequestOptions
+            ): Promise<Stripe.Response<Stripe.V2.Core.Vault.UsBankAccount>>;
           }
         }
       }

package/types/V2/MoneyManagement/FinancialAccountsResource.d.ts

@@ -40,6 +40,20 @@ declare module 'stripe' {
         interface FinancialAccountRetrieveParams {}
       }
 
+      namespace MoneyManagement {
+        interface FinancialAccountUpdateParams {
+          /**
+           * A descriptive name for the FinancialAccount, up to 50 characters long. This name will be used in the Stripe Dashboard and embedded components.
+           */
+          display_name?: string;
+
+          /**
+           * Metadata associated with the FinancialAccount.
+           */
+          metadata?: Stripe.MetadataParam;
+        }
+      }
+
       namespace MoneyManagement {
         interface FinancialAccountListParams {
           /**
@@ -112,6 +126,17 @@ declare module 'stripe' {
             Stripe.Response<Stripe.V2.MoneyManagement.FinancialAccount>
           >;
 
+          /**
+           * Updates an existing FinancialAccount.
+           */
+          update(
+            id: string,
+            params?: FinancialAccountUpdateParams,
+            options?: RequestOptions
+          ): Promise<
+            Stripe.Response<Stripe.V2.MoneyManagement.FinancialAccount>
+          >;
+
           /**
            * Lists FinancialAccounts in this compartment.
            */

package/types/V2/MoneyManagement/OutboundPaymentsResource.d.ts

@@ -178,9 +178,9 @@ declare module 'stripe' {
           /**
            * Creates an OutboundPayment.
            * @throws Stripe.InsufficientFundsError
+           * @throws Stripe.FeatureNotEnabledError
            * @throws Stripe.QuotaExceededError
            * @throws Stripe.RecipientNotNotifiableError
-           * @throws Stripe.FeatureNotEnabledError
            */
           create(
             params: OutboundPaymentCreateParams,

package/types/WebhookEndpointsResource.d.ts

@@ -156,7 +156,8 @@ declare module 'stripe' {
         | '2025-06-30.basil'
         | '2025-07-30.basil'
         | '2025-08-27.basil'
-        | '2025-09-30.clover';
+        | '2025-09-30.clover'
+        | '2025-10-29.clover';
 
       type EnabledEvent =
         | '*'

package/types/apiVersion.d.ts

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec
 
-export const ApiVersion = '2025-09-30.preview';
+export const ApiVersion = '2025-10-29.preview';

package/types/crypto/crypto.d.ts

@@ -20,7 +20,7 @@ declare module 'stripe' {
       computeHMACSignature: (payload: string, secret: string) => string;
 
       /**
-       * Asynchrnously computes a SHA-256 HMAC with a given secret and a payload
+       * Asynchronously computes a SHA-256 HMAC with a given secret and a payload
        * (encoded in UTF-8). The output HMAC should be encoded in hexadecimal
        * and respect the contract of computeHMACSignature.
        */