stripe 18.5.0-beta.2 → 18.6.0-alpha.1

package/types/V2/Tax/AutomaticRulesResource.d.ts

@@ -0,0 +1,102 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace V2 {
+      namespace Tax {
+        interface AutomaticRuleCreateParams {
+          /**
+           * The BillableItem ID to set automatic Tax configuration for.
+           */
+          billable_item: string;
+
+          /**
+           * The TaxCode object to be used for automatic tax calculations.
+           */
+          tax_code: string;
+        }
+      }
+
+      namespace Tax {
+        interface AutomaticRuleRetrieveParams {}
+      }
+
+      namespace Tax {
+        interface AutomaticRuleUpdateParams {
+          /**
+           * The TaxCode object to be used for automatic tax calculations.
+           */
+          tax_code: string;
+        }
+      }
+
+      namespace Tax {
+        interface AutomaticRuleDeactivateParams {}
+      }
+
+      namespace Tax {
+        interface AutomaticRuleFindParams {
+          /**
+           * The BillableItem ID to search by.
+           */
+          billable_item: string;
+        }
+      }
+
+      namespace Tax {
+        class AutomaticRulesResource {
+          /**
+           * Creates an AutomaticRule object.
+           */
+          create(
+            params: AutomaticRuleCreateParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Tax.AutomaticRule>>;
+
+          /**
+           * Retrieves an AutomaticRule object by ID.
+           */
+          retrieve(
+            id: string,
+            params?: AutomaticRuleRetrieveParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Tax.AutomaticRule>>;
+          retrieve(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Tax.AutomaticRule>>;
+
+          /**
+           * Updates the automatic Tax configuration for an AutomaticRule object.
+           */
+          update(
+            id: string,
+            params: AutomaticRuleUpdateParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Tax.AutomaticRule>>;
+
+          /**
+           * Deactivates an AutomaticRule object. Deactivated AutomaticRule objects are ignored in future tax calculations.
+           */
+          deactivate(
+            id: string,
+            params?: AutomaticRuleDeactivateParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Tax.AutomaticRule>>;
+          deactivate(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Tax.AutomaticRule>>;
+
+          /**
+           * Finds an AutomaticRule object by BillableItem ID.
+           */
+          find(
+            params: AutomaticRuleFindParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Tax.AutomaticRule>>;
+        }
+      }
+    }
+  }
+}

package/types/WebhookEndpointsResource.d.ts

@@ -154,7 +154,8 @@ declare module 'stripe' {
         | '2025-04-30.basil'
         | '2025-05-28.basil'
         | '2025-06-30.basil'
-        | '2025-07-30.basil';
+        | '2025-07-30.basil'
+        | '2025-08-27.basil';
 
       type EnabledEvent =
         | '*'

package/types/Webhooks.d.ts

@@ -2,6 +2,8 @@
 
 declare module 'stripe' {
   namespace Stripe {
+    export type WebhookEvent = Record<string, unknown>;
+
     export class Webhooks {
       /**
        * Constructs and verifies the signature of an Event from the provided details.

package/types/index.d.ts

@@ -150,13 +150,37 @@
 ///<reference path='./Treasury/ReceivedDebitsResource.d.ts' />
 ///<reference path='./Treasury/TransactionEntriesResource.d.ts' />
 ///<reference path='./Treasury/TransactionsResource.d.ts' />
+///<reference path='./V2/Billing/BillSettings/VersionsResource.d.ts' />
+///<reference path='./V2/Billing/BillSettingsResource.d.ts' />
+///<reference path='./V2/Billing/CadencesResource.d.ts' />
+///<reference path='./V2/Billing/CollectionSettings/VersionsResource.d.ts' />
+///<reference path='./V2/Billing/CollectionSettingsResource.d.ts' />
+///<reference path='./V2/Billing/CustomPricingUnitsResource.d.ts' />
+///<reference path='./V2/Billing/Intents/ActionsResource.d.ts' />
+///<reference path='./V2/Billing/IntentsResource.d.ts' />
+///<reference path='./V2/Billing/LicenseFeeSubscriptionsResource.d.ts' />
+///<reference path='./V2/Billing/LicenseFees/VersionsResource.d.ts' />
+///<reference path='./V2/Billing/LicenseFeesResource.d.ts' />
+///<reference path='./V2/Billing/LicensedItemsResource.d.ts' />
 ///<reference path='./V2/Billing/MeterEventAdjustmentsResource.d.ts' />
 ///<reference path='./V2/Billing/MeterEventSessionResource.d.ts' />
 ///<reference path='./V2/Billing/MeterEventStreamResource.d.ts' />
 ///<reference path='./V2/Billing/MeterEventsResource.d.ts' />
+///<reference path='./V2/Billing/MeteredItemsResource.d.ts' />
+///<reference path='./V2/Billing/PricingPlanSubscriptionsResource.d.ts' />
+///<reference path='./V2/Billing/PricingPlans/ComponentsResource.d.ts' />
+///<reference path='./V2/Billing/PricingPlans/VersionsResource.d.ts' />
+///<reference path='./V2/Billing/PricingPlansResource.d.ts' />
+///<reference path='./V2/Billing/ProfilesResource.d.ts' />
+///<reference path='./V2/Billing/RateCardSubscriptionsResource.d.ts' />
+///<reference path='./V2/Billing/RateCards/RatesResource.d.ts' />
+///<reference path='./V2/Billing/RateCards/VersionsResource.d.ts' />
+///<reference path='./V2/Billing/RateCardsResource.d.ts' />
+///<reference path='./V2/Billing/ServiceActionsResource.d.ts' />
 ///<reference path='./V2/Core/AccountLinksResource.d.ts' />
 ///<reference path='./V2/Core/Accounts/PersonsResource.d.ts' />
 ///<reference path='./V2/Core/AccountsResource.d.ts' />
+///<reference path='./V2/Core/ClaimableSandboxesResource.d.ts' />
 ///<reference path='./V2/Core/EventDestinationsResource.d.ts' />
 ///<reference path='./V2/Core/EventsResource.d.ts' />
 ///<reference path='./V2/Core/Vault/GbBankAccountsResource.d.ts' />
@@ -176,6 +200,9 @@
 ///<reference path='./V2/MoneyManagement/TransactionEntriesResource.d.ts' />
 ///<reference path='./V2/MoneyManagement/TransactionsResource.d.ts' />
 ///<reference path='./V2/Payments/OffSessionPaymentsResource.d.ts' />
+///<reference path='./V2/Reporting/ReportRunsResource.d.ts' />
+///<reference path='./V2/Reporting/ReportsResource.d.ts' />
+///<reference path='./V2/Tax/AutomaticRulesResource.d.ts' />
 ///<reference path='./V2/TestHelpers/FinancialAddressesResource.d.ts' />
 ///<reference path='./WebhookEndpointsResource.d.ts' />
 ///<reference path='./AccountLinks.d.ts' />
@@ -345,11 +372,35 @@
 ///<reference path='./Treasury/ReceivedDebits.d.ts' />
 ///<reference path='./Treasury/TransactionEntries.d.ts' />
 ///<reference path='./Treasury/Transactions.d.ts' />
+///<reference path='./V2/Billing/BillSettingVersions.d.ts' />
+///<reference path='./V2/Billing/BillSettings.d.ts' />
+///<reference path='./V2/Billing/Cadences.d.ts' />
+///<reference path='./V2/Billing/CollectionSettingVersions.d.ts' />
+///<reference path='./V2/Billing/CollectionSettings.d.ts' />
+///<reference path='./V2/Billing/CustomPricingUnits.d.ts' />
+///<reference path='./V2/Billing/IntentActions.d.ts' />
+///<reference path='./V2/Billing/Intents.d.ts' />
+///<reference path='./V2/Billing/LicenseFeeSubscriptions.d.ts' />
+///<reference path='./V2/Billing/LicenseFeeVersions.d.ts' />
+///<reference path='./V2/Billing/LicenseFees.d.ts' />
+///<reference path='./V2/Billing/LicensedItems.d.ts' />
 ///<reference path='./V2/Billing/MeterEventAdjustments.d.ts' />
 ///<reference path='./V2/Billing/MeterEventSessions.d.ts' />
 ///<reference path='./V2/Billing/MeterEvents.d.ts' />
+///<reference path='./V2/Billing/MeteredItems.d.ts' />
+///<reference path='./V2/Billing/PricingPlanComponents.d.ts' />
+///<reference path='./V2/Billing/PricingPlanSubscriptions.d.ts' />
+///<reference path='./V2/Billing/PricingPlanVersions.d.ts' />
+///<reference path='./V2/Billing/PricingPlans.d.ts' />
+///<reference path='./V2/Billing/Profiles.d.ts' />
+///<reference path='./V2/Billing/RateCardRates.d.ts' />
+///<reference path='./V2/Billing/RateCardSubscriptions.d.ts' />
+///<reference path='./V2/Billing/RateCardVersions.d.ts' />
+///<reference path='./V2/Billing/RateCards.d.ts' />
+///<reference path='./V2/Billing/ServiceActions.d.ts' />
 ///<reference path='./V2/Core/AccountLinks.d.ts' />
 ///<reference path='./V2/Core/Accounts.d.ts' />
+///<reference path='./V2/Core/ClaimableSandboxes.d.ts' />
 ///<reference path='./V2/Core/Persons.d.ts' />
 ///<reference path='./V2/Core/Vault/GbBankAccounts.d.ts' />
 ///<reference path='./V2/Core/Vault/UsBankAccounts.d.ts' />
@@ -372,6 +423,9 @@
 ///<reference path='./V2/MoneyManagement/TransactionEntries.d.ts' />
 ///<reference path='./V2/MoneyManagement/Transactions.d.ts' />
 ///<reference path='./V2/Payments/OffSessionPayments.d.ts' />
+///<reference path='./V2/Reporting/ReportRuns.d.ts' />
+///<reference path='./V2/Reporting/Reports.d.ts' />
+///<reference path='./V2/Tax/AutomaticRules.d.ts' />
 ///<reference path='./WebhookEndpoints.d.ts' />
 // Imports: The end of the section generated from our OpenAPI spec
 
@@ -580,16 +634,32 @@ declare module 'stripe' {
     };
     v2: {
       billing: {
+        billSettings: Stripe.V2.Billing.BillSettingsResource;
+        cadences: Stripe.V2.Billing.CadencesResource;
+        collectionSettings: Stripe.V2.Billing.CollectionSettingsResource;
+        customPricingUnits: Stripe.V2.Billing.CustomPricingUnitsResource;
+        intents: Stripe.V2.Billing.IntentsResource;
+        licenseFees: Stripe.V2.Billing.LicenseFeesResource;
+        licenseFeeSubscriptions: Stripe.V2.Billing.LicenseFeeSubscriptionsResource;
+        licensedItems: Stripe.V2.Billing.LicensedItemsResource;
+        meterEvents: Stripe.V2.Billing.MeterEventsResource;
         meterEventAdjustments: Stripe.V2.Billing.MeterEventAdjustmentsResource;
         meterEventSession: Stripe.V2.Billing.MeterEventSessionResource;
         meterEventStream: Stripe.V2.Billing.MeterEventStreamResource;
-        meterEvents: Stripe.V2.Billing.MeterEventsResource;
+        meteredItems: Stripe.V2.Billing.MeteredItemsResource;
+        pricingPlans: Stripe.V2.Billing.PricingPlansResource;
+        pricingPlanSubscriptions: Stripe.V2.Billing.PricingPlanSubscriptionsResource;
+        profiles: Stripe.V2.Billing.ProfilesResource;
+        rateCards: Stripe.V2.Billing.RateCardsResource;
+        rateCardSubscriptions: Stripe.V2.Billing.RateCardSubscriptionsResource;
+        serviceActions: Stripe.V2.Billing.ServiceActionsResource;
       };
       core: {
-        accountLinks: Stripe.V2.Core.AccountLinksResource;
         accounts: Stripe.V2.Core.AccountsResource;
-        eventDestinations: Stripe.V2.Core.EventDestinationsResource;
+        accountLinks: Stripe.V2.Core.AccountLinksResource;
+        claimableSandboxes: Stripe.V2.Core.ClaimableSandboxesResource;
         events: Stripe.V2.Core.EventsResource;
+        eventDestinations: Stripe.V2.Core.EventDestinationsResource;
         vault: {
           gbBankAccounts: Stripe.V2.Core.Vault.GbBankAccountsResource;
           usBankAccounts: Stripe.V2.Core.Vault.UsBankAccountsResource;
@@ -600,20 +670,27 @@ declare module 'stripe' {
         financialAccounts: Stripe.V2.MoneyManagement.FinancialAccountsResource;
         financialAddresses: Stripe.V2.MoneyManagement.FinancialAddressesResource;
         inboundTransfers: Stripe.V2.MoneyManagement.InboundTransfersResource;
-        outboundPaymentQuotes: Stripe.V2.MoneyManagement.OutboundPaymentQuotesResource;
         outboundPayments: Stripe.V2.MoneyManagement.OutboundPaymentsResource;
+        outboundPaymentQuotes: Stripe.V2.MoneyManagement.OutboundPaymentQuotesResource;
         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;
-        transactionEntries: Stripe.V2.MoneyManagement.TransactionEntriesResource;
         transactions: Stripe.V2.MoneyManagement.TransactionsResource;
+        transactionEntries: Stripe.V2.MoneyManagement.TransactionEntriesResource;
       };
       payment: {
         offSessionPayments: Stripe.V2.Payments.OffSessionPaymentsResource;
       };
+      reporting: {
+        reports: Stripe.V2.Reporting.ReportsResource;
+        reportRuns: Stripe.V2.Reporting.ReportRunsResource;
+      };
+      tax: {
+        automaticRules: Stripe.V2.Tax.AutomaticRulesResource;
+      };
       testHelper: {
         financialAddresses: Stripe.V2.TestHelpers.FinancialAddressesResource;
       };
@@ -700,6 +777,49 @@ declare module 'stripe' {
        */
       receivedAt?: number
     ) => Stripe.ThinEvent;
+
+    // these arguments are duplicated from the above
+    /**
+     * Parses webhook event payload into a PushedThinEvent and verifies webhook signature.
+     * To get more information on the event, call the `.pull()` method on the object returned from this function.
+     *
+     * @throws Stripe.errors.StripeSignatureVerificationError
+     */
+    parseThinEvent__experimental: (
+      /**
+       * Raw text body payload received from Stripe.
+       */
+      payload: string | Buffer,
+      /**
+       * Value of the `stripe-signature` header from Stripe.
+       * Typically a string.
+       *
+       * Note that this is typed to accept an array of strings
+       * so that it works seamlessly with express's types,
+       * but will throw if an array is passed in practice
+       * since express should never return this header as an array,
+       * only a string.
+       */
+      header: string | Buffer | Array<string>,
+      /**
+       * Your Webhook Signing Secret for this endpoint (e.g., 'whsec_...').
+       * You can get this [in your dashboard](https://dashboard.stripe.com/webhooks).
+       */
+      secret: string,
+      /**
+       * Seconds of tolerance on timestamps.
+       */
+      tolerance?: number,
+      /**
+       * Optional CryptoProvider to use for computing HMAC signatures.
+       */
+      cryptoProvider?: Stripe.CryptoProvider,
+
+      /**
+       * Optional: timestamp to use when checking signature validity. Defaults to Date.now().
+       */
+      receivedAt?: number
+    ) => Stripe.V2.PushedEvent;
   }
 
   export default Stripe;

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-07-30.preview';
+    export type LatestApiVersion = '2025-08-27.preview';
     export const API_VERSION: string;
     export type HttpAgent = Agent;
     export type HttpProtocol = 'http' | 'https';

package/types/test/typescriptTest.ts

@@ -9,7 +9,7 @@
 import Stripe from 'stripe';
 
 let stripe = new Stripe('sk_test_123', {
-  apiVersion: '2025-07-30.preview',
+  apiVersion: '2025-08-27.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-07-30.preview',
+  apiVersion: '2025-08-27.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-07-30.preview',
+    apiVersion: '2025-08-27.preview',
   };
   const customer: Stripe.Customer = await stripe.customers.create(params, opts);