stripe 18.3.0-beta.2 → 18.4.0-beta.1

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

@@ -1160,6 +1160,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -2053,6 +2054,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -2108,6 +2110,11 @@ declare module 'stripe' {
                  */
                 primary_verification?: Documents.PrimaryVerification;
 
+                /**
+                 * One or more documents that demonstrate proof of address.
+                 */
+                proof_of_address?: Documents.ProofOfAddress;
+
                 /**
                  * One or more documents showing the company's proof of registration with the national business registry.
                  */
@@ -2218,6 +2225,18 @@ declare module 'stripe' {
                   }
                 }
 
+                interface ProofOfAddress {
+                  /**
+                   * One or more document IDs returned by a [file upload](https://docs.stripe.com/api/persons/update#create_file) with a purpose value of `account_requirement`.
+                   */
+                  files: Array<string>;
+
+                  /**
+                   * The format of the document. Currently supports `files` only.
+                   */
+                  type: 'files';
+                }
+
                 interface ProofOfRegistration {
                   /**
                    * One or more document IDs returned by a [file upload](https://docs.stripe.com/api/persons/update#create_file) with a purpose value of `account_requirement`.
@@ -2627,6 +2646,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -2918,6 +2938,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -3230,6 +3251,7 @@ declare module 'stripe' {
               | 'vu'
               | 'wf'
               | 'ws'
+              | 'xx'
               | 'ye'
               | 'yt'
               | 'za'
@@ -3619,6 +3641,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -3936,6 +3959,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -4356,6 +4380,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'
@@ -4688,6 +4713,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -4979,6 +5005,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -6225,6 +6252,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -7123,6 +7151,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -7178,6 +7207,11 @@ declare module 'stripe' {
                  */
                 primary_verification?: Documents.PrimaryVerification | null;
 
+                /**
+                 * One or more documents that demonstrate proof of address.
+                 */
+                proof_of_address?: Documents.ProofOfAddress;
+
                 /**
                  * One or more documents showing the company's proof of registration with the national business registry.
                  */
@@ -7288,6 +7322,18 @@ declare module 'stripe' {
                   }
                 }
 
