Codegen for openapi v204 (#1466)

OPENAPI_VERSION

@@ -1 +1 @@
-v203
+v204

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

@@ -21,6 +21,10 @@
  * {@code Refund} objects allow you to refund a charge that has previously been created but not yet
  * refunded. Funds will be refunded to the credit or debit card that was originally charged.
  *
+ * <p>Stripe Tax users with recurring payments and invoices can create <a
+ * href="https://stripe.com/docs/api/credit_notes">Credit Notes</a>, which reduce overall tax
+ * liability because tax is correctly recalculated and apportioned to the related invoice.
+ *
  * <p>Related guide: <a href="https://stripe.com/docs/refunds">Refunds</a>.
  */
 @Getter

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

@@ -228,6 +228,15 @@ public class Subscription extends ApiResource implements HasId, MetadataStore<Su
   @SerializedName("object")
   String object;
 
+  /**
+   * The account (if any) the charge was made on behalf of for charges associated with this
+   * subscription. See the Connect documentation for details.
+   */
+  @SerializedName("on_behalf_of")
+  @Getter(lombok.AccessLevel.NONE)
+  @Setter(lombok.AccessLevel.NONE)
+  ExpandableField<Account> onBehalfOf;
+
   /** If specified, payment collection for this subscription will be paused. */
   @SerializedName("pause_collection")
   PauseCollection pauseCollection;
@@ -422,6 +431,24 @@ public void setLatestInvoiceObject(Invoice expandableObject) {
     this.latestInvoice = new ExpandableField<Invoice>(expandableObject.getId(), expandableObject);
   }
 
+  /** Get ID of expandable {@code onBehalfOf} object. */
+  public String getOnBehalfOf() {
+    return (this.onBehalfOf != null) ? this.onBehalfOf.getId() : null;
+  }
+
+  public void setOnBehalfOf(String id) {
+    this.onBehalfOf = ApiResource.setExpandableFieldId(id, this.onBehalfOf);
+  }
+
+  /** Get expanded {@code onBehalfOf}. */
+  public Account getOnBehalfOfObject() {
+    return (this.onBehalfOf != null) ? this.onBehalfOf.getExpanded() : null;
+  }
+
+  public void setOnBehalfOfObject(Account expandableObject) {
+    this.onBehalfOf = new ExpandableField<Account>(expandableObject.getId(), expandableObject);
+  }
+
   /** Get ID of expandable {@code pendingSetupIntent} object. */
   public String getPendingSetupIntent() {
     return (this.pendingSetupIntent != null) ? this.pendingSetupIntent.getId() : null;

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

@@ -649,6 +649,15 @@ public static class DefaultSettings extends StripeObject {
     @SerializedName("invoice_settings")
     InvoiceSettings invoiceSettings;
 
+    /**
+     * The account (if any) the charge was made on behalf of for charges associated with the
+     * schedule's subscription. See the Connect documentation for details.
+     */
+    @SerializedName("on_behalf_of")
+    @Getter(lombok.AccessLevel.NONE)
+    @Setter(lombok.AccessLevel.NONE)
+    ExpandableField<Account> onBehalfOf;
+
     /**
      * The account (if any) the associated subscription's payments will be attributed to for tax
      * reporting, and where funds from each payment will be transferred to for each of the
@@ -676,6 +685,24 @@ public void setDefaultPaymentMethodObject(PaymentMethod expandableObject) {
           new ExpandableField<PaymentMethod>(expandableObject.getId(), expandableObject);
     }
 
+    /** Get ID of expandable {@code onBehalfOf} object. */
+    public String getOnBehalfOf() {
+      return (this.onBehalfOf != null) ? this.onBehalfOf.getId() : null;
+    }
+
+    public void setOnBehalfOf(String id) {
+      this.onBehalfOf = ApiResource.setExpandableFieldId(id, this.onBehalfOf);
+    }
+
+    /** Get expanded {@code onBehalfOf}. */
+    public Account getOnBehalfOfObject() {
+      return (this.onBehalfOf != null) ? this.onBehalfOf.getExpanded() : null;
+    }
+
+    public void setOnBehalfOfObject(Account expandableObject) {
+      this.onBehalfOf = new ExpandableField<Account>(expandableObject.getId(), expandableObject);
+    }
+
     @Getter
     @Setter
     @EqualsAndHashCode(callSuper = false)
@@ -817,6 +844,15 @@ public static class Phase extends StripeObject {
     @SerializedName("metadata")
     Map<String, String> metadata;
 
+    /**
+     * The account (if any) the charge was made on behalf of for charges associated with the
+     * schedule's subscription. See the Connect documentation for details.
+     */
+    @SerializedName("on_behalf_of")
+    @Getter(lombok.AccessLevel.NONE)
+    @Setter(lombok.AccessLevel.NONE)
+    ExpandableField<Account> onBehalfOf;
+
     /**
      * If the subscription schedule will prorate when transitioning to this phase. Possible values
      * are {@code create_prorations} and {@code none}.
@@ -879,6 +915,24 @@ public void setDefaultPaymentMethodObject(PaymentMethod expandableObject) {
           new ExpandableField<PaymentMethod>(expandableObject.getId(), expandableObject);
     }
 
+    /** Get ID of expandable {@code onBehalfOf} object. */
+    public String getOnBehalfOf() {
+      return (this.onBehalfOf != null) ? this.onBehalfOf.getId() : null;
+    }
+
+    public void setOnBehalfOf(String id) {
+      this.onBehalfOf = ApiResource.setExpandableFieldId(id, this.onBehalfOf);
+    }
+
+    /** Get expanded {@code onBehalfOf}. */
+    public Account getOnBehalfOfObject() {
+      return (this.onBehalfOf != null) ? this.onBehalfOf.getExpanded() : null;
+    }
+
+    public void setOnBehalfOfObject(Account expandableObject) {
+      this.onBehalfOf = new ExpandableField<Account>(expandableObject.getId(), expandableObject);
+    }
+
     @Getter
     @Setter
     @EqualsAndHashCode(callSuper = false)

src/main/java/com/stripe/model/issuing/Authorization.java

@@ -215,7 +215,9 @@ public void setCardholderObject(Cardholder expandableObject) {
    * Approves a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real-time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to approve an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization approve() throws StripeException {
     return approve((Map<String, Object>) null, (RequestOptions) null);
@@ -225,7 +227,9 @@ public Authorization approve() throws StripeException {
    * Approves a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real-time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to approve an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization approve(RequestOptions options) throws StripeException {
     return approve((Map<String, Object>) null, options);
@@ -235,7 +239,9 @@ public Authorization approve(RequestOptions options) throws StripeException {
    * Approves a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real-time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to approve an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization approve(Map<String, Object> params) throws StripeException {
     return approve(params, (RequestOptions) null);
@@ -245,7 +251,9 @@ public Authorization approve(Map<String, Object> params) throws StripeException
    * Approves a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real-time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to approve an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization approve(Map<String, Object> params, RequestOptions options)
       throws StripeException {
@@ -263,7 +271,9 @@ public Authorization approve(Map<String, Object> params, RequestOptions options)
    * Approves a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real-time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to approve an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization approve(AuthorizationApproveParams params) throws StripeException {
     return approve(params, (RequestOptions) null);
@@ -273,7 +283,9 @@ public Authorization approve(AuthorizationApproveParams params) throws StripeExc
    * Approves a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real-time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to approve an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization approve(AuthorizationApproveParams params, RequestOptions options)
       throws StripeException {
@@ -291,7 +303,9 @@ public Authorization approve(AuthorizationApproveParams params, RequestOptions o
    * Declines a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to decline an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization decline() throws StripeException {
     return decline((Map<String, Object>) null, (RequestOptions) null);
@@ -301,7 +315,9 @@ public Authorization decline() throws StripeException {
    * Declines a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to decline an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization decline(RequestOptions options) throws StripeException {
     return decline((Map<String, Object>) null, options);
@@ -311,7 +327,9 @@ public Authorization decline(RequestOptions options) throws StripeException {
    * Declines a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to decline an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization decline(Map<String, Object> params) throws StripeException {
     return decline(params, (RequestOptions) null);
@@ -321,7 +339,9 @@ public Authorization decline(Map<String, Object> params) throws StripeException
    * Declines a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to decline an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization decline(Map<String, Object> params, RequestOptions options)
       throws StripeException {
@@ -339,7 +359,9 @@ public Authorization decline(Map<String, Object> params, RequestOptions options)
    * Declines a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to decline an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization decline(AuthorizationDeclineParams params) throws StripeException {
     return decline(params, (RequestOptions) null);
@@ -349,7 +371,9 @@ public Authorization decline(AuthorizationDeclineParams params) throws StripeExc
    * Declines a pending Issuing <code>Authorization</code> object. This request should be made
    * within the timeout window of the <a
    * href="https://stripe.com/docs/issuing/controls/real-time-authorizations">real time
-   * authorization</a> flow.
+   * authorization</a> flow. You can also respond directly to the webhook request to decline an
+   * authorization (preferred). More details can be found <a
+   * href="https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
    */
   public Authorization decline(AuthorizationDeclineParams params, RequestOptions options)
       throws StripeException {

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

@@ -112,6 +112,18 @@ public class InvoiceItemCreateParams extends ApiRequestParams {
   @SerializedName("subscription")
   String subscription;
 
+  /**
+   * Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
+   * {@code inclusive}, {@code exclusive}, or {@code unspecified}. Once specified as either {@code
+   * inclusive} or {@code exclusive}, it cannot be changed.
+   */
+  @SerializedName("tax_behavior")
+  TaxBehavior taxBehavior;
+
+  /** A <a href="https://stripe.com/docs/tax/tax-categories">tax code</a> ID. */
+  @SerializedName("tax_code")
+  Object taxCode;
+
   /**
    * The tax rates which apply to the invoice item. When set, the {@code default_tax_rates} on the
    * invoice do not apply to this invoice item.
@@ -152,6 +164,8 @@ private InvoiceItemCreateParams(
       PriceData priceData,
       Long quantity,
       String subscription,
+      TaxBehavior taxBehavior,
+      Object taxCode,
       List<String> taxRates,
       Long unitAmount,
       BigDecimal unitAmountDecimal) {
@@ -170,6 +184,8 @@ private InvoiceItemCreateParams(
     this.priceData = priceData;
     this.quantity = quantity;
     this.subscription = subscription;
+    this.taxBehavior = taxBehavior;
+    this.taxCode = taxCode;
     this.taxRates = taxRates;
     this.unitAmount = unitAmount;
     this.unitAmountDecimal = unitAmountDecimal;
@@ -210,6 +226,10 @@ public static class Builder {
 
     private String subscription;
 
+    private TaxBehavior taxBehavior;
+
+    private Object taxCode;
+
     private List<String> taxRates;
 
     private Long unitAmount;
@@ -234,6 +254,8 @@ public InvoiceItemCreateParams build() {
           this.priceData,
           this.quantity,
           this.subscription,
+          this.taxBehavior,
+          this.taxCode,
           this.taxRates,
           this.unitAmount,
           this.unitAmountDecimal);
@@ -478,6 +500,28 @@ public Builder setSubscription(String subscription) {
       return this;
     }
 
+    /**
+     * Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
+     * {@code inclusive}, {@code exclusive}, or {@code unspecified}. Once specified as either {@code
+     * inclusive} or {@code exclusive}, it cannot be changed.
+     */
+    public Builder setTaxBehavior(InvoiceItemCreateParams.TaxBehavior taxBehavior) {
+      this.taxBehavior = taxBehavior;
+      return this;
+    }
+
+    /** A <a href="https://stripe.com/docs/tax/tax-categories">tax code</a> ID. */
+    public Builder setTaxCode(String taxCode) {
+      this.taxCode = taxCode;
+      return this;
+    }
+
+    /** A <a href="https://stripe.com/docs/tax/tax-categories">tax code</a> ID. */
+    public Builder setTaxCode(EmptyParam taxCode) {
+      this.taxCode = taxCode;
+      return this;
+    }
+
     /**
      * Add an element to `taxRates` list. A list is initialized for the first `add/addAll` call, and
      * subsequent calls adds additional elements to the original list. See {@link
@@ -867,4 +911,22 @@ public enum TaxBehavior implements ApiRequestParams.EnumParam {
       }
     }
   }
+
+  public enum TaxBehavior implements ApiRequestParams.EnumParam {
+    @SerializedName("exclusive")
+    EXCLUSIVE("exclusive"),
+
+    @SerializedName("inclusive")
+    INCLUSIVE("inclusive"),
+
+    @SerializedName("unspecified")
+    UNSPECIFIED("unspecified");
+
+    @Getter(onMethod_ = {@Override})
+    private final String value;
+
+    TaxBehavior(String value) {
+      this.value = value;
+    }
+  }
 }