[generated] source: spec3.sdk.yaml@spec-d635d94 in master

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

@@ -1214,7 +1214,13 @@ public static class Checks extends StripeObject {
       @Getter
       @Setter
       @EqualsAndHashCode(callSuper = false)
-      public static class ThreeDSecure extends StripeObject {}
+      public static class ThreeDSecure extends StripeObject {
+        @SerializedName("succeeded")
+        Boolean succeeded;
+
+        @SerializedName("version")
+        String version;
+      }
 
       @Getter
       @Setter

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

@@ -244,8 +244,15 @@ public class Invoice extends ApiResource implements HasId, MetadataStore<Invoice
   @SerializedName("paid")
   Boolean paid;
 
+  /**
+   * The PaymentIntent associated with this invoice. The PaymentIntent is generated when the invoice
+   * is finalized, and can then be used to pay the invoice. Note that voiding an invoice will cancel
+   * the PaymentIntent.
+   */
   @SerializedName("payment_intent")
-  PaymentIntent paymentIntent;
+  @Getter(lombok.AccessLevel.NONE)
+  @Setter(lombok.AccessLevel.NONE)
+  ExpandableField<PaymentIntent> paymentIntent;
 
   /** End of the usage period during which invoice items were added to this invoice. */
   @SerializedName("period_end")
@@ -407,6 +414,25 @@ public void setDefaultSourceObject(PaymentSource expandableObject) {
         new ExpandableField<PaymentSource>(expandableObject.getId(), expandableObject);
   }
 
+  /** Get id of expandable `paymentIntent` object. */
+  public String getPaymentIntent() {
+    return (this.paymentIntent != null) ? this.paymentIntent.getId() : null;
+  }
+
+  public void setPaymentIntent(String id) {
+    this.paymentIntent = ApiResource.setExpandableFieldId(id, this.paymentIntent);
+  }
+
+  /** Get expanded `paymentIntent`. */
+  public PaymentIntent getPaymentIntentObject() {
+    return (this.paymentIntent != null) ? this.paymentIntent.getExpanded() : null;
+  }
+
+  public void setPaymentIntentObject(PaymentIntent expandableObject) {
+    this.paymentIntent =
+        new ExpandableField<PaymentIntent>(expandableObject.getId(), expandableObject);
+  }
+
   /** Get id of expandable `subscription` object. */
   public String getSubscription() {
     return (this.subscription != null) ? this.subscription.getId() : null;

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

@@ -197,8 +197,7 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
 
   /**
    * Status of this PaymentIntent, one of `requires_payment_method`, `requires_confirmation`,
-   * `requires_action`, `processing`, `requires_authorization`, `requires_capture`, `canceled`, or
-   * `succeeded`.
+   * `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`.
    */
   @SerializedName("status")
   String status;
@@ -508,9 +507,7 @@ public PaymentIntent update(PaymentIntentUpdateParams params, RequestOptions opt
    * <code>next_action</code>. If payment fails, the PaymentIntent will transition to the <code>
    * requires_payment_method</code> status. If payment succeeds, the PaymentIntent will transition
    * to the <code>succeeded</code> status (or <code>requires_capture</code>, if <code>capture_method
-   * </code> is set to <code>manual</code>). Read the <a
-   * href="/docs/payments/payment-intents/server-confirmation">expanded documentation</a> to learn
-   * more about server-side confirmation.
+   * </code> is set to <code>manual</code>).
    *
    * <p>If the <code>confirmation_method</code> is <code>automatic</code>, payment may be attempted
    * using our <a href="/docs/stripe-js/reference#stripe-handle-card-payment">client SDKs</a> and
@@ -522,7 +519,9 @@ public PaymentIntent update(PaymentIntentUpdateParams params, RequestOptions opt
    * initiated using a secret key. If any actions are required for the payment, the PaymentIntent
    * will return to the <code>requires_confirmation</code> state after those actions are completed.
    * Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment
-   * attempt.
+   * attempt. Read the <a
+   * href="/docs/payments/payment-intents/quickstart#flow-manual-confirmation">expanded
+   * documentation</a> to learn more about manual confirmation.
    */
   public PaymentIntent confirm() throws StripeException {
     return confirm((Map<String, Object>) null, (RequestOptions) null);
@@ -537,9 +536,7 @@ public PaymentIntent confirm() throws StripeException {
    * <code>next_action</code>. If payment fails, the PaymentIntent will transition to the <code>
    * requires_payment_method</code> status. If payment succeeds, the PaymentIntent will transition
    * to the <code>succeeded</code> status (or <code>requires_capture</code>, if <code>capture_method
-   * </code> is set to <code>manual</code>). Read the <a
-   * href="/docs/payments/payment-intents/server-confirmation">expanded documentation</a> to learn
-   * more about server-side confirmation.
+   * </code> is set to <code>manual</code>).
    *
    * <p>If the <code>confirmation_method</code> is <code>automatic</code>, payment may be attempted
    * using our <a href="/docs/stripe-js/reference#stripe-handle-card-payment">client SDKs</a> and
@@ -551,7 +548,9 @@ public PaymentIntent confirm() throws StripeException {
    * initiated using a secret key. If any actions are required for the payment, the PaymentIntent
    * will return to the <code>requires_confirmation</code> state after those actions are completed.
    * Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment
-   * attempt.
+   * attempt. Read the <a
+   * href="/docs/payments/payment-intents/quickstart#flow-manual-confirmation">expanded
+   * documentation</a> to learn more about manual confirmation.
    */
   public PaymentIntent confirm(RequestOptions options) throws StripeException {
     return confirm((Map<String, Object>) null, options);
@@ -566,9 +565,7 @@ public PaymentIntent confirm(RequestOptions options) throws StripeException {
    * <code>next_action</code>. If payment fails, the PaymentIntent will transition to the <code>
    * requires_payment_method</code> status. If payment succeeds, the PaymentIntent will transition
    * to the <code>succeeded</code> status (or <code>requires_capture</code>, if <code>capture_method
-   * </code> is set to <code>manual</code>). Read the <a
-   * href="/docs/payments/payment-intents/server-confirmation">expanded documentation</a> to learn
-   * more about server-side confirmation.
+   * </code> is set to <code>manual</code>).
    *
    * <p>If the <code>confirmation_method</code> is <code>automatic</code>, payment may be attempted
    * using our <a href="/docs/stripe-js/reference#stripe-handle-card-payment">client SDKs</a> and
@@ -580,7 +577,9 @@ public PaymentIntent confirm(RequestOptions options) throws StripeException {
    * initiated using a secret key. If any actions are required for the payment, the PaymentIntent
    * will return to the <code>requires_confirmation</code> state after those actions are completed.
    * Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment
-   * attempt.
+   * attempt. Read the <a
+   * href="/docs/payments/payment-intents/quickstart#flow-manual-confirmation">expanded
+   * documentation</a> to learn more about manual confirmation.
    */
   public PaymentIntent confirm(Map<String, Object> params) throws StripeException {
     return confirm(params, (RequestOptions) null);
@@ -595,9 +594,7 @@ public PaymentIntent confirm(Map<String, Object> params) throws StripeException
    * <code>next_action</code>. If payment fails, the PaymentIntent will transition to the <code>
    * requires_payment_method</code> status. If payment succeeds, the PaymentIntent will transition
    * to the <code>succeeded</code> status (or <code>requires_capture</code>, if <code>capture_method
-   * </code> is set to <code>manual</code>). Read the <a
-   * href="/docs/payments/payment-intents/server-confirmation">expanded documentation</a> to learn
-   * more about server-side confirmation.
+   * </code> is set to <code>manual</code>).
    *
    * <p>If the <code>confirmation_method</code> is <code>automatic</code>, payment may be attempted
    * using our <a href="/docs/stripe-js/reference#stripe-handle-card-payment">client SDKs</a> and
@@ -609,7 +606,9 @@ public PaymentIntent confirm(Map<String, Object> params) throws StripeException
    * initiated using a secret key. If any actions are required for the payment, the PaymentIntent
    * will return to the <code>requires_confirmation</code> state after those actions are completed.
    * Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment
-   * attempt.
+   * attempt. Read the <a
+   * href="/docs/payments/payment-intents/quickstart#flow-manual-confirmation">expanded
+   * documentation</a> to learn more about manual confirmation.
    */
   public PaymentIntent confirm(Map<String, Object> params, RequestOptions options)
       throws StripeException {
@@ -630,9 +629,7 @@ public PaymentIntent confirm(Map<String, Object> params, RequestOptions options)
    * <code>next_action</code>. If payment fails, the PaymentIntent will transition to the <code>
    * requires_payment_method</code> status. If payment succeeds, the PaymentIntent will transition
    * to the <code>succeeded</code> status (or <code>requires_capture</code>, if <code>capture_method
-   * </code> is set to <code>manual</code>). Read the <a
-   * href="/docs/payments/payment-intents/server-confirmation">expanded documentation</a> to learn
-   * more about server-side confirmation.
+   * </code> is set to <code>manual</code>).
    *
    * <p>If the <code>confirmation_method</code> is <code>automatic</code>, payment may be attempted
    * using our <a href="/docs/stripe-js/reference#stripe-handle-card-payment">client SDKs</a> and
@@ -644,7 +641,9 @@ public PaymentIntent confirm(Map<String, Object> params, RequestOptions options)
    * initiated using a secret key. If any actions are required for the payment, the PaymentIntent
    * will return to the <code>requires_confirmation</code> state after those actions are completed.
    * Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment
-   * attempt.
+   * attempt. Read the <a
+   * href="/docs/payments/payment-intents/quickstart#flow-manual-confirmation">expanded
+   * documentation</a> to learn more about manual confirmation.
    */
   public PaymentIntent confirm(PaymentIntentConfirmParams params) throws StripeException {
     return confirm(params, (RequestOptions) null);
@@ -659,9 +658,7 @@ public PaymentIntent confirm(PaymentIntentConfirmParams params) throws StripeExc
    * <code>next_action</code>. If payment fails, the PaymentIntent will transition to the <code>
    * requires_payment_method</code> status. If payment succeeds, the PaymentIntent will transition
    * to the <code>succeeded</code> status (or <code>requires_capture</code>, if <code>capture_method
-   * </code> is set to <code>manual</code>). Read the <a
-   * href="/docs/payments/payment-intents/server-confirmation">expanded documentation</a> to learn
-   * more about server-side confirmation.
+   * </code> is set to <code>manual</code>).
    *
    * <p>If the <code>confirmation_method</code> is <code>automatic</code>, payment may be attempted
    * using our <a href="/docs/stripe-js/reference#stripe-handle-card-payment">client SDKs</a> and
@@ -673,7 +670,9 @@ public PaymentIntent confirm(PaymentIntentConfirmParams params) throws StripeExc
    * initiated using a secret key. If any actions are required for the payment, the PaymentIntent
    * will return to the <code>requires_confirmation</code> state after those actions are completed.
    * Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment
-   * attempt.
+   * attempt. Read the <a
+   * href="/docs/payments/payment-intents/quickstart#flow-manual-confirmation">expanded
+   * documentation</a> to learn more about manual confirmation.
    */
   public PaymentIntent confirm(PaymentIntentConfirmParams params, RequestOptions options)
       throws StripeException {

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

@@ -108,9 +108,9 @@ public class Refund extends ApiResource implements BalanceTransactionSource, Met
   ExpandableField<TransferReversal> sourceTransferReversal;
 
   /**
-   * Status of the refund. For credit card refunds, this can be `succeeded` or `failed`. For other
-   * types of refunds, it can be `pending`, `succeeded`, `failed`, or `canceled`. Refer to our
-   * [refunds](https://stripe.com/docs/refunds#failed-refunds) documentation for more details.
+   * Status of the refund. For credit card refunds, this can be `pending`, `succeeded`, or `failed`.
+   * For other types of refunds, it can be `pending`, `succeeded`, `failed`, or `canceled`. Refer to
+   * our [refunds](https://stripe.com/docs/refunds#failed-refunds) documentation for more details.
    */
   @SerializedName("status")
   String status;

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

@@ -337,6 +337,10 @@ public static class AuthorizationControls extends StripeObject {
      */
     @SerializedName("max_approvals")
     Long maxApprovals;
+
+    /** Limit the spending with rules based on time intervals and categories. */
+    @SerializedName("spending_limits")
+    List<SpendingLimit> spendingLimits;
   }
 
   @Getter
@@ -390,4 +394,28 @@ public static class Shipping extends StripeObject {
     @SerializedName("type")
     String type;
   }
+
+  @Getter
+  @Setter
+  @EqualsAndHashCode(callSuper = false)
+  public static class SpendingLimit extends StripeObject {
+    /** Maximum amount allowed to spend per time interval. */
+    @SerializedName("amount")
+    Long amount;
+
+    /**
+     * Array of strings containing
+     * [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category)
+     * on which to apply the spending limit. Leave this blank to limit all charges.
+     */
+    @SerializedName("categories")
+    List<String> categories;
+
+    /**
+     * The time interval with which to apply this spending limit towards. Allowed values are
+     * `per_authorization`, `daily`, `weekly`, `monthly`, `yearly`, or `all_time`.
+     */
+    @SerializedName("interval")
+    String interval;
+  }
 }

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

@@ -243,6 +243,10 @@ public static class AuthorizationControls extends StripeObject {
      */
     @SerializedName("blocked_categories")
     List<String> blockedCategories;
+
+    /** Limit the spending with rules based on time intervals and categories. */
+    @SerializedName("spending_limits")
+    List<SpendingLimit> spendingLimits;
   }
 
   @Getter
@@ -255,4 +259,28 @@ public static class Billing extends StripeObject {
     @SerializedName("name")
     String name;
   }
+
+  @Getter
+  @Setter
+  @EqualsAndHashCode(callSuper = false)
+  public static class SpendingLimit extends StripeObject {
+    /** Maximum amount allowed to spend per time interval. */
+    @SerializedName("amount")
+    Long amount;
+
+    /**
+     * Array of strings containing
+     * [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category)
+     * on which to apply the spending limit. Leave this blank to limit all charges.
+     */
+    @SerializedName("categories")
+    List<String> categories;
+
+    /**
+     * The time interval with which to apply this spending limit towards. Allowed values are
+     * `per_authorization`, `daily`, `weekly`, `monthly`, `yearly`, or `all_time`.
+     */
+    @SerializedName("interval")
+    String interval;
+  }
 }

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

@@ -36,9 +36,7 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
   /**
    * Set to `true` to attempt to confirm this PaymentIntent immediately. This parameter defaults to
    * `false`. If the payment method attached is a card, a return_url may be provided in case
-   * additional authentication is required. Read the [expanded
-   * documentation](https://stripe.com/docs/payments/payment-intents/server-confirmation) to learn
-   * more about server-side confirmation.
+   * additional authentication is required.
    */
   @SerializedName("confirm")
   Boolean confirm;
@@ -53,7 +51,9 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
    * <p>When the confirmation method is `manual`, all payment attempts must be made using a secret
    * key. The PaymentIntent will return to the `requires_confirmation` state after handling
    * `next_action`s, and requires your server to initiate each payment attempt with an explicit
-   * confirmation.
+   * confirmation. Read the [expanded
+   * documentation](https://stripe.com/docs/payments/payment-intents/quickstart#flow-manual-confirmation)
+   * to learn more about manual confirmation.
    */
   @SerializedName("confirmation_method")
   ConfirmationMethod confirmationMethod;
@@ -304,9 +304,7 @@ public Builder setCaptureMethod(CaptureMethod captureMethod) {
     /**
      * Set to `true` to attempt to confirm this PaymentIntent immediately. This parameter defaults
      * to `false`. If the payment method attached is a card, a return_url may be provided in case
-     * additional authentication is required. Read the [expanded
-     * documentation](https://stripe.com/docs/payments/payment-intents/server-confirmation) to learn
-     * more about server-side confirmation.
+     * additional authentication is required.
      */
     public Builder setConfirm(Boolean confirm) {
       this.confirm = confirm;
@@ -323,7 +321,9 @@ public Builder setConfirm(Boolean confirm) {
      * <p>When the confirmation method is `manual`, all payment attempts must be made using a secret
      * key. The PaymentIntent will return to the `requires_confirmation` state after handling
      * `next_action`s, and requires your server to initiate each payment attempt with an explicit
-     * confirmation.
+     * confirmation. Read the [expanded
+     * documentation](https://stripe.com/docs/payments/payment-intents/quickstart#flow-manual-confirmation)
+     * to learn more about manual confirmation.
      */
     public Builder setConfirmationMethod(ConfirmationMethod confirmationMethod) {
       this.confirmationMethod = confirmationMethod;