Codegen for openapi v162 (stripe#1387)

pakrym-stripe · web-flow · commit 3fe78b4cac33 · 2022-07-06T12:33:38.000-07:00
diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION
@@ -1 +1 @@
-v161
+v162
diff --git a/src/main/java/com/stripe/model/CashBalance.java b/src/main/java/com/stripe/model/CashBalance.java
@@ -20,7 +20,8 @@
 public class CashBalance extends ApiResource {
   /**
    * A hash of all cash balances available to this customer. You cannot delete a customer with any
-   * cash balances, even if the balance is 0.
+   * cash balances, even if the balance is 0. Amounts are represented in the <a
+   * href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>.
    */
   @SerializedName("available")
   Map<String, Long> available;
@@ -118,12 +119,12 @@ public CashBalance retrieve(
         ApiResource.RequestMethod.GET, url, params, CashBalance.class, options);
   }
 
-  /** Updates a customer’s cash balance. */
+  /** Changes the settings on a customer’s cash balance. */
   public CashBalance update(Map<String, Object> params) throws StripeException {
     return update(params, (RequestOptions) null);
   }
 
-  /** Updates a customer’s cash balance. */
+  /** Changes the settings on a customer’s cash balance. */
   public CashBalance update(Map<String, Object> params, RequestOptions options)
       throws StripeException {
     String url =
@@ -136,12 +137,12 @@ public CashBalance update(Map<String, Object> params, RequestOptions options)
         ApiResource.RequestMethod.POST, url, params, CashBalance.class, options);
   }
 
-  /** Updates a customer’s cash balance. */
+  /** Changes the settings on a customer’s cash balance. */
   public CashBalance update(CashBalanceUpdateParams params) throws StripeException {
     return update(params, (RequestOptions) null);
   }
 
