Merge pull request #918 from stripe/remi/codegen-4ec3068

Multiple API changes

Author: remi-stripe

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

@@ -925,7 +925,7 @@ public static class Outcome extends StripeObject {
     /**
      * Possible values are `authorized`, `manual_review`, `issuer_declined`, `blocked`, and
      * `invalid`. See [understanding declines](https://stripe.com/docs/declines) and [Radar
-     * reviews](radar/review) for details.
+     * reviews](https://stripe.com/docs/radar/reviews) for details.
      */
     @SerializedName("type")
     String type;

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

@@ -74,13 +74,9 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
   String cancellationReason;
 
   /**
-   * One of `automatic` (default) or `manual`.
+   * Controls when the funds will be captured from the customer's account.
    *
-   * <p>When the capture method is `automatic`, Stripe automatically captures funds when the
-   * customer authorizes the payment.
-   *
-   * <p>Change `capture_method` to manual if you wish to use [separate authorization and
-   * capture](https://stripe.com/docs/payments/capture-later) for payment methods that support this.
+   * <p>One of `automatic`, or `manual`.
    */
   @SerializedName("capture_method")
   String captureMethod;
@@ -103,18 +99,6 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
   @SerializedName("client_secret")
   String clientSecret;
 
-  /**
-   * One of `automatic` (default) or `manual`.
-   *
-   * <p>When the confirmation method is `automatic`, a PaymentIntent can be confirmed using a
-   * publishable key. After `next_action`s are handled, no additional confirmation is required to
-   * complete the payment.
-   *
-   * <p>When the confirmation method is `manual`, all payment attempts must be made using a secret
-   * key. The PaymentIntent returns to the `requires_confirmation` state after handling
-   * `next_action`s, and requires your server to initiate each payment attempt with an explicit
-   * confirmation.
-   */
   @SerializedName("confirmation_method")
   String confirmationMethod;
 
@@ -235,9 +219,7 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
    * [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer, even after the
    * transaction completes.
    *
-   * <p>Use `on_session` if you intend to only reuse the payment method when your customer is
-   * present in your checkout flow. Use `off_session` if your customer may or may not be in your
-   * checkout flow. For more, learn to [save card details after a
+   * <p>For more, learn to [save card details after a
    * payment](https://stripe.com/docs/payments/save-after-payment).
    *
    * <p>Stripe uses `setup_future_usage` to dynamically optimize your payment flow and comply with
@@ -247,6 +229,8 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
    * collect [off-session
    * payments](https://stripe.com/docs/payments/cards/charging-saved-cards#off-session-payments-with-saved-cards)
    * for this customer.
+   *
+   * <p>One of `off_session`, or `on_session`.
    */
   @SerializedName("setup_future_usage")
   String setupFutureUsage;

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

@@ -85,8 +85,8 @@ public class Session extends ApiResource implements HasId {
    * The IETF language tag of the locale Checkout is displayed in. If blank or `auto`, the browser's
    * locale is used.
    *
-   * <p>One of `auto`, `da`, `de`, `en`, `es`, `fi`, `fr`, `it`, `ja`, `nb`, `nl`, `pl`, `pt`, `sv`,
-   * or `zh`.
+   * <p>One of `auto`, `da`, `de`, `en`, `es`, `fi`, `fr`, `it`, `ja`, `ms`, `nb`, `nl`, `pl`, `pt`,
+   * `sv`, or `zh`.
    */
   @SerializedName("locale")
   String locale;
@@ -125,7 +125,6 @@ public class Session extends ApiResource implements HasId {
    * Describes the type of transaction being performed by Checkout in order to customize relevant
    * text on the page, such as the submit button. `submit_type` can only be specified on Checkout
    * Sessions in `payment` mode, but not Checkout Sessions in `subscription` or `setup` mode.
-   * Supported values are `auto`, `book`, `donate`, or `pay`.
    *
    * <p>One of `auto`, `book`, `donate`, or `pay`.
    */

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

@@ -470,14 +470,14 @@ public static class ViolatedAuthorizationControl extends StripeObject {
   @EqualsAndHashCode(callSuper = false)
   public static class VerificationData extends StripeObject {
     /**
-     * Wether the cardholder provided an address first line and if it matched the cardholder’s
+     * Whether the cardholder provided an address first line and if it matched the cardholder’s
      * `billing.address.line1`. One of `match`, `mismatch`, or `not_provided`.
      */
     @SerializedName("address_line1_check")
     String addressLine1Check;
 
     /**
-     * Wether the cardholder provided a zip (or postal code) and if it matched the cardholder’s
+     * Whether the cardholder provided a zip (or postal code) and if it matched the cardholder’s
      * `billing.address.postal_code`. One of `match`, `mismatch`, or `not_provided`.
      */
     @SerializedName("address_zip_check")
@@ -488,7 +488,7 @@ public static class VerificationData extends StripeObject {
     String authentication;
 
     /**
-     * Wether the cardholder provided a CVC and if it matched Stripe’s record. One of `match`,
+     * Whether the cardholder provided a CVC and if it matched Stripe’s record. One of `match`,
      * `mismatch`, or `not_provided`.
      */
     @SerializedName("cvc_check")

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

@@ -408,7 +408,11 @@ public static class Shipping extends StripeObject {
     @SerializedName("address")
     Address address;
 
-    /** The delivery service that shipped a card. One of `fedex` or `usps`. */
+    /**
+     * The delivery company that shipped a card.
+     *
+     * <p>One of `fedex`, or `usps`.
+     */
     @SerializedName("carrier")
     String carrier;
 

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

@@ -25,6 +25,11 @@
 @Setter
 @EqualsAndHashCode(callSuper = false)
 public class Cardholder extends ApiResource implements HasId, MetadataStore<Cardholder> {
+  /**
+   * Spending rules that give you some control over how this cardholder's cards can be used. Refer
+   * to our [authorizations](https://stripe.com/docs/issuing/authorizations) documentation for more
+   * details.
+   */
   @SerializedName("authorization_controls")
   AuthorizationControls authorizationControls;
 
@@ -256,15 +261,15 @@ public static class AuthorizationControls extends StripeObject {
     /**
      * Array of strings containing
      * [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category)
-     * of authorizations permitted on this card.
+     * of authorizations permitted on this cardholder's cards.
      */
     @SerializedName("allowed_categories")
     List<String> allowedCategories;
 
     /**
      * Array of strings containing
      * [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category)
-     * of authorizations to always decline on this card.
+     * of authorizations to always decline on this cardholder's cards.
      */
     @SerializedName("blocked_categories")
     List<String> blockedCategories;

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

@@ -111,7 +111,10 @@ public class Transaction extends ApiResource
   String object;
 
   /**
-   * One of `capture`, `refund`, `cash_withdrawal`, `refund_reversal`, `dispute`, or `dispute_loss`.
+   * The nature of the transaction.
+   *
+   * <p>One of `capture`, `cash_withdrawal`, `dispute`, `dispute_loss`, `refund`, or
+   * `refund_reversal`.
    */
   @SerializedName("type")
   String type;

src/main/java/com/stripe/model/terminal/Location.java

@@ -5,6 +5,7 @@
 import com.stripe.exception.StripeException;
 import com.stripe.model.Address;
 import com.stripe.model.HasId;
+import com.stripe.model.MetadataStore;
 import com.stripe.net.ApiResource;
 import com.stripe.net.RequestOptions;
 import com.stripe.param.terminal.LocationCreateParams;
@@ -20,7 +21,7 @@
 @Getter
 @Setter
 @EqualsAndHashCode(callSuper = false)
-public class Location extends ApiResource implements HasId {
+public class Location extends ApiResource implements HasId, MetadataStore<Location> {
   @SerializedName("address")
   Address address;
 
@@ -37,6 +38,21 @@ public class Location extends ApiResource implements HasId {
   @SerializedName("id")
   String id;
 
+  /**
+   * Has the value `true` if the object exists in live mode or the value `false` if the object
+   * exists in test mode.
+   */
+  @SerializedName("livemode")
+  Boolean livemode;
+
+  /**
+   * Set of key-value pairs that you can attach to an object. This can be useful for storing
+   * additional information about the object in a structured format.
+   */
+  @Getter(onMethod_ = {@Override})
+  @SerializedName("metadata")
+  Map<String, String> metadata;
+
   /**
    * String representing the object's type. Objects of the same type share the same value.
    *
@@ -108,6 +124,7 @@ public static Location create(LocationCreateParams params, RequestOptions option
    * Updates a <code>Location</code> object by setting the values of the parameters passed. Any
    * parameters not provided will be left unchanged.
    */
+  @Override
   public Location update(Map<String, Object> params) throws StripeException {
     return update(params, (RequestOptions) null);
   }
@@ -116,6 +133,7 @@ public Location update(Map<String, Object> params) throws StripeException {
    * Updates a <code>Location</code> object by setting the values of the parameters passed. Any
    * parameters not provided will be left unchanged.
    */
+  @Override
   public Location update(Map<String, Object> params, RequestOptions options)
       throws StripeException {
     String url =

src/main/java/com/stripe/model/terminal/Reader.java

@@ -4,6 +4,7 @@
 import com.stripe.Stripe;
 import com.stripe.exception.StripeException;
 import com.stripe.model.HasId;
+import com.stripe.model.MetadataStore;
 import com.stripe.net.ApiResource;
 import com.stripe.net.RequestOptions;
 import com.stripe.param.terminal.ReaderCreateParams;
@@ -19,7 +20,7 @@
 @Getter
 @Setter
 @EqualsAndHashCode(callSuper = false)
-public class Reader extends ApiResource implements HasId {
+public class Reader extends ApiResource implements HasId, MetadataStore<Reader> {
   /** Always true for a deleted object. */
   @SerializedName("deleted")
   Boolean deleted;
@@ -45,10 +46,25 @@ public class Reader extends ApiResource implements HasId {
   @SerializedName("label")
   String label;
 
+  /**
+   * Has the value `true` if the object exists in live mode or the value `false` if the object
+   * exists in test mode.
+   */
+  @SerializedName("livemode")
+  Boolean livemode;
+
   /** The location identifier of the reader. */
   @SerializedName("location")
   String location;
 
+  /**
+   * Set of key-value pairs that you can attach to an object. This can be useful for storing
+   * additional information about the object in a structured format.
+   */
+  @Getter(onMethod_ = {@Override})
+  @SerializedName("metadata")
+  Map<String, String> metadata;
+
   /**
    * String representing the object's type. Objects of the same type share the same value.
    *
@@ -69,6 +85,7 @@ public class Reader extends ApiResource implements HasId {
    * Updates a <code>Reader</code> object by setting the values of the parameters passed. Any
    * parameters not provided will be left unchanged.
    */
+  @Override
   public Reader update(Map<String, Object> params) throws StripeException {
     return update(params, (RequestOptions) null);
   }
@@ -77,6 +94,7 @@ public Reader update(Map<String, Object> params) throws StripeException {
    * Updates a <code>Reader</code> object by setting the values of the parameters passed. Any
    * parameters not provided will be left unchanged.
    */
+  @Override
   public Reader update(Map<String, Object> params, RequestOptions options) throws StripeException {
     String url =
         String.format(

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

@@ -30,15 +30,7 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
   @SerializedName("application_fee_amount")
   Long applicationFeeAmount;
 
-  /**
-   * One of `automatic` (default) or `manual`.
-   *
-   * <p>When the capture method is `automatic`, Stripe automatically captures funds when the
-   * customer authorizes the payment.
-   *
-   * <p>Change `capture_method` to manual if you wish to use [separate authorization and
-   * capture](https://stripe.com/docs/payments/capture-later) for payment methods that support this.
-   */
+  /** Controls when the funds will be captured from the customer's account. */
   @SerializedName("capture_method")
   CaptureMethod captureMethod;
 
@@ -51,18 +43,6 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
   @SerializedName("confirm")
   Boolean confirm;
 
-  /**
-   * One of `automatic` (default) or `manual`.
-   *
-   * <p>When the confirmation method is `automatic`, a PaymentIntent can be confirmed using a
-   * publishable key. After `next_action`s are handled, no additional confirmation is required to
-   * complete the payment.
-   *
-   * <p>When the confirmation method is `manual`, all payment attempts must be made using a secret
-   * key. The PaymentIntent returns to the `requires_confirmation` state after handling
-   * `next_action`s, and requires your server to initiate each payment attempt with an explicit
-   * confirmation.
-   */
   @SerializedName("confirmation_method")
   ConfirmationMethod confirmationMethod;
 
@@ -201,9 +181,7 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
    * [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer, even after the
    * transaction completes.
    *
-   * <p>Use `on_session` if you intend to only reuse the payment method when your customer is
-   * present in your checkout flow. Use `off_session` if your customer may or may not be in your
-   * checkout flow. For more, learn to [save card details after a
+   * <p>For more, learn to [save card details after a
    * payment](https://stripe.com/docs/payments/save-after-payment).
    *
    * <p>Stripe uses `setup_future_usage` to dynamically optimize your payment flow and comply with
@@ -454,16 +432,7 @@ public Builder setApplicationFeeAmount(Long applicationFeeAmount) {
       return this;
     }
 
-    /**
-     * One of `automatic` (default) or `manual`.
-     *
-     * <p>When the capture method is `automatic`, Stripe automatically captures funds when the
-     * customer authorizes the payment.
-     *
-     * <p>Change `capture_method` to manual if you wish to use [separate authorization and
-     * capture](https://stripe.com/docs/payments/capture-later) for payment methods that support
-     * this.
-     */
+    /** Controls when the funds will be captured from the customer's account. */
     public Builder setCaptureMethod(CaptureMethod captureMethod) {
       this.captureMethod = captureMethod;
       return this;
@@ -480,18 +449,6 @@ public Builder setConfirm(Boolean confirm) {
       return this;
     }
 
-    /**
-     * One of `automatic` (default) or `manual`.
-     *
-     * <p>When the confirmation method is `automatic`, a PaymentIntent can be confirmed using a
-     * publishable key. After `next_action`s are handled, no additional confirmation is required to
-     * complete the payment.
-     *
-     * <p>When the confirmation method is `manual`, all payment attempts must be made using a secret
-     * key. The PaymentIntent returns to the `requires_confirmation` state after handling
-     * `next_action`s, and requires your server to initiate each payment attempt with an explicit
-     * confirmation.
-     */
     public Builder setConfirmationMethod(ConfirmationMethod confirmationMethod) {
       this.confirmationMethod = confirmationMethod;
       return this;
@@ -746,9 +703,7 @@ public Builder setSavePaymentMethod(Boolean savePaymentMethod) {
      * [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer, even after the
      * transaction completes.
      *
-     * <p>Use `on_session` if you intend to only reuse the payment method when your customer is
-     * present in your checkout flow. Use `off_session` if your customer may or may not be in your
-     * checkout flow. For more, learn to [save card details after a
+     * <p>For more, learn to [save card details after a
      * payment](https://stripe.com/docs/payments/save-after-payment).
      *
      * <p>Stripe uses `setup_future_usage` to dynamically optimize your payment flow and comply with