API Updates

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

@@ -230,8 +230,8 @@ public static class PaymentMethodDetails extends StripeObject {
     @EqualsAndHashCode(callSuper = false)
     public static class AcssDebit extends StripeObject {
       /**
-       * Description of the interval. Only required if 'payment_schedule' parmeter is 'interval' or
-       * 'combined'.
+       * Description of the interval. Only required if the 'payment_schedule' parameter is
+       * 'interval' or 'combined'.
        */
       @SerializedName("interval_description")
       String intervalDescription;

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

@@ -1334,8 +1334,8 @@ public static class MandateOptions extends StripeObject {
         String customMandateUrl;
 
         /**
-         * Description of the interval. Only required if 'payment_schedule' parmeter is 'interval'
-         * or 'combined'.
+         * Description of the interval. Only required if the 'payment_schedule' parameter is
+         * 'interval' or 'combined'.
          */
         @SerializedName("interval_description")
         String intervalDescription;

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

@@ -162,6 +162,12 @@ public void setCustomerObject(Customer expandableObject) {
    * Creates a PaymentMethod object. Read the <a
    * href="https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method">Stripe.js
    * reference</a> to learn how to create PaymentMethods via Stripe.js.
+   *
+   * <p>Instead of creating a PaymentMethod directly, we recommend using the <a
+   * href="https://stripe.com/docs/payments/accept-a-payment">PaymentIntents</a> API to accept a
+   * payment immediately or the <a
+   * href="https://stripe.com/docs/payments/save-and-reuse">SetupIntent</a> API to collect payment
+   * method details ahead of a future payment.
    */
   public static PaymentMethod create(Map<String, Object> params) throws StripeException {
     return create(params, (RequestOptions) null);
@@ -171,6 +177,12 @@ public static PaymentMethod create(Map<String, Object> params) throws StripeExce
    * Creates a PaymentMethod object. Read the <a
    * href="https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method">Stripe.js
    * reference</a> to learn how to create PaymentMethods via Stripe.js.
+   *
+   * <p>Instead of creating a PaymentMethod directly, we recommend using the <a
+   * href="https://stripe.com/docs/payments/accept-a-payment">PaymentIntents</a> API to accept a
+   * payment immediately or the <a
+   * href="https://stripe.com/docs/payments/save-and-reuse">SetupIntent</a> API to collect payment
+   * method details ahead of a future payment.
    */
   public static PaymentMethod create(Map<String, Object> params, RequestOptions options)
       throws StripeException {
@@ -183,6 +195,12 @@ public static PaymentMethod create(Map<String, Object> params, RequestOptions op
    * Creates a PaymentMethod object. Read the <a
    * href="https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method">Stripe.js
    * reference</a> to learn how to create PaymentMethods via Stripe.js.
+   *
+   * <p>Instead of creating a PaymentMethod directly, we recommend using the <a
+   * href="https://stripe.com/docs/payments/accept-a-payment">PaymentIntents</a> API to accept a
+   * payment immediately or the <a
+   * href="https://stripe.com/docs/payments/save-and-reuse">SetupIntent</a> API to collect payment
+   * method details ahead of a future payment.
    */
   public static PaymentMethod create(PaymentMethodCreateParams params) throws StripeException {
     return create(params, (RequestOptions) null);
@@ -192,6 +210,12 @@ public static PaymentMethod create(PaymentMethodCreateParams params) throws Stri
    * Creates a PaymentMethod object. Read the <a
    * href="https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method">Stripe.js
    * reference</a> to learn how to create PaymentMethods via Stripe.js.
+   *
+   * <p>Instead of creating a PaymentMethod directly, we recommend using the <a
+   * href="https://stripe.com/docs/payments/accept-a-payment">PaymentIntents</a> API to accept a
+   * payment immediately or the <a
+   * href="https://stripe.com/docs/payments/save-and-reuse">SetupIntent</a> API to collect payment
+   * method details ahead of a future payment.
    */
   public static PaymentMethod create(PaymentMethodCreateParams params, RequestOptions options)
       throws StripeException {

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

@@ -707,28 +707,31 @@ public LineItemCollection listLineItems(QuoteListLineItemsParams params, Request
   }
 
   /**
-   * When retrieving a quote, there is an includable <strong>upfront.line_items</strong> property
-   * containing the first handful of those items. There is also a URL where you can retrieve the
-   * full (paginated) list of upfront line items.
+   * When retrieving a quote, there is an includable <a
+   * href="https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items"><strong>computed.upfront.line_items</strong></a>
+   * property containing the first handful of those items. There is also a URL where you can
+   * retrieve the full (paginated) list of upfront line items.
    */
   public LineItemCollection listComputedUpfrontLineItems() throws StripeException {
     return listComputedUpfrontLineItems((Map<String, Object>) null, (RequestOptions) null);
   }
 
   /**
-   * When retrieving a quote, there is an includable <strong>upfront.line_items</strong> property
-   * containing the first handful of those items. There is also a URL where you can retrieve the
-   * full (paginated) list of upfront line items.
+   * When retrieving a quote, there is an includable <a
+   * href="https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items"><strong>computed.upfront.line_items</strong></a>
+   * property containing the first handful of those items. There is also a URL where you can
+   * retrieve the full (paginated) list of upfront line items.
    */
   public LineItemCollection listComputedUpfrontLineItems(Map<String, Object> params)
       throws StripeException {
     return listComputedUpfrontLineItems(params, (RequestOptions) null);
   }
 
   /**
-   * When retrieving a quote, there is an includable <strong>upfront.line_items</strong> property
-   * containing the first handful of those items. There is also a URL where you can retrieve the
-   * full (paginated) list of upfront line items.
+   * When retrieving a quote, there is an includable <a
+   * href="https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items"><strong>computed.upfront.line_items</strong></a>
+   * property containing the first handful of those items. There is also a URL where you can
+   * retrieve the full (paginated) list of upfront line items.
    */
   public LineItemCollection listComputedUpfrontLineItems(
       Map<String, Object> params, RequestOptions options) throws StripeException {
@@ -743,19 +746,21 @@ public LineItemCollection listComputedUpfrontLineItems(
   }
 
   /**
-   * When retrieving a quote, there is an includable <strong>upfront.line_items</strong> property
-   * containing the first handful of those items. There is also a URL where you can retrieve the
-   * full (paginated) list of upfront line items.
+   * When retrieving a quote, there is an includable <a
+   * href="https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items"><strong>computed.upfront.line_items</strong></a>
+   * property containing the first handful of those items. There is also a URL where you can
+   * retrieve the full (paginated) list of upfront line items.
    */
   public LineItemCollection listComputedUpfrontLineItems(
       QuoteListComputedUpfrontLineItemsParams params) throws StripeException {
     return listComputedUpfrontLineItems(params, (RequestOptions) null);
   }
 
   /**
-   * When retrieving a quote, there is an includable <strong>upfront.line_items</strong> property
-   * containing the first handful of those items. There is also a URL where you can retrieve the
-   * full (paginated) list of upfront line items.
+   * When retrieving a quote, there is an includable <a
+   * href="https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items"><strong>computed.upfront.line_items</strong></a>
+   * property containing the first handful of those items. There is also a URL where you can
+   * retrieve the full (paginated) list of upfront line items.
    */
   public LineItemCollection listComputedUpfrontLineItems(
       QuoteListComputedUpfrontLineItemsParams params, RequestOptions options)

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

@@ -769,8 +769,8 @@ public static class MandateOptions extends StripeObject {
         String customMandateUrl;
 
         /**
-         * Description of the interval. Only required if 'payment_schedule' parmeter is 'interval'
-         * or 'combined'.
+         * Description of the interval. Only required if the 'payment_schedule' parameter is
+         * 'interval' or 'combined'.
          */
         @SerializedName("interval_description")
         String intervalDescription;

src/main/java/com/stripe/model/checkout/Session.java

@@ -527,8 +527,8 @@ public static class MandateOptions extends StripeObject {
         String customMandateUrl;
 
         /**
-         * Description of the interval. Only required if 'payment_schedule' parmeter is 'interval'
-         * or 'combined'.
+         * Description of the interval. Only required if the 'payment_schedule' parameter is
+         * 'interval' or 'combined'.
          */
         @SerializedName("interval_description")
         String intervalDescription;

src/main/java/com/stripe/model/identity/VerificationSession.java

@@ -121,7 +121,7 @@ public class VerificationSession extends ApiResource
 
   /**
    * The short-lived URL that you use to redirect a user to Stripe to submit their identity
-   * information. This URL expires after 24 hours and can only be used once. Don’t store it, log it,
+   * information. This URL expires after 48 hours and can only be used once. Don’t store it, log it,
    * send it in emails or expose it to anyone other than the user. Refer to our docs on <a
    * href="https://stripe.com/docs/identity/verify-identity-documents?platform=web&amp;type=redirect">verifying
    * identity documents</a> to learn how to redirect users to Stripe.

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

@@ -32,7 +32,7 @@ public class InvoiceUpcomingParams extends ApiRequestParams {
   @SerializedName("customer")
   String customer;
 
-  /** Details about the customer you want to invoice. */
+  /** Details about the customer you want to invoice or overrides for an existing customer. */
   @SerializedName("customer_details")
   CustomerDetails customerDetails;
 
@@ -309,7 +309,7 @@ public Builder setCustomer(String customer) {
       return this;
     }
 
-    /** Details about the customer you want to invoice. */
+    /** Details about the customer you want to invoice or overrides for an existing customer. */
     public Builder setCustomerDetails(CustomerDetails customerDetails) {
       this.customerDetails = customerDetails;
       return this;

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

@@ -5138,9 +5138,9 @@ public static class Sofort {
 
       /** Language shown to the payer on redirect. */
       @SerializedName("preferred_language")
-      PreferredLanguage preferredLanguage;
+      EnumParam preferredLanguage;
 
-      private Sofort(Map<String, Object> extraParams, PreferredLanguage preferredLanguage) {
+      private Sofort(Map<String, Object> extraParams, EnumParam preferredLanguage) {
         this.extraParams = extraParams;
         this.preferredLanguage = preferredLanguage;
       }
@@ -5152,7 +5152,7 @@ public static Builder builder() {
       public static class Builder {
         private Map<String, Object> extraParams;
 
-        private PreferredLanguage preferredLanguage;
+        private EnumParam preferredLanguage;
 
         /** Finalize and obtain parameter instance from this builder. */
         public Sofort build() {
@@ -5192,6 +5192,12 @@ public Builder setPreferredLanguage(PreferredLanguage preferredLanguage) {
           this.preferredLanguage = preferredLanguage;
           return this;
         }
+
+        /** Language shown to the payer on redirect. */
+        public Builder setPreferredLanguage(EmptyParam preferredLanguage) {
+          this.preferredLanguage = preferredLanguage;
+          return this;
+        }
       }
 
       public enum PreferredLanguage implements ApiRequestParams.EnumParam {

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

@@ -3,6 +3,7 @@
 
 import com.google.gson.annotations.SerializedName;
 import com.stripe.net.ApiRequestParams;
+import com.stripe.net.ApiRequestParams.EnumParam;
 import com.stripe.param.common.EmptyParam;
 import java.util.ArrayList;
 import java.util.HashMap;
@@ -5509,9 +5510,9 @@ public static class Sofort {
 
       /** Language shown to the payer on redirect. */
       @SerializedName("preferred_language")
-      PreferredLanguage preferredLanguage;
+      EnumParam preferredLanguage;
 
-      private Sofort(Map<String, Object> extraParams, PreferredLanguage preferredLanguage) {
+      private Sofort(Map<String, Object> extraParams, EnumParam preferredLanguage) {
         this.extraParams = extraParams;
         this.preferredLanguage = preferredLanguage;
       }
@@ -5523,7 +5524,7 @@ public static Builder builder() {
       public static class Builder {
         private Map<String, Object> extraParams;
 
-        private PreferredLanguage preferredLanguage;
+        private EnumParam preferredLanguage;
 
         /** Finalize and obtain parameter instance from this builder. */
         public Sofort build() {
@@ -5563,6 +5564,12 @@ public Builder setPreferredLanguage(PreferredLanguage preferredLanguage) {
           this.preferredLanguage = preferredLanguage;
           return this;
         }
+
+        /** Language shown to the payer on redirect. */
+        public Builder setPreferredLanguage(EmptyParam preferredLanguage) {
+          this.preferredLanguage = preferredLanguage;
+          return this;
+        }
       }
 
       public enum PreferredLanguage implements ApiRequestParams.EnumParam {

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

@@ -5181,9 +5181,9 @@ public static class Sofort {
 
       /** Language shown to the payer on redirect. */
       @SerializedName("preferred_language")
-      PreferredLanguage preferredLanguage;
+      EnumParam preferredLanguage;
 
-      private Sofort(Map<String, Object> extraParams, PreferredLanguage preferredLanguage) {
+      private Sofort(Map<String, Object> extraParams, EnumParam preferredLanguage) {
         this.extraParams = extraParams;
         this.preferredLanguage = preferredLanguage;
       }
@@ -5195,7 +5195,7 @@ public static Builder builder() {
       public static class Builder {
         private Map<String, Object> extraParams;
 
-        private PreferredLanguage preferredLanguage;
+        private EnumParam preferredLanguage;
 
         /** Finalize and obtain parameter instance from this builder. */
         public Sofort build() {
@@ -5235,6 +5235,12 @@ public Builder setPreferredLanguage(PreferredLanguage preferredLanguage) {
           this.preferredLanguage = preferredLanguage;
           return this;
         }
+
+        /** Language shown to the payer on redirect. */
+        public Builder setPreferredLanguage(EmptyParam preferredLanguage) {
+          this.preferredLanguage = preferredLanguage;
+          return this;
+        }
       }
 
       public enum PreferredLanguage implements ApiRequestParams.EnumParam {

src/main/java/com/stripe/param/checkout/SessionCreateParams.java

@@ -17,6 +17,10 @@ public class SessionCreateParams extends ApiRequestParams {
   @SerializedName("allow_promotion_codes")
   Boolean allowPromotionCodes;
 
+  /**
+   * Settings for automatic tax lookup for this session and resulting payments, invoices, and
+   * subscriptions.
+   */
   @SerializedName("automatic_tax")
   AutomaticTax automaticTax;
 
@@ -346,6 +350,10 @@ public Builder setAllowPromotionCodes(Boolean allowPromotionCodes) {
       return this;
     }
 
+    /**
+     * Settings for automatic tax lookup for this session and resulting payments, invoices, and
+     * subscriptions.
+     */
     public Builder setAutomaticTax(AutomaticTax automaticTax) {
       this.automaticTax = automaticTax;
       return this;