Update generated code for private-preview

API_VERSION

@@ -1 +1 @@
-2025-08-27.basil
+2025-09-30.clover

OPENAPI_VERSION

@@ -1 +1 @@
-f4b80890ea17e89a543a77a389f29ca9be6fe615
+768c16b55352ce5cc78d27c0bbd7448263942018

README.md

@@ -83,7 +83,7 @@ public class StripeExample {
                 .build();
 
         try {
-            Customer customer = client.customers().create(params);
+            Customer customer = client.v1().customers().create(params);
             System.out.println(customer);
         } catch (StripeException e) {
             e.printStackTrace();
@@ -102,7 +102,7 @@ Once the legacy pattern is deprecated, new API endpoints will only be accessible
 
 ### Per-request Configuration
 
-All of the request methods accept an optional `RequestOptions` object. This is
+All the request methods accept an optional `RequestOptions` object. This is
 used if you want to set an [idempotency key][idempotency-keys], if you are
 using [Stripe Connect][connect-auth], or if you want to pass the secret API
 key on each method.
@@ -114,9 +114,9 @@ RequestOptions requestOptions = RequestOptions.builder()
     .setStripeAccount("acct_...")
     .build();
 
-client.customers().list(requestOptions);
+client.v1().customers().list(requestOptions);
 
-client.customers().retrieve("cus_123456789", requestOptions);
+client.v1().customers().retrieve("cus_123456789", requestOptions);
 ```
 
 ### Configuring automatic retries
@@ -137,7 +137,7 @@ Or on a finer grain level using `RequestOptions`:
 RequestOptions options = RequestOptions.builder()
     .setMaxNetworkRetries(2)
     .build();
-client.customers().create(params, options);
+client.v1().customers().create(params, options);
 ```
 
 [Idempotency keys][idempotency-keys] are added to requests to guarantee that
@@ -161,7 +161,7 @@ RequestOptions options = RequestOptions.builder()
     .setConnectTimeout(30 * 1000) // in milliseconds
     .setReadTimeout(80 * 1000)
     .build();
-client.customers().create(params, options);
+client.v1().customers().create(params, options);
 ```
 
 Please take care to set conservative read timeouts. Some API requests can take
@@ -197,15 +197,15 @@ CustomerCreateParams params =
     .putExtraParam("secret_parameter[secondary]", "secondary value")
     .build();
 
-client.customers().create(params);
+client.v1().customers().create(params);
 ```
 
 #### Properties
 
 To retrieve undocumented properties from Stripe using Java you can use an option in the library to return the raw JSON object and return the property as a native type. An example of this is shown below:
 
 ```java
-final Customer customer = client.customers().retrieve("cus_1234");
+final Customer customer = client.v1().customers().retrieve("cus_1234");
 Boolean featureEnabled =
   customer.getRawJsonObject()
     .getAsJsonPrimitive("secret_feature_enabled")

src/main/java/com/stripe/events/V1BillingMeterErrorReportTriggeredEvent.java

@@ -35,7 +35,7 @@ public static final class EventData {
     public static final class Reason {
       /** The total error count within this window. */
       @SerializedName("error_count")
-      Integer errorCount;
+      Long errorCount;
       /** The error details. */
       @SerializedName("error_types")
       List<V1BillingMeterErrorReportTriggeredEvent.EventData.Reason.ErrorType> errorTypes;
@@ -53,7 +53,7 @@ public static final class ErrorType {
         String code;
         /** The number of errors of this type. */
         @SerializedName("error_count")
-        Integer errorCount;
+        Long errorCount;
         /** A list of sample errors of this type. */
         @SerializedName("sample_errors")
         List<V1BillingMeterErrorReportTriggeredEvent.EventData.Reason.ErrorType.SampleError>

src/main/java/com/stripe/events/V1BillingMeterNoMeterFoundEvent.java

@@ -33,7 +33,7 @@ public static final class EventData {
     public static final class Reason {
       /** The total error count within this window. */
       @SerializedName("error_count")
-      Integer errorCount;
+      Long errorCount;
       /** The error details. */
       @SerializedName("error_types")
       List<V1BillingMeterNoMeterFoundEvent.EventData.Reason.ErrorType> errorTypes;
@@ -51,7 +51,7 @@ public static final class ErrorType {
         String code;
         /** The number of errors of this type. */
         @SerializedName("error_count")
-        Integer errorCount;
+        Long errorCount;
         /** A list of sample errors of this type. */
         @SerializedName("sample_errors")
         List<V1BillingMeterNoMeterFoundEvent.EventData.Reason.ErrorType.SampleError> sampleErrors;

src/main/java/com/stripe/events/V2BillingCadenceBilledEvent.java

@@ -5,24 +5,10 @@
 import com.stripe.exception.StripeException;
 import com.stripe.model.v2.Event;
 import com.stripe.model.v2.billing.Cadence;
-import java.util.List;
 import lombok.Getter;
-import lombok.Setter;
 
 @Getter
 public final class V2BillingCadenceBilledEvent extends Event {
-  /** Data for the v2.billing.cadence.billed event. */
-  @SerializedName("data")
-  V2BillingCadenceBilledEvent.EventData data;
-
-  @Getter
-  @Setter
-  public static final class EventData {
-    /** The IDs of the invoices that were generated by the tick for this Cadence. */
-    @SerializedName("invoices")
-    List<String> invoices;
-  }
-
   @SerializedName("related_object")
 
   /** Object containing the reference to API resource relevant to the event. */

src/main/java/com/stripe/events/V2ReportingReportRunFailedEvent.java → src/main/java/com/stripe/events/V2BillingCadenceErroredEvent.java

@@ -4,18 +4,18 @@
 import com.google.gson.annotations.SerializedName;
 import com.stripe.exception.StripeException;
 import com.stripe.model.v2.Event;
-import com.stripe.model.v2.reporting.ReportRun;
+import com.stripe.model.v2.billing.Cadence;
 import lombok.Getter;
 
 @Getter
-public final class V2ReportingReportRunFailedEvent extends Event {
+public final class V2BillingCadenceErroredEvent extends Event {
   @SerializedName("related_object")
 
   /** Object containing the reference to API resource relevant to the event. */
   RelatedObject relatedObject;
 
   /** Retrieves the related object from the API. Make an API request on every call. */
-  public ReportRun fetchRelatedObject() throws StripeException {
-    return (ReportRun) super.fetchRelatedObject(this.relatedObject);
+  public Cadence fetchRelatedObject() throws StripeException {
+    return (Cadence) super.fetchRelatedObject(this.relatedObject);
   }
 }

src/main/java/com/stripe/events/V2CoreAccountPersonCreatedEvent.java

@@ -4,7 +4,7 @@
 import com.google.gson.annotations.SerializedName;
 import com.stripe.exception.StripeException;
 import com.stripe.model.v2.Event;
-import com.stripe.model.v2.core.Person;
+import com.stripe.model.v2.core.AccountPerson;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -28,7 +28,7 @@ public static final class EventData {
   RelatedObject relatedObject;
 
   /** Retrieves the related object from the API. Make an API request on every call. */
-  public Person fetchRelatedObject() throws StripeException {
-    return (Person) super.fetchRelatedObject(this.relatedObject);
+  public AccountPerson fetchRelatedObject() throws StripeException {
+    return (AccountPerson) super.fetchRelatedObject(this.relatedObject);
   }
 }

src/main/java/com/stripe/events/V2CoreAccountPersonDeletedEvent.java

@@ -4,7 +4,7 @@
 import com.google.gson.annotations.SerializedName;
 import com.stripe.exception.StripeException;
 import com.stripe.model.v2.Event;
-import com.stripe.model.v2.core.Person;
+import com.stripe.model.v2.core.AccountPerson;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -28,7 +28,7 @@ public static final class EventData {
   RelatedObject relatedObject;
 
   /** Retrieves the related object from the API. Make an API request on every call. */
-  public Person fetchRelatedObject() throws StripeException {
-    return (Person) super.fetchRelatedObject(this.relatedObject);
+  public AccountPerson fetchRelatedObject() throws StripeException {
+    return (AccountPerson) super.fetchRelatedObject(this.relatedObject);
   }
 }

src/main/java/com/stripe/events/V2CoreAccountPersonUpdatedEvent.java

@@ -4,7 +4,7 @@
 import com.google.gson.annotations.SerializedName;
 import com.stripe.exception.StripeException;
 import com.stripe.model.v2.Event;
-import com.stripe.model.v2.core.Person;
+import com.stripe.model.v2.core.AccountPerson;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -28,7 +28,7 @@ public static final class EventData {
   RelatedObject relatedObject;
 
   /** Retrieves the related object from the API. Make an API request on every call. */
-  public Person fetchRelatedObject() throws StripeException {
-    return (Person) super.fetchRelatedObject(this.relatedObject);
+  public AccountPerson fetchRelatedObject() throws StripeException {
+    return (AccountPerson) super.fetchRelatedObject(this.relatedObject);
   }
 }

src/main/java/com/stripe/events/V2CoreHealthApiErrorFiringEvent.java

@@ -51,7 +51,7 @@ public static final class Impact {
       String httpStatus;
       /** The number of impacted requests. */
       @SerializedName("impacted_requests")
-      Integer impactedRequests;
+      Long impactedRequests;
     }
   }
 }

src/main/java/com/stripe/events/V2CoreHealthApiErrorResolvedEvent.java

@@ -54,7 +54,7 @@ public static final class Impact {
       String httpStatus;
       /** The number of impacted requests. */
       @SerializedName("impacted_requests")
-      Integer impactedRequests;
+      Long impactedRequests;
     }
   }
 }

src/main/java/com/stripe/events/V2CoreHealthApiLatencyFiringEvent.java

@@ -48,7 +48,7 @@ public static final class Impact {
       String httpStatus;
       /** The number of impacted requests. */
       @SerializedName("impacted_requests")
-      Integer impactedRequests;
+      Long impactedRequests;
     }
   }
 }

src/main/java/com/stripe/events/V2CoreHealthApiLatencyResolvedEvent.java

@@ -51,7 +51,7 @@ public static final class Impact {
       String httpStatus;
       /** The number of impacted requests. */
       @SerializedName("impacted_requests")
-      Integer impactedRequests;
+      Long impactedRequests;
     }
   }
 }

src/main/java/com/stripe/events/V2CoreHealthAuthorizationRateDropFiringEvent.java

@@ -3,6 +3,7 @@
 
 import com.google.gson.annotations.SerializedName;
 import com.stripe.model.v2.Event;
+import java.math.BigDecimal;
 import java.time.Instant;
 import java.util.List;
 import lombok.Getter;
@@ -43,7 +44,7 @@ public static final class Impact {
       String chargeType;
       /** The current authorization rate percentage. */
       @SerializedName("current_percentage")
-      String currentPercentage;
+      BigDecimal currentPercentage;
       /** Dimensions that describe what subset of payments are impacted. */
       @SerializedName("dimensions")
       List<V2CoreHealthAuthorizationRateDropFiringEvent.EventData.Impact.Dimension> dimensions;
@@ -65,7 +66,7 @@ public static final class Impact {
       String paymentMethodType;
       /** The previous authorization rate percentage. */
       @SerializedName("previous_percentage")
-      String previousPercentage;
+      BigDecimal previousPercentage;
 
       public static final class Dimension {
         /** The issuer dimension. */

src/main/java/com/stripe/events/V2CoreHealthAuthorizationRateDropResolvedEvent.java

@@ -3,6 +3,7 @@
 
 import com.google.gson.annotations.SerializedName;
 import com.stripe.model.v2.Event;
+import java.math.BigDecimal;
 import java.time.Instant;
 import java.util.List;
 import lombok.Getter;
@@ -46,7 +47,7 @@ public static final class Impact {
       String chargeType;
       /** The current authorization rate percentage. */
       @SerializedName("current_percentage")
-      String currentPercentage;
+      BigDecimal currentPercentage;
       /** Dimensions that describe what subset of payments are impacted. */
       @SerializedName("dimensions")
       List<V2CoreHealthAuthorizationRateDropResolvedEvent.EventData.Impact.Dimension> dimensions;
@@ -68,7 +69,7 @@ public static final class Impact {
       String paymentMethodType;
       /** The previous authorization rate percentage. */
       @SerializedName("previous_percentage")
-      String previousPercentage;
+      BigDecimal previousPercentage;
 
       public static final class Dimension {
         /** The issuer dimension. */