Merge pull request #1152 from stripe/ctrudeau/codegen-5a94a49

[codegen] Multiple API changes

Author: ctrudeau-stripe

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

@@ -125,7 +125,8 @@ public class Card extends ApiResource
   Boolean deleted;
 
   /**
-   * Card description. (For internal use only and not typically available in standard API requests.)
+   * A high-level description of the type of cards issued in this range. (For internal use only and
+   * not typically available in standard API requests.)
    */
   @SerializedName("description")
   String description;
@@ -170,8 +171,8 @@ public class Card extends ApiResource
   String iin;
 
   /**
-   * Issuer bank name of the card. (For internal use only and not typically available in standard
-   * API requests.)
+   * The name of the card's issuing bank. (For internal use only and not typically available in
+   * standard API requests.)
    */
   @SerializedName("issuer")
   String issuer;

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

@@ -1350,8 +1350,8 @@ public static class Card extends StripeObject {
       String country;
 
       /**
-       * Card description. (For internal use only and not typically available in standard API
-       * requests.)
+       * A high-level description of the type of cards issued in this range. (For internal use only
+       * and not typically available in standard API requests.)
        */
       @SerializedName("description")
       String description;
@@ -1397,7 +1397,7 @@ public static class Card extends StripeObject {
       Installments installments;
 
       /**
-       * Issuer bank name of the card. (For internal use only and not typically available in
+       * The name of the card's issuing bank. (For internal use only and not typically available in
        * standard API requests.)
        */
       @SerializedName("issuer")
@@ -1657,8 +1657,8 @@ public static class CardPresent extends StripeObject {
       String country;
 
       /**
-       * Card description. (For internal use only and not typically available in standard API
-       * requests.)
+       * A high-level description of the type of cards issued in this range. (For internal use only
+       * and not typically available in standard API requests.)
        */
       @SerializedName("description")
       String description;
@@ -1707,7 +1707,7 @@ public static class CardPresent extends StripeObject {
       String iin;
 
       /**
-       * Issuer bank name of the card. (For internal use only and not typically available in
+       * The name of the card's issuing bank. (For internal use only and not typically available in
        * standard API requests.)
        */
       @SerializedName("issuer")
@@ -1963,8 +1963,8 @@ public static class InteracPresent extends StripeObject {
       String country;
 
       /**
-       * Card description. (For internal use only and not typically available in standard API
-       * requests.)
+       * A high-level description of the type of cards issued in this range. (For internal use only
+       * and not typically available in standard API requests.)
        */
       @SerializedName("description")
       String description;
@@ -2013,7 +2013,7 @@ public static class InteracPresent extends StripeObject {
       String iin;
 
       /**
-       * Issuer bank name of the card. (For internal use only and not typically available in
+       * The name of the card's issuing bank. (For internal use only and not typically available in
        * standard API requests.)
        */
       @SerializedName("issuer")

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

@@ -50,9 +50,11 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
   ExpandableField<Application> application;
 
   /**
-   * The amount of the application fee (if any) requested for the resulting payment. See the
+   * The amount of the application fee (if any) that will be requested to be applied to the payment
+   * and transferred to the application owner's Stripe account. The amount of the application fee
+   * collected will be capped at the total payment amount. For more information, see the
    * PaymentIntents <a href="https://stripe.com/docs/payments/connected-accounts">use case for
-   * connected accounts</a> for details.
+   * connected accounts</a>.
    */
   @SerializedName("application_fee_amount")
   Long applicationFeeAmount;
@@ -95,7 +97,8 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
    * stored, logged, embedded in URLs, or exposed to anyone other than the customer. Make sure that
    * you have TLS enabled on any page that includes the client secret.
    *
-   * <p>Refer to our docs to <a href="https://stripe.com/docs/payments/accept-a-payment">accept a
+   * <p>Refer to our docs to <a
+   * href="https://stripe.com/docs/payments/accept-a-payment?integration=elements">accept a
    * payment</a> and learn about how {@code client_secret} should be handled.
    */
   @SerializedName("client_secret")

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

@@ -517,8 +517,8 @@ public static class Card extends StripeObject {
     String country;
 
     /**
-     * Card description. (For internal use only and not typically available in standard API
-     * requests.)
+     * A high-level description of the type of cards issued in this range. (For internal use only
+     * and not typically available in standard API requests.)
      */
     @SerializedName("description")
     String description;
@@ -554,8 +554,8 @@ public static class Card extends StripeObject {
     String iin;
 
     /**
-     * Issuer bank name of the card. (For internal use only and not typically available in standard
-     * API requests.)
+     * The name of the card's issuing bank. (For internal use only and not typically available in
+     * standard API requests.)
      */
     @SerializedName("issuer")
     String issuer;

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

@@ -711,6 +711,9 @@ public static class PaymentMethodOptions extends StripeObject {
     @SerializedName("card")
     Card card;
 
+    @SerializedName("sepa_debit")
+    SepaDebit sepaDebit;
+
     @Getter
     @Setter
     @EqualsAndHashCode(callSuper = false)
@@ -731,5 +734,10 @@ public static class Card extends StripeObject {
       @SerializedName("request_three_d_secure")
       String requestThreeDSecure;
     }
+
+    @Getter
+    @Setter
+    @EqualsAndHashCode(callSuper = false)
+    public static class SepaDebit extends StripeObject {}
   }
 }

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

@@ -15,7 +15,8 @@ public class CustomerListParams extends ApiRequestParams {
   Object created;
 
   /**
-   * A filter on the list based on the customer's {@code email} field. The value must be a string.
+   * A case-sensitive filter on the list based on the customer's {@code email} field. The value must
+   * be a string.
    */
   @SerializedName("email")
   String email;
@@ -117,7 +118,8 @@ public Builder setCreated(Long created) {
     }
 
     /**
-     * A filter on the list based on the customer's {@code email} field. The value must be a string.
+     * A case-sensitive filter on the list based on the customer's {@code email} field. The value
+     * must be a string.
      */
     public Builder setEmail(String email) {
       this.email = email;

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

@@ -553,9 +553,17 @@ public static class PaymentMethodOptions {
     @SerializedName(ApiRequestParams.EXTRA_PARAMS_KEY)
     Map<String, Object> extraParams;
 
-    private PaymentMethodOptions(Card card, Map<String, Object> extraParams) {
+    /**
+     * If this is a {@code sepa_debit} SetupIntent, this sub-hash contains details about the Sepa
+     * Debit payment method options.
+     */
+    @SerializedName("sepa_debit")
+    SepaDebit sepaDebit;
+
+    private PaymentMethodOptions(Card card, Map<String, Object> extraParams, SepaDebit sepaDebit) {
       this.card = card;
       this.extraParams = extraParams;
+      this.sepaDebit = sepaDebit;
     }
 
     public static Builder builder() {
@@ -567,9 +575,11 @@ public static class Builder {
 
       private Map<String, Object> extraParams;
 
+      private SepaDebit sepaDebit;
+
       /** Finalize and obtain parameter instance from this builder. */
       public PaymentMethodOptions build() {
-        return new PaymentMethodOptions(this.card, this.extraParams);
+        return new PaymentMethodOptions(this.card, this.extraParams, this.sepaDebit);
       }
 
       /** Configuration for any card setup attempted on this SetupIntent. */
@@ -604,6 +614,15 @@ public Builder putAllExtraParam(Map<String, Object> map) {
         this.extraParams.putAll(map);
         return this;
       }
+
+      /**
+       * If this is a {@code sepa_debit} SetupIntent, this sub-hash contains details about the Sepa
+       * Debit payment method options.
+       */
+      public Builder setSepaDebit(SepaDebit sepaDebit) {
+        this.sepaDebit = sepaDebit;
+        return this;
+      }
     }
 
     @Getter
@@ -732,5 +751,62 @@ public enum RequestThreeDSecure implements ApiRequestParams.EnumParam {
         }
       }
     }
+
+    @Getter
+    public static class SepaDebit {
+      /**
+       * Map of extra parameters for custom features not available in this client library. The
+       * content in this map is not serialized under this field's {@code @SerializedName} value.
+       * Instead, each key/value pair is serialized as if the key is a root-level field (serialized)
+       * name in this param object. Effectively, this map is flattened to its parent instance.
+       */
+      @SerializedName(ApiRequestParams.EXTRA_PARAMS_KEY)
+      Map<String, Object> extraParams;
+
+      private SepaDebit(Map<String, Object> extraParams) {
+        this.extraParams = extraParams;
+      }
+
+      public static Builder builder() {
+        return new Builder();
+      }
+
+      public static class Builder {
+        private Map<String, Object> extraParams;
+
+        /** Finalize and obtain parameter instance from this builder. */
+        public SepaDebit build() {
+          return new SepaDebit(this.extraParams);
+        }
+
+        /**
+         * Add a key/value pair to `extraParams` map. A map is initialized for the first
+         * `put/putAll` call, and subsequent calls add additional key/value pairs to the original
+         * map. See {@link SetupIntentConfirmParams.PaymentMethodOptions.SepaDebit#extraParams} for
+         * the field documentation.
+         */
+        public Builder putExtraParam(String key, Object value) {
+          if (this.extraParams == null) {
+            this.extraParams = new HashMap<>();
+          }
+          this.extraParams.put(key, value);
+          return this;
+        }
+
+        /**
+         * Add all map key/value pairs to `extraParams` map. A map is initialized for the first
+         * `put/putAll` call, and subsequent calls add additional key/value pairs to the original
+         * map. See {@link SetupIntentConfirmParams.PaymentMethodOptions.SepaDebit#extraParams} for
+         * the field documentation.
+         */
+        public Builder putAllExtraParam(Map<String, Object> map) {
+          if (this.extraParams == null) {
+            this.extraParams = new HashMap<>();
+          }
+          this.extraParams.putAll(map);
+          return this;
+        }
+      }
+    }
   }
 }

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

@@ -758,9 +758,17 @@ public static class PaymentMethodOptions {
     @SerializedName(ApiRequestParams.EXTRA_PARAMS_KEY)
     Map<String, Object> extraParams;
 
-    private PaymentMethodOptions(Card card, Map<String, Object> extraParams) {
+    /**
+     * If this is a {@code sepa_debit} SetupIntent, this sub-hash contains details about the Sepa
+     * Debit payment method options.
+     */
+    @SerializedName("sepa_debit")
+    SepaDebit sepaDebit;
+
+    private PaymentMethodOptions(Card card, Map<String, Object> extraParams, SepaDebit sepaDebit) {
       this.card = card;
       this.extraParams = extraParams;
+      this.sepaDebit = sepaDebit;
     }
 
     public static Builder builder() {
@@ -772,9 +780,11 @@ public static class Builder {
 
       private Map<String, Object> extraParams;
 
+      private SepaDebit sepaDebit;
+
       /** Finalize and obtain parameter instance from this builder. */
       public PaymentMethodOptions build() {
-        return new PaymentMethodOptions(this.card, this.extraParams);
+        return new PaymentMethodOptions(this.card, this.extraParams, this.sepaDebit);
       }
 
       /** Configuration for any card setup attempted on this SetupIntent. */
@@ -809,6 +819,15 @@ public Builder putAllExtraParam(Map<String, Object> map) {
         this.extraParams.putAll(map);
         return this;
       }
+
+      /**
+       * If this is a {@code sepa_debit} SetupIntent, this sub-hash contains details about the Sepa
+       * Debit payment method options.
+       */
+      public Builder setSepaDebit(SepaDebit sepaDebit) {
+        this.sepaDebit = sepaDebit;
+        return this;
+      }
     }
 
     @Getter
@@ -937,6 +956,63 @@ public enum RequestThreeDSecure implements ApiRequestParams.EnumParam {
         }
       }
     }
+
+    @Getter
+    public static class SepaDebit {
+      /**
+       * Map of extra parameters for custom features not available in this client library. The
+       * content in this map is not serialized under this field's {@code @SerializedName} value.
+       * Instead, each key/value pair is serialized as if the key is a root-level field (serialized)
+       * name in this param object. Effectively, this map is flattened to its parent instance.
+       */
+      @SerializedName(ApiRequestParams.EXTRA_PARAMS_KEY)
+      Map<String, Object> extraParams;
+
+      private SepaDebit(Map<String, Object> extraParams) {
+        this.extraParams = extraParams;
+      }
+
+      public static Builder builder() {
+        return new Builder();
+      }
+
+      public static class Builder {
+        private Map<String, Object> extraParams;
+
+        /** Finalize and obtain parameter instance from this builder. */
+        public SepaDebit build() {
+          return new SepaDebit(this.extraParams);
+        }
+
+        /**
+         * Add a key/value pair to `extraParams` map. A map is initialized for the first
+         * `put/putAll` call, and subsequent calls add additional key/value pairs to the original
+         * map. See {@link SetupIntentCreateParams.PaymentMethodOptions.SepaDebit#extraParams} for
+         * the field documentation.
+         */
+        public Builder putExtraParam(String key, Object value) {
+          if (this.extraParams == null) {
+            this.extraParams = new HashMap<>();
+          }
+          this.extraParams.put(key, value);
+          return this;
+        }
+
+        /**
+         * Add all map key/value pairs to `extraParams` map. A map is initialized for the first
+         * `put/putAll` call, and subsequent calls add additional key/value pairs to the original
+         * map. See {@link SetupIntentCreateParams.PaymentMethodOptions.SepaDebit#extraParams} for
+         * the field documentation.
+         */
+        public Builder putAllExtraParam(Map<String, Object> map) {
+          if (this.extraParams == null) {
+            this.extraParams = new HashMap<>();
+          }
+          this.extraParams.putAll(map);
+          return this;
+        }
+      }
+    }
   }
 
   @Getter