+                interface ProofOfAddress {
+                  /**
+                   * One or more document IDs returned by a [file upload](https://docs.stripe.com/api/persons/update#create_file) with a purpose value of `account_requirement`.
+                   */
+                  files: Array<string>;
+
+                  /**
+                   * The format of the document. Currently supports `files` only.
+                   */
+                  type: 'files';
+                }
+
                 interface ProofOfRegistration {
                   /**
                    * One or more document IDs returned by a [file upload](https://docs.stripe.com/api/persons/update#create_file) with a purpose value of `account_requirement`.
@@ -7697,6 +7743,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -7988,6 +8035,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -8300,6 +8348,7 @@ declare module 'stripe' {
               | 'vu'
               | 'wf'
               | 'ws'
+              | 'xx'
               | 'ye'
               | 'yt'
               | 'za'
@@ -8689,6 +8738,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -9006,6 +9056,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -9426,6 +9477,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'
@@ -9758,6 +9810,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'
@@ -10049,6 +10102,7 @@ declare module 'stripe' {
                     | 'vu'
                     | 'wf'
                     | 'ws'
+                    | 'xx'
                     | 'ye'
                     | 'yt'
                     | 'za'

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

@@ -419,6 +419,7 @@ declare module 'stripe' {
               | 'vu'
               | 'wf'
               | 'ws'
+              | 'xx'
               | 'ye'
               | 'yt'
               | 'za'
@@ -762,6 +763,7 @@ declare module 'stripe' {
               | 'vu'
               | 'wf'
               | 'ws'
+              | 'xx'
               | 'ye'
               | 'yt'
               | 'za'
@@ -1177,6 +1179,7 @@ declare module 'stripe' {
             | 'vu'
             | 'wf'
             | 'ws'
+            | 'xx'
             | 'ye'
             | 'yt'
             | 'za'
@@ -1524,6 +1527,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'
@@ -1815,6 +1819,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'

package/types/V2/EventTypes.d.ts

@@ -746,7 +746,7 @@ declare module 'stripe' {
     }
 
     /**
-     * A ping event used to test the connection to an event destination.
+     * A ping event used to test the connection to an EventDestination.
      */
     export interface V2CoreEventDestinationPingEvent extends V2.EventBase {
       type: 'v2.core.event_destination.ping';

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

@@ -33,13 +33,16 @@ declare module 'stripe' {
            */
           created: string;
 
-          description: string | null;
-
           /**
            * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
            */
           livemode: boolean;
 
+          /**
+           * Metadata associated with the FinancialAccount
+           */
+          metadata: Stripe.Metadata | null;
+
           /**
            * If this is a `other` FinancialAccount, this hash indicates what the actual type is. Upgrade your API version to see it reflected in `type`.
            */
@@ -72,7 +75,7 @@ declare module 'stripe' {
             };
 
             /**
-             * Balance of inbound funds that will later transition to the `cash` balance.
+             * Balance of inbound funds that will later transition to the `available` balance.
              */
             inbound_pending: {
               [key: string]: Amount;
@@ -332,6 +335,7 @@ declare module 'stripe' {
             | 'vu'
             | 'wf'
             | 'ws'
+            | 'xx'
             | 'ye'
             | 'yt'
             | 'za'
@@ -345,7 +349,7 @@ declare module 'stripe' {
             type: string;
           }
 
-          type Status = 'closed' | 'open';
+          type Status = 'closed' | 'open' | 'pending';
 
           interface Storage {
             /**

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

@@ -246,6 +246,7 @@ declare module 'stripe' {
           /**
            * Create a new FinancialAddress for a FinancialAccount.
            * @throws Stripe.FinancialAccountNotOpenError
+           * @throws Stripe.FeatureNotEnabledError
            */
           create(
             params: FinancialAddressCreateParams,

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

@@ -81,7 +81,7 @@ declare module 'stripe' {
           recipient_notification: OutboundPayment.RecipientNotification;
 
           /**
-           * The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer).
+           * The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer). It will default to `STRIPE` if not set on the account settings.
            */
           statement_descriptor: string;
 

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

@@ -71,7 +71,7 @@ declare module 'stripe' {
           receipt_url: string | null;
 
           /**
-           * The description that appears on the receiving end for an OutboundTransfer (for example, bank statement for external bank transfer).
+           * The description that appears on the receiving end for an OutboundTransfer (for example, bank statement for external bank transfer). It will default to `STRIPE` if not set on the account settings.
            */
           statement_descriptor: string;
 

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

@@ -146,6 +146,7 @@ declare module 'stripe' {
           /**
            * Creates an OutboundTransfer.
            * @throws Stripe.InsufficientFundsError
+           * @throws Stripe.FeatureNotEnabledError
            */
           create(
             params: OutboundTransferCreateParams,

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

@@ -83,14 +83,33 @@ declare module 'stripe' {
         namespace ReceivedCredit {
           interface BalanceTransfer {
             /**
-             * The ID of the Stripe Money Movement that originated the ReceivedCredit.
+             * The ID of the account that owns the source object originated the ReceivedCredit.
              */
-            payout_v1: string;
+            from_account: string | null;
 
             /**
              * Open Enum. The type of Stripe Money Movement that originated the ReceivedCredit.
              */
-            type: 'payout_v1';
+            type: BalanceTransfer.Type;
+
+            /**
+             * The ID of the outbound payment object that originated the ReceivedCredit.
+             */
+            outbound_payment: string | null;
+
+            /**
+             * The ID of the outbound transfer object that originated the ReceivedCredit.
+             */
+            outbound_transfer: string | null;
+
+            /**
+             * The ID of the payout object that originated the ReceivedCredit.
+             */
+            payout_v1: string | null;
+          }
+
+          namespace BalanceTransfer {
+            type Type = 'outbound_payment' | 'outbound_transfer' | 'payout_v1';
           }
 
           interface BankTransfer {

package/types/WebhookEndpointsResource.d.ts

@@ -152,7 +152,8 @@ declare module 'stripe' {
         | '2025-03-01.dashboard'
         | '2025-03-31.basil'
         | '2025-04-30.basil'
-        | '2025-05-28.basil';
+        | '2025-05-28.basil'
+        | '2025-06-30.basil';
 
       type EnabledEvent =
         | '*'

package/types/index.d.ts

@@ -570,9 +570,15 @@ declare module 'stripe' {
       transactionEntries: Stripe.Treasury.TransactionEntriesResource;
     };
     v2: {
+      billing: {
+        meterEventAdjustments: Stripe.V2.Billing.MeterEventAdjustmentsResource;
+        meterEventSession: Stripe.V2.Billing.MeterEventSessionResource;
+        meterEventStream: Stripe.V2.Billing.MeterEventStreamResource;
+        meterEvents: Stripe.V2.Billing.MeterEventsResource;
+      };
       core: {
-        accounts: Stripe.V2.Core.AccountsResource;
         accountLinks: Stripe.V2.Core.AccountLinksResource;
+        accounts: Stripe.V2.Core.AccountsResource;
         eventDestinations: Stripe.V2.Core.EventDestinationsResource;
         events: Stripe.V2.Core.EventsResource;
         vault: {
@@ -585,29 +591,23 @@ declare module 'stripe' {
         financialAccounts: Stripe.V2.MoneyManagement.FinancialAccountsResource;
         financialAddresses: Stripe.V2.MoneyManagement.FinancialAddressesResource;
         inboundTransfers: Stripe.V2.MoneyManagement.InboundTransfersResource;
-        outboundPayments: Stripe.V2.MoneyManagement.OutboundPaymentsResource;
         outboundPaymentQuotes: Stripe.V2.MoneyManagement.OutboundPaymentQuotesResource;
-        outboundTransfers: Stripe.V2.MoneyManagement.OutboundTransfersResource;
+        outboundPayments: Stripe.V2.MoneyManagement.OutboundPaymentsResource;
         outboundSetupIntents: Stripe.V2.MoneyManagement.OutboundSetupIntentsResource;
+        outboundTransfers: Stripe.V2.MoneyManagement.OutboundTransfersResource;
         payoutMethods: Stripe.V2.MoneyManagement.PayoutMethodsResource;
         payoutMethodsBankAccountSpec: Stripe.V2.MoneyManagement.PayoutMethodsBankAccountSpecResource;
         receivedCredits: Stripe.V2.MoneyManagement.ReceivedCreditsResource;
         receivedDebits: Stripe.V2.MoneyManagement.ReceivedDebitsResource;
-        transactions: Stripe.V2.MoneyManagement.TransactionsResource;
         transactionEntries: Stripe.V2.MoneyManagement.TransactionEntriesResource;
+        transactions: Stripe.V2.MoneyManagement.TransactionsResource;
       };
-      billing: {
-        meterEventSession: Stripe.V2.Billing.MeterEventSessionResource;
-        meterEventAdjustments: Stripe.V2.Billing.MeterEventAdjustmentsResource;
-        meterEventStream: Stripe.V2.Billing.MeterEventStreamResource;
-        meterEvents: Stripe.V2.Billing.MeterEventsResource;
+      payment: {
+        offSessionPayments: Stripe.V2.Payments.OffSessionPaymentsResource;
       };
       testHelper: {
         financialAddresses: Stripe.V2.TestHelpers.FinancialAddressesResource;
       };
-      payment: {
-        offSessionPayments: Stripe.V2.Payments.OffSessionPaymentsResource;
-      };
     };
     // Fields: The end of the section generated from our OpenAPI spec
     webhooks: Stripe.Webhooks;

package/types/lib.d.ts

@@ -27,7 +27,7 @@ declare module 'stripe' {
       }): (...args: any[]) => Response<ResponseObject>; //eslint-disable-line @typescript-eslint/no-explicit-any
       static MAX_BUFFERED_REQUEST_METRICS: number;
     }
-    export type LatestApiVersion = '2025-05-28.preview';
+    export type LatestApiVersion = '2025-06-30.preview';
     export type HttpAgent = Agent;
     export type HttpProtocol = 'http' | 'https';
 
@@ -112,6 +112,11 @@ declare module 'stripe' {
        * An account id on whose behalf you wish to make every request.
        */
       stripeAccount?: string;
+
+      /**
+       * An account on whose behalf you wish to make every request. See https://docs.corp.stripe.com/context for more information.
+       */
+      stripeContext?: string;
     }
 
     export interface RequestOptions {
@@ -131,6 +136,11 @@ declare module 'stripe' {
        */
       stripeAccount?: string;
 
+      /**
+       * An account on whose behalf you wish to make a request. See https://docs.corp.stripe.com/context for more information.
+       */
+      stripeContext?: string;
+
       /**
        * The [API Version](https://stripe.com/docs/upgrades) to use for a given request (e.g., '2020-03-02').
        */

package/types/test/typescriptTest.ts

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