Update generated code for beta

OPENAPI_VERSION

@@ -1 +1 @@
-v1232
+v1247

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

@@ -3,5 +3,5 @@
 
 final class ApiVersion {
  public static final String CURRENT = "2024-06-20";
- public static final String PREVIEW_CURRENT = "2024-08-21.preview-v2";
+ public static final String PREVIEW_CURRENT = "2024-09-05.preview-v2";
 }

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

@@ -115,26 +115,27 @@ public class Event extends ApiResource implements HasId {
  * account.external_account.updated}, {@code account.updated}, {@code account_notice.created},
  * {@code account_notice.updated}, {@code application_fee.created}, {@code
  * application_fee.refund.updated}, {@code application_fee.refunded}, {@code balance.available},
- * {@code billing.alert.triggered}, {@code billing_portal.configuration.created}, {@code
- * billing_portal.configuration.updated}, {@code billing_portal.session.created}, {@code
- * capability.updated}, {@code capital.financing_offer.accepted}, {@code
- * capital.financing_offer.canceled}, {@code capital.financing_offer.created}, {@code
- * capital.financing_offer.expired}, {@code capital.financing_offer.fully_repaid}, {@code
- * capital.financing_offer.paid_out}, {@code capital.financing_offer.rejected}, {@code
- * capital.financing_offer.replacement_created}, {@code capital.financing_transaction.created},
- * {@code cash_balance.funds_available}, {@code charge.captured}, {@code charge.dispute.closed},
- * {@code charge.dispute.created}, {@code charge.dispute.funds_reinstated}, {@code
- * charge.dispute.funds_withdrawn}, {@code charge.dispute.updated}, {@code charge.expired}, {@code
- * charge.failed}, {@code charge.pending}, {@code charge.refund.updated}, {@code charge.refunded},
- * {@code charge.succeeded}, {@code charge.updated}, {@code
- * checkout.session.async_payment_failed}, {@code checkout.session.async_payment_succeeded},
- * {@code checkout.session.completed}, {@code checkout.session.expired}, {@code
- * climate.order.canceled}, {@code climate.order.created}, {@code climate.order.delayed}, {@code
- * climate.order.delivered}, {@code climate.order.product_substituted}, {@code
- * climate.product.created}, {@code climate.product.pricing_updated}, {@code coupon.created},
- * {@code coupon.deleted}, {@code coupon.updated}, {@code credit_note.created}, {@code
- * credit_note.updated}, {@code credit_note.voided}, {@code customer.created}, {@code
- * customer.deleted}, {@code customer.discount.created}, {@code customer.discount.deleted}, {@code
+ * {@code billing.alert.triggered}, {@code billing.meter_error_report.triggered}, {@code
+ * billing_portal.configuration.created}, {@code billing_portal.configuration.updated}, {@code
+ * billing_portal.session.created}, {@code capability.updated}, {@code
+ * capital.financing_offer.accepted}, {@code capital.financing_offer.canceled}, {@code
+ * capital.financing_offer.created}, {@code capital.financing_offer.expired}, {@code
+ * capital.financing_offer.fully_repaid}, {@code capital.financing_offer.paid_out}, {@code
+ * capital.financing_offer.rejected}, {@code capital.financing_offer.replacement_created}, {@code
+ * capital.financing_transaction.created}, {@code cash_balance.funds_available}, {@code
+ * charge.captured}, {@code charge.dispute.closed}, {@code charge.dispute.created}, {@code
+ * charge.dispute.funds_reinstated}, {@code charge.dispute.funds_withdrawn}, {@code
+ * charge.dispute.updated}, {@code charge.expired}, {@code charge.failed}, {@code charge.pending},
+ * {@code charge.refund.updated}, {@code charge.refunded}, {@code charge.succeeded}, {@code
+ * charge.updated}, {@code checkout.session.async_payment_failed}, {@code
+ * checkout.session.async_payment_succeeded}, {@code checkout.session.completed}, {@code
+ * checkout.session.expired}, {@code climate.order.canceled}, {@code climate.order.created},
+ * {@code climate.order.delayed}, {@code climate.order.delivered}, {@code
+ * climate.order.product_substituted}, {@code climate.product.created}, {@code
+ * climate.product.pricing_updated}, {@code coupon.created}, {@code coupon.deleted}, {@code
+ * coupon.updated}, {@code credit_note.created}, {@code credit_note.updated}, {@code
+ * credit_note.voided}, {@code customer.created}, {@code customer.deleted}, {@code
+ * customer.discount.created}, {@code customer.discount.deleted}, {@code
  * customer.discount.updated}, {@code customer.source.created}, {@code customer.source.deleted},
  * {@code customer.source.expiring}, {@code customer.source.updated}, {@code
  * customer.subscription.collection_paused}, {@code customer.subscription.collection_resumed},

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

@@ -819,7 +819,9 @@ public PaymentIntent capture(PaymentIntentCaptureParams params, RequestOptions o
  * attempts must be initiated using a secret key. If any actions are required for the payment, the
  * PaymentIntent will return to the {@code requires_confirmation} state after those actions are
  * completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the
- * next payment attempt.
+ * next payment attempt. There is a variable upper limit on how many times a PaymentIntent can be
+ * confirmed. After this limit is reached, any further calls to this endpoint will transition the
+ * PaymentIntent to the {@code canceled} state.
  */
  public PaymentIntent confirm() throws StripeException {
  return confirm((Map<String, Object>) null, (RequestOptions) null);
@@ -843,7 +845,9 @@ public PaymentIntent confirm() throws StripeException {
  * attempts must be initiated using a secret key. If any actions are required for the payment, the
  * PaymentIntent will return to the {@code requires_confirmation} state after those actions are
  * completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the
- * next payment attempt.
+ * next payment attempt. There is a variable upper limit on how many times a PaymentIntent can be
+ * confirmed. After this limit is reached, any further calls to this endpoint will transition the
+ * PaymentIntent to the {@code canceled} state.
  */
  public PaymentIntent confirm(RequestOptions options) throws StripeException {
  return confirm((Map<String, Object>) null, options);
@@ -867,7 +871,9 @@ public PaymentIntent confirm(RequestOptions options) throws StripeException {
  * attempts must be initiated using a secret key. If any actions are required for the payment, the
  * PaymentIntent will return to the {@code requires_confirmation} state after those actions are
  * completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the
- * next payment attempt.
+ * next payment attempt. There is a variable upper limit on how many times a PaymentIntent can be
+ * confirmed. After this limit is reached, any further calls to this endpoint will transition the
+ * PaymentIntent to the {@code canceled} state.
  */
  public PaymentIntent confirm(Map<String, Object> params) throws StripeException {
  return confirm(params, (RequestOptions) null);
@@ -891,7 +897,9 @@ public PaymentIntent confirm(Map<String, Object> params) throws StripeException
  * attempts must be initiated using a secret key. If any actions are required for the payment, the
  * PaymentIntent will return to the {@code requires_confirmation} state after those actions are
  * completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the
- * next payment attempt.
+ * next payment attempt. There is a variable upper limit on how many times a PaymentIntent can be
+ * confirmed. After this limit is reached, any further calls to this endpoint will transition the
+ * PaymentIntent to the {@code canceled} state.
  */
  public PaymentIntent confirm(Map<String, Object> params, RequestOptions options)
  throws StripeException {
@@ -920,7 +928,9 @@ public PaymentIntent confirm(Map<String, Object> params, RequestOptions options)
  * attempts must be initiated using a secret key. If any actions are required for the payment, the
  * PaymentIntent will return to the {@code requires_confirmation} state after those actions are
  * completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the
- * next payment attempt.
+ * next payment attempt. There is a variable upper limit on how many times a PaymentIntent can be
+ * confirmed. After this limit is reached, any further calls to this endpoint will transition the
+ * PaymentIntent to the {@code canceled} state.
  */
  public PaymentIntent confirm(PaymentIntentConfirmParams params) throws StripeException {
  return confirm(params, (RequestOptions) null);
@@ -944,7 +954,9 @@ public PaymentIntent confirm(PaymentIntentConfirmParams params) throws StripeExc
  * attempts must be initiated using a secret key. If any actions are required for the payment, the
  * PaymentIntent will return to the {@code requires_confirmation} state after those actions are
  * completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the
- * next payment attempt.
+ * next payment attempt. There is a variable upper limit on how many times a PaymentIntent can be
+ * confirmed. After this limit is reached, any further calls to this endpoint will transition the
+ * PaymentIntent to the {@code canceled} state.
  */
  public PaymentIntent confirm(PaymentIntentConfirmParams params, RequestOptions options)
  throws StripeException {

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

@@ -125,8 +125,8 @@ public class Transfer extends ApiResource
  Boolean reversed;
 
  /**
- * ID of the charge or payment that was used to fund the transfer. If null, the transfer was
- * funded from the available balance.
+ * ID of the charge that was used to fund the transfer. If null, the transfer was funded from the
+ * available balance.
  */
  @SerializedName("source_transaction")
  @Getter(lombok.AccessLevel.NONE)

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

@@ -327,8 +327,8 @@ public class Session extends ApiResource implements HasId, MetadataStore<Session
 
  /**
  * This parameter applies to {@code ui_mode: embedded}. Learn more about the <a
- * href="https://stripe.com/docs/payments/checkout/custom-redirect-behavior">redirect behavior</a>
- * of embedded sessions. Defaults to {@code always}.
+ * href="https://stripe.com/docs/payments/checkout/custom-success-page?payment-ui=embedded-form">redirect
+ * behavior</a> of embedded sessions. Defaults to {@code always}.
  *
  * <p>One of {@code always}, {@code if_required}, or {@code never}.
  */

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

@@ -224,6 +224,9 @@ public static class Components {
  @SerializedName("payouts_list")
  PayoutsList payoutsList;
 
+ @SerializedName("recipients")
+ Recipients recipients;
+
  /** Configuration for the tax registrations embedded component. */
  @SerializedName("tax_registrations")
  TaxRegistrations taxRegistrations;
@@ -254,6 +257,7 @@ private Components(
  Payments payments,
  Payouts payouts,
  PayoutsList payoutsList,
+ Recipients recipients,
  TaxRegistrations taxRegistrations,
  TaxSettings taxSettings) {
  this.accountManagement = accountManagement;
@@ -277,6 +281,7 @@ private Components(
  this.payments = payments;
  this.payouts = payouts;
  this.payoutsList = payoutsList;
+ this.recipients = recipients;
  this.taxRegistrations = taxRegistrations;
  this.taxSettings = taxSettings;
  }
@@ -328,6 +333,8 @@ public static class Builder {
 
  private PayoutsList payoutsList;
 
+ private Recipients recipients;
+
  private TaxRegistrations taxRegistrations;
 
  private TaxSettings taxSettings;
@@ -356,6 +363,7 @@ public AccountSessionCreateParams.Components build() {
  this.payments,
  this.payouts,
  this.payoutsList,
+ this.recipients,
  this.taxRegistrations,
  this.taxSettings);
  }
@@ -521,6 +529,11 @@ public Builder setPayoutsList(AccountSessionCreateParams.Components.PayoutsList
  return this;
  }
 
+ public Builder setRecipients(AccountSessionCreateParams.Components.Recipients recipients) {
+ this.recipients = recipients;
+ return this;
+ }
+
  /** Configuration for the tax registrations embedded component. */
  public Builder setTaxRegistrations(
  AccountSessionCreateParams.Components.TaxRegistrations taxRegistrations) {
@@ -4024,6 +4037,149 @@ public Builder putAllExtraParam(Map<String, Object> map) {
  }
  }
 
+ @Getter
+ public static class Recipients {
+ /** <strong>Required.</strong> Whether the embedded component is enabled. */
+ @SerializedName("enabled")
+ Boolean enabled;
+
+ /**
+ * 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;
+
+ /** The list of features enabled in the embedded component. */
+ @SerializedName("features")
+ Features features;
+
+ private Recipients(Boolean enabled, Map<String, Object> extraParams, Features features) {
+ this.enabled = enabled;
+ this.extraParams = extraParams;
+ this.features = features;
+ }
+
+ public static Builder builder() {
+ return new Builder();
+ }
+
+ public static class Builder {
+ private Boolean enabled;
+
+ private Map<String, Object> extraParams;
+
+ private Features features;
+
+ /** Finalize and obtain parameter instance from this builder. */
+ public AccountSessionCreateParams.Components.Recipients build() {
+ return new AccountSessionCreateParams.Components.Recipients(
+ this.enabled, this.extraParams, this.features);
+ }
+
+ /** <strong>Required.</strong> Whether the embedded component is enabled. */
+ public Builder setEnabled(Boolean enabled) {
+ this.enabled = enabled;
+ return this;
+ }
+
+ /**
+ * 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 AccountSessionCreateParams.Components.Recipients#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 AccountSessionCreateParams.Components.Recipients#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;
+ }
+
+ /** The list of features enabled in the embedded component. */
+ public Builder setFeatures(
+ AccountSessionCreateParams.Components.Recipients.Features features) {
+ this.features = features;
+ return this;
+ }
+ }
+
+ @Getter
+ public static class Features {
+ /**
+ * 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 Features(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 AccountSessionCreateParams.Components.Recipients.Features build() {
+ return new AccountSessionCreateParams.Components.Recipients.Features(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 AccountSessionCreateParams.Components.Recipients.Features#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 AccountSessionCreateParams.Components.Recipients.Features#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
  public static class TaxRegistrations {
  /** <strong>Required.</strong> Whether the embedded component is enabled. */

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

@@ -5703,6 +5703,9 @@ public enum PaymentMethodType implements ApiRequestParams.EnumParam {
  @SerializedName("link")
  LINK("link"),
 
+ @SerializedName("mb_way")
+ MB_WAY("mb_way"),
+
  @SerializedName("mobilepay")
  MOBILEPAY("mobilepay"),
 

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

@@ -5152,6 +5152,9 @@ public enum PaymentMethodType implements ApiRequestParams.EnumParam {
  @SerializedName("link")
  LINK("link"),
 
+ @SerializedName("mb_way")
+ MB_WAY("mb_way"),
+
  @SerializedName("mobilepay")
  MOBILEPAY("mobilepay"),
 

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

@@ -639,6 +639,9 @@ public enum EnabledEvent implements ApiRequestParams.EnumParam {
  @SerializedName("billing.alert.triggered")
  BILLING__ALERT__TRIGGERED("billing.alert.triggered"),
 
+ @SerializedName("billing.meter_error_report.triggered")
+ BILLING__METER_ERROR_REPORT__TRIGGERED("billing.meter_error_report.triggered"),
+
  @SerializedName("billing_portal.configuration.created")
  BILLING_PORTAL__CONFIGURATION__CREATED("billing_portal.configuration.created"),
 

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

@@ -303,6 +303,9 @@ public enum EnabledEvent implements ApiRequestParams.EnumParam {
  @SerializedName("billing.alert.triggered")
  BILLING__ALERT__TRIGGERED("billing.alert.triggered"),
 
+ @SerializedName("billing.meter_error_report.triggered")
+ BILLING__METER_ERROR_REPORT__TRIGGERED("billing.meter_error_report.triggered"),
+
  @SerializedName("billing_portal.configuration.created")
  BILLING_PORTAL__CONFIGURATION__CREATED("billing_portal.configuration.created"),