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

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 18.6.0-alpha.2 - 2025-09-17
+
+* [#2404](https://github.com/stripe/stripe-node/pull/2404) Update generated code for private-preview
+    * Add support for `retrieve` method on resource `V2.Core.ClaimableSandbox`
+    * Add support for `month_of_year` on `V2.Billing.Cadence#create.billing_cycle.month` and `V2.Billing.Cadence.billing_cycle.month`
+    * Add support for `claimed_at`, `expires_at`, `sandbox_details`, and `status` on `V2.Core.ClaimableSandbox`
+    * Remove support for `api_keys` on `V2.Core.ClaimableSandbox`
+    * Change type of `V2.Core.ClaimableSandbox.claim_url` from `string` to `nullable(string)`
+    * Add support for new value `current_billing_period_end` on enums `V2.Billing.Intent#create.actions[].deactivate.effective_at.type` and `V2.Billing.IntentAction.deactivate.effective_at.type`
+    * Add support for `will_activate_at` and `will_cancel_at` on `V2.Billing.PricingPlanSubscription.servicing_status_transitions` and `V2.Billing.RateCardSubscription.servicing_status_transitions`
+    * Add support for `category` and `priority` on `V2.Billing.ServiceAction#create.credit_grant_per_tenant`, `V2.Billing.ServiceAction#create.credit_grant`, `V2.Billing.ServiceAction.credit_grant_per_tenant`, and `V2.Billing.ServiceAction.credit_grant`
+    * Change `V2.Billing.LicenseFee#update.display_name` to be optional
+    * Add support for `invoices` on `EventsV2BillingCadenceBilledEvent`
+    * Add support for thin events `V2CoreClaimableSandboxClaimedEvent`, `V2CoreClaimableSandboxExpiredEvent`, `V2CoreClaimableSandboxExpiringEvent`, and `V2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent` with related object `V2.Core.ClaimableSandbox`
+    * Remove support for thin event `V2BillingCadenceErroredEvent` with related object `V2.Billing.Cadence`
+
 ## 18.6.0-alpha.1 - 2025-08-27
 * [#2393](https://github.com/stripe/stripe-node/pull/2393) Use the right API version 2025-08-27.preview
 * [#2390](https://github.com/stripe/stripe-node/pull/2390) Update generated code for private-preview

package/VERSION

@@ -1 +1 @@
-18.6.0-alpha.1
+18.6.0-alpha.2

package/cjs/resources/V2/Core/ClaimableSandboxes.js

@@ -9,4 +9,8 @@ exports.ClaimableSandboxes = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v2/core/claimable_sandboxes',
     }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/core/claimable_sandboxes/{id}',
+    }),
 });

package/cjs/stripe.core.js

@@ -36,7 +36,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 = '18.6.0-alpha.1';
+    Stripe.PACKAGE_VERSION = '18.6.0-alpha.2';
     Stripe.API_VERSION = apiVersion_js_1.ApiVersion;
     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;

package/esm/resources/V2/Core/ClaimableSandboxes.js

@@ -6,4 +6,8 @@ export const ClaimableSandboxes = StripeResource.extend({
         method: 'POST',
         fullPath: '/v2/core/claimable_sandboxes',
     }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/core/claimable_sandboxes/{id}',
+    }),
 });

package/esm/stripe.core.js

@@ -33,7 +33,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 = '18.6.0-alpha.1';
+    Stripe.PACKAGE_VERSION = '18.6.0-alpha.2';
     Stripe.API_VERSION = ApiVersion;
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "18.6.0-alpha.1",
+  "version": "18.6.0-alpha.2",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/V2/Billing/Cadences.d.ts

