Merge pull request #2092 from stripe/latest-codegen-beta

Update generated code for beta

Author: stripe-openapi[bot]

API_VERSION

@@ -1 +1 @@
-577fcb57736b925392ea563c0284df9002c75ac9
+5a9ac40aabbc00a67ae2a186633fc8dd64b25c56

OPENAPI_VERSION

@@ -1 +1 @@
-v2099
+v2103

build.gradle

@@ -29,7 +29,7 @@ tasks.withType(JavaCompile) {
     }
 
     options.fork = true
-    options.forkOptions.jvmArgs += ['-Xms512M', '-Xmx1g']
+    options.forkOptions.jvmArgs += ['-Xms512M', '-Xmx4g']
 
     options.release = project.targetCompatibility.majorVersion as Integer
 

src/main/java/com/stripe/ApiVersion.java

@@ -2,5 +2,5 @@
 package com.stripe;
 
 final class ApiVersion {
-  public static final String CURRENT = "2025-09-30.preview";
+  public static final String CURRENT = "2025-10-29.preview";
 }

src/main/java/com/stripe/model/PaymentIntent.java

@@ -1709,7 +1709,14 @@ public PaymentIntent verifyMicrodeposits(
   @Setter
   @EqualsAndHashCode(callSuper = false)
   public static class AmountDetails extends StripeObject {
-    /** The total discount applied on the transaction. */
+    /**
+     * The total discount applied on the transaction represented in the <a
+     * href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. An integer
+     * greater than 0.
+     *
+     * <p>This field is mutually exclusive with the {@code
+     * amount_details[line_items][#][discount_amount]} field.
+     */
     @SerializedName("discount_amount")
     Long discountAmount;
 
@@ -1737,15 +1744,25 @@ public static class AmountDetails extends StripeObject {
     @Setter
     @EqualsAndHashCode(callSuper = false)
     public static class Shipping extends StripeObject {
-      /** Portion of the amount that is for shipping. */
+      /**
+       * If a physical good is being shipped, the cost of shipping represented in the <a
+       * href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. An
+       * integer greater than or equal to 0.
+       */
       @SerializedName("amount")
       Long amount;
 
-      /** The postal code that represents the shipping source. */
+      /**
+       * If a physical good is being shipped, the postal code of where it is being shipped from. At
+       * most 10 alphanumeric characters long, hyphens are allowed.
+       */
       @SerializedName("from_postal_code")
       String fromPostalCode;
 
-      /** The postal code that represents the shipping destination. */
+      /**
+       * If a physical good is being shipped, the postal code of where it is being shipped to. At
+       * most 10 alphanumeric characters long, hyphens are allowed.
+       */
       @SerializedName("to_postal_code")
       String toPostalCode;
     }
@@ -1758,7 +1775,14 @@ public static class Shipping extends StripeObject {
     @Setter
     @EqualsAndHashCode(callSuper = false)
     public static class Tax extends StripeObject {
-      /** Total portion of the amount that is for tax. */
+      /**
+       * The total amount of tax on the transaction represented in the <a
+       * href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. Required
+       * for L2 rates. An integer greater than or equal to 0.
+       *
+       * <p>This field is mutually exclusive with the {@code
+       * amount_details[line_items][#][tax][total_tax_amount]} field.
+       */
       @SerializedName("total_tax_amount")
       Long totalTaxAmount;
     }
@@ -2790,16 +2814,29 @@ public static class PaymentDetails extends StripeObject {
     CarRental carRental;
 
     /**
-     * Some customers might be required by their company or organization to provide this
-     * information. If so, provide this value. Otherwise you can ignore this field.
+     * A unique value to identify the customer. This field is available only for card payments.
+     *
+     * <p>This field is truncated to 25 alphanumeric characters, excluding spaces, before being sent
+     * to card networks.
      */
     @SerializedName("customer_reference")
     String customerReference;
 
     @SerializedName("event_details")
     EventDetails eventDetails;
 
-    /** A unique value assigned by the business to identify the transaction. */
+    /**
+     * A unique value assigned by the business to identify the transaction. Required for L2 and L3
+     * rates.
+     *
+     * <p>Required when the Payment Method Types array contains {@code card}, including when <a
+     * href="https://stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled">automatic_payment_methods.enabled</a>
+     * is set to {@code true}.
+     *
+     * <p>For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before
+     * being sent to card networks. For Klarna, this field is truncated to 255 characters and is
+     * visible to customers when they view the order in the Klarna app.
+     */
     @SerializedName("order_reference")
     String orderReference;
 

src/main/java/com/stripe/model/PaymentIntentAmountDetailsLineItem.java

@@ -19,7 +19,13 @@
 @Setter
 @EqualsAndHashCode(callSuper = false)
 public class PaymentIntentAmountDetailsLineItem extends ApiResource implements HasId {
-  /** The amount an item was discounted for. Positive integer. */
+  /**
+   * The discount applied on this line item represented in the <a
+   * href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. An integer
+   * greater than 0.
+   *
+   * <p>This field is mutually exclusive with the {@code amount_details[discount_amount]} field.
+   */
   @SerializedName("discount_amount")
   Long discountAmount;
 
@@ -40,27 +46,42 @@ public class PaymentIntentAmountDetailsLineItem extends ApiResource implements H
   @SerializedName("payment_method_options")
   PaymentMethodOptions paymentMethodOptions;
 
-  /** Unique identifier of the product. At most 12 characters long. */
+  /**
+   * The product code of the line item, such as an SKU. Required for L3 rates. At most 12 characters
+   * long.
+   */
   @SerializedName("product_code")
   String productCode;
 
-  /** Name of the product. At most 100 characters long. */
+  /**
+   * The product name of the line item. Required for L3 rates. At most 1024 characters long.
+   *
+   * <p>For Cards, this field is truncated to 26 alphanumeric characters before being sent to the
+   * card networks. For Paypal, this field is truncated to 127 characters.
+   */
   @SerializedName("product_name")
   String productName;
 
-  /** Number of items of the product. Positive integer. */
+  /** The quantity of items. Required for L3 rates. An integer greater than 0. */
   @SerializedName("quantity")
   Long quantity;
 
   /** Contains information about the tax on the item. */
   @SerializedName("tax")
   Tax tax;
 
-  /** Cost of the product. Non-negative integer. */
+  /**
+   * The unit cost of the line item represented in the <a
+   * href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. Required for
+   * L3 rates. An integer greater than or equal to 0.
+   */
   @SerializedName("unit_cost")
   Long unitCost;
 
-  /** A unit of measure for the line item, such as gallons, feet, meters, etc. */
+  /**
+   * A unit of measure for the line item, such as gallons, feet, meters, etc. Required for L3 rates.
+   * At most 12 alphanumeric characters long.
+   */
   @SerializedName("unit_of_measure")
   String unitOfMeasure;
 
@@ -211,7 +232,14 @@ public static class Paypal extends StripeObject {
   @Setter
   @EqualsAndHashCode(callSuper = false)
   public static class Tax extends StripeObject {
-    /** Total portion of the amount that is for tax. */
+    /**
+     * The total amount of tax on the transaction represented in the <a
+     * href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. Required
+     * for L2 rates. An integer greater than or equal to 0.
+     *
+     * <p>This field is mutually exclusive with the {@code
+     * amount_details[line_items][#][tax][total_tax_amount]} field.
+     */
     @SerializedName("total_tax_amount")
     Long totalTaxAmount;
   }

src/main/java/com/stripe/param/ChargeCaptureParams.java

@@ -307,8 +307,10 @@ public static class PaymentDetails {
     CarRental carRental;
 
     /**
-     * Some customers might be required by their company or organization to provide this
-     * information. If so, provide this value. Otherwise you can ignore this field.
+     * A unique value to identify the customer. This field is available only for card payments.
+     *
+     * <p>This field is truncated to 25 alphanumeric characters, excluding spaces, before being sent
+     * to card networks.
      */
     @SerializedName("customer_reference")
     Object customerReference;
@@ -334,7 +336,18 @@ public static class PaymentDetails {
     @SerializedName("lodging")
     Lodging lodging;
 
-    /** A unique value assigned by the business to identify the transaction. */
+    /**
+     * A unique value assigned by the business to identify the transaction. Required for L2 and L3
+     * rates.
+     *
+     * <p>Required when the Payment Method Types array contains {@code card}, including when <a
+     * href="https://stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled">automatic_payment_methods.enabled</a>
+     * is set to {@code true}.
+     *
+     * <p>For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before
+     * being sent to card networks. For Klarna, this field is truncated to 255 characters and is
+     * visible to customers when they view the order in the Klarna app.
+     */
     @SerializedName("order_reference")
     Object orderReference;
 
@@ -402,17 +415,21 @@ public Builder setCarRental(ChargeCaptureParams.PaymentDetails.CarRental carRent
       }
 
       /**
-       * Some customers might be required by their company or organization to provide this
-       * information. If so, provide this value. Otherwise you can ignore this field.
+       * A unique value to identify the customer. This field is available only for card payments.
+       *
+       * <p>This field is truncated to 25 alphanumeric characters, excluding spaces, before being
+       * sent to card networks.
        */
       public Builder setCustomerReference(String customerReference) {
         this.customerReference = customerReference;
         return this;
       }
 
       /**
-       * Some customers might be required by their company or organization to provide this
-       * information. If so, provide this value. Otherwise you can ignore this field.
+       * A unique value to identify the customer. This field is available only for card payments.
+       *
+       * <p>This field is truncated to 25 alphanumeric characters, excluding spaces, before being
+       * sent to card networks.
        */
       public Builder setCustomerReference(EmptyParam customerReference) {
         this.customerReference = customerReference;
@@ -463,13 +480,35 @@ public Builder setLodging(ChargeCaptureParams.PaymentDetails.Lodging lodging) {
         return this;
       }
 
-      /** A unique value assigned by the business to identify the transaction. */
+      /**
+       * A unique value assigned by the business to identify the transaction. Required for L2 and L3
+       * rates.
+       *
+       * <p>Required when the Payment Method Types array contains {@code card}, including when <a
+       * href="https://stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled">automatic_payment_methods.enabled</a>
+       * is set to {@code true}.
+       *
+       * <p>For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces,
+       * before being sent to card networks. For Klarna, this field is truncated to 255 characters
+       * and is visible to customers when they view the order in the Klarna app.
+       */
       public Builder setOrderReference(String orderReference) {
         this.orderReference = orderReference;
         return this;
       }
 
-      /** A unique value assigned by the business to identify the transaction. */
+      /**
+       * A unique value assigned by the business to identify the transaction. Required for L2 and L3
+       * rates.
+       *
+       * <p>Required when the Payment Method Types array contains {@code card}, including when <a
+       * href="https://stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled">automatic_payment_methods.enabled</a>
+       * is set to {@code true}.
+       *
+       * <p>For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces,
+       * before being sent to card networks. For Klarna, this field is truncated to 255 characters
+       * and is visible to customers when they view the order in the Klarna app.
+       */
       public Builder setOrderReference(EmptyParam orderReference) {
         this.orderReference = orderReference;
         return this;

src/main/java/com/stripe/param/ChargeUpdateParams.java

@@ -454,8 +454,10 @@ public static class PaymentDetails {
     CarRental carRental;
 
     /**
-     * Some customers might be required by their company or organization to provide this
-     * information. If so, provide this value. Otherwise you can ignore this field.
+     * A unique value to identify the customer. This field is available only for card payments.
+     *
+     * <p>This field is truncated to 25 alphanumeric characters, excluding spaces, before being sent
+     * to card networks.
      */
     @SerializedName("customer_reference")
     Object customerReference;
@@ -481,7 +483,18 @@ public static class PaymentDetails {
     @SerializedName("lodging")
     Lodging lodging;
 
-    /** A unique value assigned by the business to identify the transaction. */
+    /**
+     * A unique value assigned by the business to identify the transaction. Required for L2 and L3
+     * rates.
+     *
+     * <p>Required when the Payment Method Types array contains {@code card}, including when <a
+     * href="https://stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled">automatic_payment_methods.enabled</a>
+     * is set to {@code true}.
+     *
+     * <p>For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before
+     * being sent to card networks. For Klarna, this field is truncated to 255 characters and is
+     * visible to customers when they view the order in the Klarna app.
+     */
     @SerializedName("order_reference")
     Object orderReference;
 
@@ -549,17 +562,21 @@ public Builder setCarRental(ChargeUpdateParams.PaymentDetails.CarRental carRenta
       }
 
       /**
-       * Some customers might be required by their company or organization to provide this
-       * information. If so, provide this value. Otherwise you can ignore this field.
+       * A unique value to identify the customer. This field is available only for card payments.
+       *
+       * <p>This field is truncated to 25 alphanumeric characters, excluding spaces, before being
+       * sent to card networks.
        */
       public Builder setCustomerReference(String customerReference) {
         this.customerReference = customerReference;
         return this;
       }
 
       /**
-       * Some customers might be required by their company or organization to provide this
-       * information. If so, provide this value. Otherwise you can ignore this field.
+       * A unique value to identify the customer. This field is available only for card payments.
+       *
+       * <p>This field is truncated to 25 alphanumeric characters, excluding spaces, before being
+       * sent to card networks.
        */
       public Builder setCustomerReference(EmptyParam customerReference) {
         this.customerReference = customerReference;
@@ -610,13 +627,35 @@ public Builder setLodging(ChargeUpdateParams.PaymentDetails.Lodging lodging) {
         return this;
       }
 
-      /** A unique value assigned by the business to identify the transaction. */
+      /**
+       * A unique value assigned by the business to identify the transaction. Required for L2 and L3
+       * rates.
+       *
+       * <p>Required when the Payment Method Types array contains {@code card}, including when <a
+       * href="https://stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled">automatic_payment_methods.enabled</a>
+       * is set to {@code true}.
+       *
+       * <p>For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces,
+       * before being sent to card networks. For Klarna, this field is truncated to 255 characters
+       * and is visible to customers when they view the order in the Klarna app.
+       */
       public Builder setOrderReference(String orderReference) {
         this.orderReference = orderReference;
         return this;
       }
 
-      /** A unique value assigned by the business to identify the transaction. */
+      /**
+       * A unique value assigned by the business to identify the transaction. Required for L2 and L3
+       * rates.
+       *
+       * <p>Required when the Payment Method Types array contains {@code card}, including when <a
+       * href="https://stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled">automatic_payment_methods.enabled</a>
+       * is set to {@code true}.
+       *
+       * <p>For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces,
+       * before being sent to card networks. For Klarna, this field is truncated to 255 characters
+       * and is visible to customers when they view the order in the Klarna app.
+       */
       public Builder setOrderReference(EmptyParam orderReference) {
         this.orderReference = orderReference;
         return this;