-  /** Updates a customer’s cash balance. */
+  /** Changes the settings on a customer’s cash balance. */
   public CashBalance update(CashBalanceUpdateParams params, RequestOptions options)
       throws StripeException {
     String url =
diff --git a/src/main/java/com/stripe/param/CashBalanceUpdateParams.java b/src/main/java/com/stripe/param/CashBalanceUpdateParams.java
@@ -24,6 +24,7 @@ public class CashBalanceUpdateParams extends ApiRequestParams {
   @SerializedName(ApiRequestParams.EXTRA_PARAMS_KEY)
   Map<String, Object> extraParams;
 
+  /** A hash of settings for this cash balance. */
   @SerializedName("settings")
   Settings settings;
 
@@ -102,6 +103,7 @@ public Builder putAllExtraParam(Map<String, Object> map) {
       return this;
     }
 
+    /** A hash of settings for this cash balance. */
     public Builder setSettings(Settings settings) {
       this.settings = settings;
       return this;
@@ -120,12 +122,10 @@ public static class Settings {
     Map<String, Object> extraParams;
 
     /**
-     * Method for using the customer balance to pay outstanding {@code customer_balance}
-     * PaymentIntents. If set to {@code automatic}, all available funds will automatically be used
-     * to pay any outstanding PaymentIntent. If set to {@code manual}, only customer balance funds
-     * from bank transfers with a reference code matching {@code
-     * payment_intent.next_action.display_bank_transfer_intructions.reference_code} will
-     * automatically be used to pay the corresponding outstanding PaymentIntent.
+     * Controls how funds transferred by the customer are applied to payment intents and invoices.
+     * Valid options are {@code automatic} or {@code manual}. For more information about these
+     * reconciliation modes, see <a
+     * href="https://stripe.com/docs/payments/customer-balance/reconciliation">Reconciliation</a>.
      */
     @SerializedName("reconciliation_mode")
     ReconciliationMode reconciliationMode;
@@ -176,12 +176,10 @@ public Builder putAllExtraParam(Map<String, Object> map) {
       }
 
       /**
-       * Method for using the customer balance to pay outstanding {@code customer_balance}
-       * PaymentIntents. If set to {@code automatic}, all available funds will automatically be used
-       * to pay any outstanding PaymentIntent. If set to {@code manual}, only customer balance funds
-       * from bank transfers with a reference code matching {@code
-       * payment_intent.next_action.display_bank_transfer_intructions.reference_code} will
-       * automatically be used to pay the corresponding outstanding PaymentIntent.
+       * Controls how funds transferred by the customer are applied to payment intents and invoices.
+       * Valid options are {@code automatic} or {@code manual}. For more information about these
+       * reconciliation modes, see <a
+       * href="https://stripe.com/docs/payments/customer-balance/reconciliation">Reconciliation</a>.
        */
       public Builder setReconciliationMode(ReconciliationMode reconciliationMode) {
         this.reconciliationMode = reconciliationMode;
diff --git a/src/main/java/com/stripe/param/CustomerCreateParams.java b/src/main/java/com/stripe/param/CustomerCreateParams.java
@@ -792,12 +792,10 @@ public static class Settings {
       Map<String, Object> extraParams;
 
       /**
-       * Method for using the customer balance to pay outstanding {@code customer_balance}
-       * PaymentIntents. If set to {@code automatic}, all available funds will automatically be used
-       * to pay any outstanding PaymentIntent. If set to {@code manual}, only customer balance funds
-       * from bank transfers with a reference code matching {@code
-       * payment_intent.next_action.display_bank_transfer_intructions.reference_code} will
-       * automatically be used to pay the corresponding outstanding PaymentIntent.
+       * Controls how funds transferred by the customer are applied to payment intents and invoices.
+       * Valid options are {@code automatic} or {@code manual}. For more information about these
+       * reconciliation modes, see <a
+       * href="https://stripe.com/docs/payments/customer-balance/reconciliation">Reconciliation</a>.
        */
       @SerializedName("reconciliation_mode")
       ReconciliationMode reconciliationMode;
@@ -850,12 +848,10 @@ public Builder putAllExtraParam(Map<String, Object> map) {
         }
 
         /**
-         * Method for using the customer balance to pay outstanding {@code customer_balance}
-         * PaymentIntents. If set to {@code automatic}, all available funds will automatically be
-         * used to pay any outstanding PaymentIntent. If set to {@code manual}, only customer
-         * balance funds from bank transfers with a reference code matching {@code
-         * payment_intent.next_action.display_bank_transfer_intructions.reference_code} will
-         * automatically be used to pay the corresponding outstanding PaymentIntent.
+         * Controls how funds transferred by the customer are applied to payment intents and
+         * invoices. Valid options are {@code automatic} or {@code manual}. For more information
+         * about these reconciliation modes, see <a
+         * href="https://stripe.com/docs/payments/customer-balance/reconciliation">Reconciliation</a>.
          */
         public Builder setReconciliationMode(ReconciliationMode reconciliationMode) {
           this.reconciliationMode = reconciliationMode;
diff --git a/src/main/java/com/stripe/param/CustomerUpdateParams.java b/src/main/java/com/stripe/param/CustomerUpdateParams.java
@@ -919,12 +919,10 @@ public static class Settings {
       Map<String, Object> extraParams;
 
       /**
-       * Method for using the customer balance to pay outstanding {@code customer_balance}
-       * PaymentIntents. If set to {@code automatic}, all available funds will automatically be used
-       * to pay any outstanding PaymentIntent. If set to {@code manual}, only customer balance funds
-       * from bank transfers with a reference code matching {@code
-       * payment_intent.next_action.display_bank_transfer_intructions.reference_code} will
-       * automatically be used to pay the corresponding outstanding PaymentIntent.
+       * Controls how funds transferred by the customer are applied to payment intents and invoices.
+       * Valid options are {@code automatic} or {@code manual}. For more information about these
+       * reconciliation modes, see <a
+       * href="https://stripe.com/docs/payments/customer-balance/reconciliation">Reconciliation</a>.
        */
       @SerializedName("reconciliation_mode")
       ReconciliationMode reconciliationMode;
@@ -977,12 +975,10 @@ public Builder putAllExtraParam(Map<String, Object> map) {
         }
 
         /**
-         * Method for using the customer balance to pay outstanding {@code customer_balance}
-         * PaymentIntents. If set to {@code automatic}, all available funds will automatically be
-         * used to pay any outstanding PaymentIntent. If set to {@code manual}, only customer
-         * balance funds from bank transfers with a reference code matching {@code
-         * payment_intent.next_action.display_bank_transfer_intructions.reference_code} will
-         * automatically be used to pay the corresponding outstanding PaymentIntent.
+         * Controls how funds transferred by the customer are applied to payment intents and
+         * invoices. Valid options are {@code automatic} or {@code manual}. For more information
+         * about these reconciliation modes, see <a
+         * href="https://stripe.com/docs/payments/customer-balance/reconciliation">Reconciliation</a>.
          */
         public Builder setReconciliationMode(ReconciliationMode reconciliationMode) {
           this.reconciliationMode = reconciliationMode;
diff --git a/src/main/java/com/stripe/param/PaymentLinkCreateParams.java b/src/main/java/com/stripe/param/PaymentLinkCreateParams.java
@@ -132,7 +132,9 @@ public class PaymentLinkCreateParams extends ApiRequestParams {
 
   /**
    * Describes the type of transaction being performed in order to customize relevant text on the
-   * page, such as the submit button.
+   * page, such as the submit button. Changing this value will also affect the hostname in the <a
+   * href="https://stripe.com/docs/api/payment_links/payment_links/object#url">url</a> property
+   * (example: {@code donate.stripe.com}).
    */
   @SerializedName("submit_type")
   SubmitType submitType;
@@ -529,7 +531,9 @@ public Builder addAllShippingOption(List<ShippingOption> elements) {
 
     /**
      * Describes the type of transaction being performed in order to customize relevant text on the
-     * page, such as the submit button.
+     * page, such as the submit button. Changing this value will also affect the hostname in the <a
+     * href="https://stripe.com/docs/api/payment_links/payment_links/object#url">url</a> property
+     * (example: {@code donate.stripe.com}).
      */
     public Builder setSubmitType(SubmitType submitType) {
       this.submitType = submitType;
diff --git a/src/main/java/com/stripe/param/RefundCreateParams.java b/src/main/java/com/stripe/param/RefundCreateParams.java
@@ -12,12 +12,24 @@
 
 @Getter
 public class RefundCreateParams extends ApiRequestParams {
+  /** A positive integer representing how much to refund. */
   @SerializedName("amount")
   Long amount;
 
   @SerializedName("charge")
   String charge;
 
+  /**
+   * Three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html">ISO currency code</a>,
+   * in lowercase. Must be a <a href="https://stripe.com/docs/currencies">supported currency</a>.
+   */
+  @SerializedName("currency")
+  String currency;
+
+  /** Customer whose customer balance to refund from. */
+  @SerializedName("customer")
+  String customer;
+
   /** Specifies which fields in the response should be expanded. */
   @SerializedName("expand")
   List<String> expand;
@@ -31,6 +43,7 @@ public class RefundCreateParams extends ApiRequestParams {
   @SerializedName(ApiRequestParams.EXTRA_PARAMS_KEY)
   Map<String, Object> extraParams;
 
+  /** Address to send refund email, use customer email if not specified. */
   @SerializedName("instructions_email")
   String instructionsEmail;
 
@@ -43,6 +56,10 @@ public class RefundCreateParams extends ApiRequestParams {
   @SerializedName("metadata")
   Object metadata;
 
+  /** Origin of the refund. */
+  @SerializedName("origin")
+  Origin origin;
+
   @SerializedName("payment_intent")
   String paymentIntent;
 
@@ -58,20 +75,26 @@ public class RefundCreateParams extends ApiRequestParams {
   private RefundCreateParams(
       Long amount,
       String charge,
+      String currency,
+      String customer,
       List<String> expand,
       Map<String, Object> extraParams,
       String instructionsEmail,
       Object metadata,
+      Origin origin,
       String paymentIntent,
       Reason reason,
       Boolean refundApplicationFee,
       Boolean reverseTransfer) {
     this.amount = amount;
     this.charge = charge;
+    this.currency = currency;
+    this.customer = customer;
     this.expand = expand;
     this.extraParams = extraParams;
     this.instructionsEmail = instructionsEmail;
     this.metadata = metadata;
+    this.origin = origin;
     this.paymentIntent = paymentIntent;
     this.reason = reason;
     this.refundApplicationFee = refundApplicationFee;
@@ -87,6 +110,10 @@ public static class Builder {
 
     private String charge;
 
+    private String currency;
+
+    private String customer;
+
     private List<String> expand;
 
     private Map<String, Object> extraParams;
@@ -95,6 +122,8 @@ public static class Builder {
 
     private Object metadata;
 
+    private Origin origin;
+
     private String paymentIntent;
 
     private Reason reason;
@@ -108,16 +137,20 @@ public RefundCreateParams build() {
       return new RefundCreateParams(
           this.amount,
           this.charge,
+          this.currency,
+          this.customer,
           this.expand,
           this.extraParams,
           this.instructionsEmail,
           this.metadata,
+          this.origin,
           this.paymentIntent,
           this.reason,
           this.refundApplicationFee,
           this.reverseTransfer);
     }
 
+    /** A positive integer representing how much to refund. */
     public Builder setAmount(Long amount) {
       this.amount = amount;
       return this;
@@ -128,6 +161,22 @@ public Builder setCharge(String charge) {
       return this;
     }
 
+    /**
+     * Three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html">ISO currency
+     * code</a>, in lowercase. Must be a <a href="https://stripe.com/docs/currencies">supported
+     * currency</a>.
+     */
+    public Builder setCurrency(String currency) {
+      this.currency = currency;
+      return this;
+    }
+
+    /** Customer whose customer balance to refund from. */
+    public Builder setCustomer(String customer) {
+      this.customer = customer;
+      return this;
+    }
+
     /**
      * Add an element to `expand` list. A list is initialized for the first `add/addAll` call, and
      * subsequent calls adds additional elements to the original list. See {@link
@@ -180,6 +229,7 @@ public Builder putAllExtraParam(Map<String, Object> map) {
       return this;
     }
 
+    /** Address to send refund email, use customer email if not specified. */
     public Builder setInstructionsEmail(String instructionsEmail) {
       this.instructionsEmail = instructionsEmail;
       return this;
@@ -235,6 +285,12 @@ public Builder setMetadata(Map<String, String> metadata) {
       return this;
     }
 
+    /** Origin of the refund. */
+    public Builder setOrigin(Origin origin) {
+      this.origin = origin;
+      return this;
+    }
+
     public Builder setPaymentIntent(String paymentIntent) {
       this.paymentIntent = paymentIntent;
       return this;
@@ -256,6 +312,18 @@ public Builder setReverseTransfer(Boolean reverseTransfer) {
     }
   }
 
+  public enum Origin implements ApiRequestParams.EnumParam {
+    @SerializedName("customer_balance")
+    CUSTOMER_BALANCE("customer_balance");
+
+    @Getter(onMethod_ = {@Override})
+    private final String value;
+
+    Origin(String value) {
+      this.value = value;
+    }
+  }
+
   public enum Reason implements ApiRequestParams.EnumParam {
     @SerializedName("duplicate")
     DUPLICATE("duplicate"),
diff --git a/src/main/java/com/stripe/param/WebhookEndpointCreateParams.java b/src/main/java/com/stripe/param/WebhookEndpointCreateParams.java
@@ -750,6 +750,22 @@ public enum EnabledEvent implements ApiRequestParams.EnumParam {
     @SerializedName("file.created")
     FILE__CREATED("file.created"),
 
+    @SerializedName("financial_connections.account.created")
+    FINANCIAL_CONNECTIONS__ACCOUNT__CREATED("financial_connections.account.created"),
+
+    @SerializedName("financial_connections.account.deactivated")
+    FINANCIAL_CONNECTIONS__ACCOUNT__DEACTIVATED("financial_connections.account.deactivated"),
+
+    @SerializedName("financial_connections.account.disconnected")
+    FINANCIAL_CONNECTIONS__ACCOUNT__DISCONNECTED("financial_connections.account.disconnected"),
+
+    @SerializedName("financial_connections.account.reactivated")
+    FINANCIAL_CONNECTIONS__ACCOUNT__REACTIVATED("financial_connections.account.reactivated"),
+
+    @SerializedName("financial_connections.account.refreshed_balance")
+    FINANCIAL_CONNECTIONS__ACCOUNT__REFRESHED_BALANCE(
+        "financial_connections.account.refreshed_balance"),
+
     @SerializedName("identity.verification_session.canceled")
     IDENTITY__VERIFICATION_SESSION__CANCELED("identity.verification_session.canceled"),
 
diff --git a/src/main/java/com/stripe/param/WebhookEndpointUpdateParams.java b/src/main/java/com/stripe/param/WebhookEndpointUpdateParams.java
diff --git a/src/main/java/com/stripe/param/checkout/SessionListParams.java b/src/main/java/com/stripe/param/checkout/SessionListParams.java
diff --git a/src/test/java/com/stripe/functional/GeneratedExamples.java b/src/test/java/com/stripe/functional/GeneratedExamples.java