@@ -141,6 +141,12 @@ declare module 'stripe' {
                */
               day_of_month: number;
 
+              /**
+               * The month to anchor the billing on for a type="month" billing cycle from
+               * 1-12. Occurrences are calculated from the month anchor.
+               */
+              month_of_year: number | null;
+
               /**
                * The time at which the billing cycle ends.
                */

package/types/V2/Billing/CadencesResource.d.ts

@@ -108,6 +108,14 @@ declare module 'stripe' {
                */
               day_of_month: number;
 
+              /**
+               * The month to anchor the billing on for a type="month" billing cycle from
+               * 1-12. If not provided, this will default to the month the cadence was created.
+               * This setting can only be used for monthly billing cycles with `interval_count` of 2, 3, 4 or 6.
+               * All occurrences will be calculated from month provided.
+               */
+              month_of_year?: number;
+
               /**
                * The time at which the billing cycle ends.
                * This field is optional, and if not provided, it will default to

package/types/V2/Billing/IntentActions.d.ts

@@ -167,6 +167,7 @@ declare module 'stripe' {
 
             namespace EffectiveAt {
               type Type =
+                | 'current_billing_period_end'
                 | 'current_billing_period_start'
                 | 'on_reserve'
                 | 'timestamp';

package/types/V2/Billing/IntentsResource.d.ts

@@ -159,6 +159,7 @@ declare module 'stripe' {
 
               namespace EffectiveAt {
                 type Type =
+                  | 'current_billing_period_end'
                   | 'current_billing_period_start'
                   | 'on_reserve'
                   | 'timestamp';

package/types/V2/Billing/LicenseFeesResource.d.ts

@@ -135,7 +135,7 @@ declare module 'stripe' {
            * This name is used in Stripe-hosted products like the Customer Portal and Checkout. It does not show up on Invoices.
            * Maximum length of 250 characters.
            */
-          display_name: string;
+          display_name?: string;
 
           /**
            * Changes the version that new license fee will use. Providing `live_version = "latest"` will set the
@@ -272,7 +272,7 @@ declare module 'stripe' {
            */
           update(
             id: string,
-            params: LicenseFeeUpdateParams,
+            params?: LicenseFeeUpdateParams,
             options?: RequestOptions
           ): Promise<Stripe.Response<Stripe.V2.Billing.LicenseFee>>;
 

package/types/V2/Billing/MeterEventStreamResource.d.ts

@@ -6,7 +6,7 @@ declare module 'stripe' {
       namespace Billing {
         interface MeterEventStreamCreateParams {
           /**
-           * List of meter events to include in the request.
+           * List of meter events to include in the request. Supports up to 100 events per request.
            */
           events: Array<MeterEventStreamCreateParams.Event>;
         }

package/types/V2/Billing/PricingPlanSubscriptions.d.ts

@@ -126,6 +126,16 @@ declare module 'stripe' {
              * When the servicing status transitioned to paused.
              */
             paused_at: string | null;
+
+            /**
+             * When the servicing is scheduled to transition to activate.
+             */
+            will_activate_at: string | null;
+
+            /**
+             * When the servicing is scheduled to cancel.
+             */
+            will_cancel_at: string | null;
           }
         }
       }

package/types/V2/Billing/RateCardSubscriptions.d.ts

@@ -126,6 +126,16 @@ declare module 'stripe' {
              * When the servicing status transitioned to paused.
              */
             paused_at: string | null;
+
+            /**
+             * When the servicing is scheduled to transition to activate.
+             */
+            will_activate_at: string | null;
+
+            /**
+             * When the servicing is scheduled to cancel.
+             */
+            will_cancel_at: string | null;
           }
         }
       }

package/types/V2/Billing/ServiceActions.d.ts

@@ -71,6 +71,11 @@ declare module 'stripe' {
              */
             applicability_config: CreditGrant.ApplicabilityConfig;
 
+            /**
+             * The category of the credit grant.
+             */
+            category: CreditGrant.Category | null;
+
             /**
              * The expiry configuration for the credit grant.
              */
@@ -80,6 +85,11 @@ declare module 'stripe' {
              * A descriptive name shown in dashboard.
              */
             name: string;
+
+            /**
+             * The desired priority for applying this credit grant. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.
+             */
+            priority: number | null;
           }
 
           namespace CreditGrant {
@@ -137,6 +147,8 @@ declare module 'stripe' {
               }
             }
 
+            type Category = 'paid' | 'promotional';
+
             interface ExpiryConfig {
               /**
                * The type of the expiry configuration. We currently support `end_of_service_period`.
@@ -156,6 +168,11 @@ declare module 'stripe' {
              */
             applicability_config: CreditGrantPerTenant.ApplicabilityConfig;
 
+            /**
+             * The category of the credit grant.
+             */
+            category: CreditGrantPerTenant.Category | null;
+
             /**
              * The expiry configuration for the credit grant.
              */
@@ -165,6 +182,11 @@ declare module 'stripe' {
              * Customer-facing name for the credit grant.
              */
             name: string;
+
+            /**
+             * The desired priority for applying this credit grant. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.
+             */
+            priority: number | null;
           }
 
           namespace CreditGrantPerTenant {
@@ -222,6 +244,8 @@ declare module 'stripe' {
               }
             }
 
+            type Category = 'paid' | 'promotional';
+
             interface ExpiryConfig {
               /**
                * The type of the expiry configuration. We currently support `end_of_service_period`.

package/types/V2/Billing/ServiceActionsResource.d.ts

@@ -48,6 +48,11 @@ declare module 'stripe' {
              */
             applicability_config: CreditGrant.ApplicabilityConfig;
 
+            /**
+             * The category of the credit grant.
+             */
+            category?: CreditGrant.Category;
+
             /**
              * The expiry configuration for the credit grant.
              */
@@ -57,6 +62,11 @@ declare module 'stripe' {
              * A descriptive name shown in dashboard.
              */
             name: string;
+
+            /**
+             * The desired priority for applying this credit grant. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.
+             */
+            priority?: number;
           }
 
           namespace CreditGrant {
@@ -114,6 +124,8 @@ declare module 'stripe' {
               }
             }
 
+            type Category = 'paid' | 'promotional';
+
             interface ExpiryConfig {
               /**
                * The type of the expiry configuration. We currently support `end_of_service_period`.
@@ -133,6 +145,11 @@ declare module 'stripe' {
              */
             applicability_config: CreditGrantPerTenant.ApplicabilityConfig;
 
+            /**
+             * The category of the credit grant.
+             */
+            category?: CreditGrantPerTenant.Category;
+
             /**
              * The expiry configuration for the credit grant.
              */
@@ -147,6 +164,11 @@ declare module 'stripe' {
              * Customer-facing name for the credit grant.
              */
             name: string;
+
+            /**
+             * The desired priority for applying this credit grant. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.
+             */
+            priority?: number;
           }
 
           namespace CreditGrantPerTenant {
@@ -204,6 +226,8 @@ declare module 'stripe' {
               }
             }
 
+            type Category = 'paid' | 'promotional';
+
             interface ExpiryConfig {
               /**
                * The type of the expiry configuration. We currently support `end_of_service_period`.

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

@@ -25,20 +25,26 @@ declare module 'stripe' {
           object: 'v2.core.claimable_sandbox';
 
           /**
-           * Keys that can be used to set up an integration for this sandbox and operate on the account.
+           * URL for user to claim sandbox into their existing Stripe account.
+           * The value will be null if the sandbox status is `claimed` or `expired`.
            */
-          api_keys: ClaimableSandbox.ApiKeys;
+          claim_url: string | null;
 
           /**
-           * URL for user to claim sandbox into their existing Stripe account.
+           * The timestamp the sandbox was claimed. The value will be null if the sandbox status is not `claimed`.
            */
-          claim_url: string;
+          claimed_at: string | null;
 
           /**
            * When the sandbox is created.
            */
           created: string;
 
+          /**
+           * The timestamp the sandbox will expire. The value will be null if the sandbox is `claimed`.
+           */
+          expires_at: string | null;
+
           /**
            * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
            */
@@ -48,27 +54,19 @@ declare module 'stripe' {
            * Values prefilled during the creation of the sandbox.
            */
           prefill: ClaimableSandbox.Prefill;
-        }
-
-        namespace ClaimableSandbox {
-          interface ApiKeys {
-            /**
-             * Used to communicate with [Stripe's MCP server](https://docs.stripe.com/mcp).
-             * This allows LLM agents to securely operate on a Stripe account.
-             */
-            mcp: string | null;
 
-            /**
-             * Publicly accessible in a web or mobile app client-side code.
-             */
-            publishable: string;
+          /**
+           * Data about the Stripe sandbox object.
+           */
+          sandbox_details: ClaimableSandbox.SandboxDetails;
 
-            /**
-             * Should be stored securely in server-side code (such as an environment variable).
-             */
-            secret: string;
-          }
+          /**
+           * Status of the sandbox. One of `unclaimed`, `expired`, `claimed`.
+           */
+          status: ClaimableSandbox.Status;
+        }
 
+        namespace ClaimableSandbox {
           interface Prefill {
             /**
              * Country in which the account holder resides, or in which the business is legally established.
@@ -342,6 +340,46 @@ declare module 'stripe' {
               | 'zm'
               | 'zw';
           }
+
+          interface SandboxDetails {
+            /**
+             * The sandbox's Stripe account ID.
+             */
+            account: string;
+
+            /**
+             * Keys that can be used to set up an integration for this sandbox and operate on the account.
+             */
+            api_keys: SandboxDetails.ApiKeys | null;
+
+            /**
+             * The livemode sandbox Stripe account ID. This field is only set if the user activates their sandbox
+             * and chooses to install your platform's Stripe App in their live account.
+             */
+            owner_account: string | null;
+          }
+
+          namespace SandboxDetails {
+            interface ApiKeys {
+              /**
+               * Used to communicate with [Stripe's MCP server](https://docs.stripe.com/mcp).
+               * This allows LLM agents to securely operate on a Stripe account.
+               */
+              mcp: string | null;
+
+              /**
+               * Publicly accessible in a web or mobile app client-side code.
+               */
+              publishable: string;
+
+              /**
+               * Should be stored securely in server-side code (such as an environment variable).
+               */
+              secret: string;
+            }
+          }
+
+          type Status = 'claimed' | 'expired' | 'unclaimed';
         }
       }
     }

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

@@ -293,6 +293,10 @@ declare module 'stripe' {
         }
       }
 
+      namespace Core {
+        interface ClaimableSandboxRetrieveParams {}
+      }
+
       namespace Core {
         class ClaimableSandboxesResource {
           /**
@@ -303,6 +307,21 @@ declare module 'stripe' {
             params: ClaimableSandboxCreateParams,
             options?: RequestOptions
           ): Promise<Stripe.Response<Stripe.V2.Core.ClaimableSandbox>>;
+
+          /**
+           * Retrieves the details of a claimable sandbox that was previously been created.
+           * Supply the unique claimable sandbox ID that was returned from your creation request,
+           * and Stripe will return the corresponding sandbox information.
+           */
+          retrieve(
+            id: string,
+            params?: ClaimableSandboxRetrieveParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Core.ClaimableSandbox>>;
+          retrieve(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Core.ClaimableSandbox>>;
         }
       }
     }

package/types/V2/EventTypes.d.ts

@@ -8,7 +8,6 @@ declare module 'stripe' {
       | Stripe.Events.V2BillingCadenceBilledEvent
       | Stripe.Events.V2BillingCadenceCanceledEvent
       | Stripe.Events.V2BillingCadenceCreatedEvent
-      | Stripe.Events.V2BillingCadenceErroredEvent
       | Stripe.Events.V2BillingLicenseFeeCreatedEvent
       | Stripe.Events.V2BillingLicenseFeeUpdatedEvent
       | Stripe.Events.V2BillingLicenseFeeVersionCreatedEvent
@@ -61,6 +60,10 @@ declare module 'stripe' {
       | Stripe.Events.V2CoreAccountPersonCreatedEvent
       | Stripe.Events.V2CoreAccountPersonDeletedEvent
       | Stripe.Events.V2CoreAccountPersonUpdatedEvent
+      | Stripe.Events.V2CoreClaimableSandboxClaimedEvent
+      | Stripe.Events.V2CoreClaimableSandboxExpiredEvent
+      | Stripe.Events.V2CoreClaimableSandboxExpiringEvent
+      | Stripe.Events.V2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent
       | Stripe.Events.V2CoreEventDestinationPingEvent
       | Stripe.Events.V2CoreHealthApiErrorFiringEvent
       | Stripe.Events.V2CoreHealthApiErrorResolvedEvent
@@ -130,7 +133,6 @@ declare module 'stripe' {
       | Stripe.Events.PushedV2BillingCadenceBilledEvent
       | Stripe.Events.PushedV2BillingCadenceCanceledEvent
       | Stripe.Events.PushedV2BillingCadenceCreatedEvent
-      | Stripe.Events.PushedV2BillingCadenceErroredEvent
       | Stripe.Events.PushedV2BillingLicenseFeeCreatedEvent
       | Stripe.Events.PushedV2BillingLicenseFeeUpdatedEvent
       | Stripe.Events.PushedV2BillingLicenseFeeVersionCreatedEvent
@@ -183,6 +185,10 @@ declare module 'stripe' {
       | Stripe.Events.PushedV2CoreAccountPersonCreatedEvent
       | Stripe.Events.PushedV2CoreAccountPersonDeletedEvent
       | Stripe.Events.PushedV2CoreAccountPersonUpdatedEvent
+      | Stripe.Events.PushedV2CoreClaimableSandboxClaimedEvent
+      | Stripe.Events.PushedV2CoreClaimableSandboxExpiredEvent
+      | Stripe.Events.PushedV2CoreClaimableSandboxExpiringEvent
+      | Stripe.Events.PushedV2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent
       | Stripe.Events.PushedV2CoreEventDestinationPingEvent
       | Stripe.Events.PushedV2CoreHealthApiErrorFiringEvent
       | Stripe.Events.PushedV2CoreHealthApiErrorResolvedEvent
@@ -472,6 +478,8 @@ declare module 'stripe' {
      */
     export interface V2BillingCadenceBilledEvent extends V2.EventBase {
       type: 'v2.billing.cadence.billed';
+      // Retrieves data specific to this event.
+      data: V2BillingCadenceBilledEvent.Data;
       // Object containing the reference to API resource relevant to the event.
       related_object: Event.RelatedObject;
       // Retrieves the object associated with the event.
@@ -486,6 +494,15 @@ declare module 'stripe' {
       pull(): Promise<V2BillingCadenceBilledEvent>;
     }
 
+    namespace V2BillingCadenceBilledEvent {
+      export interface Data {
+        /**
+         * The IDs of the invoices that were generated by the tick for this Cadence.
+         */
+        invoices: Array<string>;
+      }
+    }
+
     /**
      * Occurs when a billing Cadence is canceled.
      */
@@ -535,25 +552,6 @@ declare module 'stripe' {
       }
     }
 
-    /**
-     * Occurs when a billing Cadence encounters an error during a tick.
-     */
-    export interface V2BillingCadenceErroredEvent extends V2.EventBase {
-      type: 'v2.billing.cadence.errored';
-      // Object containing the reference to API resource relevant to the event.
-      related_object: Event.RelatedObject;
-      // Retrieves the object associated with the event.
-      fetchRelatedObject(): Promise<V2.Billing.Cadence>;
-    }
-    export interface PushedV2BillingCadenceErroredEvent extends V2.EventBase {
-      type: 'v2.billing.cadence.errored';
-      // Object containing the reference to API resource relevant to the event.
-      related_object: Event.RelatedObject;
-      // Retrieves the object associated with the event.
-      fetchRelatedObject(): Promise<V2.Billing.Cadence>;
-      pull(): Promise<V2BillingCadenceErroredEvent>;
-    }
-
     /**
      * Occurs when a LicenseFee is created.
      */
@@ -1898,6 +1896,89 @@ declare module 'stripe' {
       }
     }
 
+    /**
+     * Occurs when a claimable sandbox is claimed.
+     */
+    export interface V2CoreClaimableSandboxClaimedEvent extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.claimed';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+    }
+    export interface PushedV2CoreClaimableSandboxClaimedEvent
+      extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.claimed';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+      pull(): Promise<V2CoreClaimableSandboxClaimedEvent>;
+    }
+
+    /**
+     * Occurs when a claimable sandbox expires.
+     */
+    export interface V2CoreClaimableSandboxExpiredEvent extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.expired';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+    }
+    export interface PushedV2CoreClaimableSandboxExpiredEvent
+      extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.expired';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+      pull(): Promise<V2CoreClaimableSandboxExpiredEvent>;
+    }
+
+    /**
+     * Occurs when a claimable sandbox is expiring in 7 days.
+     */
+    export interface V2CoreClaimableSandboxExpiringEvent extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.expiring';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+    }
+    export interface PushedV2CoreClaimableSandboxExpiringEvent
+      extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.expiring';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+      pull(): Promise<V2CoreClaimableSandboxExpiringEvent>;
+    }
+
+    /**
+     * Occurs when a claimable sandbox is activated by the user with the intention to go live and your Stripe app is installed on the live account.
+     */
+    export interface V2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent
+      extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.sandbox_details_owner_account_updated';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+    }
+    export interface PushedV2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent
+      extends V2.EventBase {
+      type: 'v2.core.claimable_sandbox.sandbox_details_owner_account_updated';
+      // Object containing the reference to API resource relevant to the event.
+      related_object: Event.RelatedObject;
+      // Retrieves the object associated with the event.
+      fetchRelatedObject(): Promise<V2.Core.ClaimableSandbox>;
+      pull(): Promise<
+        V2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent
+      >;
+    }
+
     /**
      * A ping event used to test the connection to an EventDestination.
      */

package/types/apiVersion.d.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec
+
+export const ApiVersion = '2025-08-27.preview';

package/types/lib.d.ts

@@ -3,6 +3,8 @@
 
 import {Agent} from 'http';
 
+import {ApiVersion} from './apiVersion';
+
 declare module 'stripe' {
   namespace Stripe {
     type StripeResourceClass = typeof StripeResource;
@@ -27,7 +29,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-08-27.preview';
+    export type LatestApiVersion = typeof ApiVersion;
     export const API_VERSION: string;
     export type HttpAgent = Agent;
     export type HttpProtocol = 'http' | 'https';

package/types/test/typescriptTest.ts

@@ -8,8 +8,10 @@
 ///<reference types=".." />
 import Stripe from 'stripe';
 
+import {ApiVersion} from '../apiVersion';
+
 let stripe = new Stripe('sk_test_123', {
-  apiVersion: '2025-08-27.preview',
+  apiVersion: ApiVersion,
 });
 
 stripe = new Stripe('sk_test_123');
@@ -26,7 +28,7 @@ stripe = new Stripe('sk_test_123', {
 
 // Check config object.
 stripe = new Stripe('sk_test_123', {
-  apiVersion: '2025-08-27.preview',
+  apiVersion: ApiVersion,
   typescript: true,
   maxNetworkRetries: 1,
   timeout: 1000,
@@ -44,7 +46,7 @@ stripe = new Stripe('sk_test_123', {
     description: 'test',
   };
   const opts: Stripe.RequestOptions = {
-    apiVersion: '2025-08-27.preview',
+    apiVersion: ApiVersion,
   };
   const customer: Stripe.Customer = await stripe.customers.create(params, opts);