Codegen for openapi 4d4a107 (#850)

* Codegen for openapi 4d4a107

Author: richardm-stripe

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

@@ -337,51 +337,51 @@ public static Account create(AccountCreateParams params, RequestOptions options)
   }
 
   /**
-   * With <a href="/docs/connect">Connect</a>, you may delete Custom accounts you manage.
+   * With <a href="/docs/connect">Connect</a>, you can delete Custom or Express accounts you manage.
    *
-   * <p>Custom accounts created using test-mode keys can be deleted at any time. Custom accounts
-   * created using live-mode keys may only be deleted once all balances are zero.
+   * <p>Accounts created using test-mode keys can be deleted at any time. Accounts created using
+   * live-mode keys can only be deleted once all balances are zero.
    *
-   * <p>If you are looking to close your own account, use the <a
+   * <p>If you want to delete your own account, use the <a
    * href="https://dashboard.stripe.com/account/data">data tab in your account settings</a> instead.
    */
   public Account delete() throws StripeException {
     return delete((Map<String, Object>) null, (RequestOptions) null);
   }
 
   /**
-   * With <a href="/docs/connect">Connect</a>, you may delete Custom accounts you manage.
+   * With <a href="/docs/connect">Connect</a>, you can delete Custom or Express accounts you manage.
    *
-   * <p>Custom accounts created using test-mode keys can be deleted at any time. Custom accounts
-   * created using live-mode keys may only be deleted once all balances are zero.
+   * <p>Accounts created using test-mode keys can be deleted at any time. Accounts created using
+   * live-mode keys can only be deleted once all balances are zero.
    *
-   * <p>If you are looking to close your own account, use the <a
+   * <p>If you want to delete your own account, use the <a
    * href="https://dashboard.stripe.com/account/data">data tab in your account settings</a> instead.
    */
   public Account delete(RequestOptions options) throws StripeException {
     return delete((Map<String, Object>) null, options);
   }
 
   /**
-   * With <a href="/docs/connect">Connect</a>, you may delete Custom accounts you manage.
+   * With <a href="/docs/connect">Connect</a>, you can delete Custom or Express accounts you manage.
    *
-   * <p>Custom accounts created using test-mode keys can be deleted at any time. Custom accounts
-   * created using live-mode keys may only be deleted once all balances are zero.
+   * <p>Accounts created using test-mode keys can be deleted at any time. Accounts created using
+   * live-mode keys can only be deleted once all balances are zero.
    *
-   * <p>If you are looking to close your own account, use the <a
+   * <p>If you want to delete your own account, use the <a
    * href="https://dashboard.stripe.com/account/data">data tab in your account settings</a> instead.
    */
   public Account delete(Map<String, Object> params) throws StripeException {
     return delete(params, (RequestOptions) null);
   }
 
   /**
-   * With <a href="/docs/connect">Connect</a>, you may delete Custom accounts you manage.
+   * With <a href="/docs/connect">Connect</a>, you can delete Custom or Express accounts you manage.
    *
-   * <p>Custom accounts created using test-mode keys can be deleted at any time. Custom accounts
-   * created using live-mode keys may only be deleted once all balances are zero.
+   * <p>Accounts created using test-mode keys can be deleted at any time. Accounts created using
+   * live-mode keys can only be deleted once all balances are zero.
    *
-   * <p>If you are looking to close your own account, use the <a
+   * <p>If you want to delete your own account, use the <a
    * href="https://dashboard.stripe.com/account/data">data tab in your account settings</a> instead.
    */
   public Account delete(Map<String, Object> params, RequestOptions options) throws StripeException {
@@ -857,9 +857,9 @@ public static class Requirements extends StripeObject {
     List<String> pastDue;
 
     /**
-     * Additional fields that may be required depending on the results of verification or review for
-     * provided requirements. If any of these fields become required, they appear in `currently_due`
-     * or `past_due`.
+     * Fields that may become required depending on the results of verification or review. An empty
+     * array unless an asynchronous verification is pending. If verification fails, the fields in
+     * this array become required and move to `currently_due` or `past_due`.
      */
     @SerializedName("pending_verification")
     List<String> pendingVerification;

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

@@ -145,9 +145,9 @@ public static class Requirements extends StripeObject {
     List<String> pastDue;
 
     /**
-     * Additional fields that may be required depending on the results of verification or review for
-     * provided requirements. If any of these fields become required, they appear in `currently_due`
-     * or `past_due`.
+     * Fields that may become required depending on the results of verification or review. An empty
+     * array unless an asynchronous verification is pending. If verification fails, the fields in
+     * this array become required and move to `currently_due` or `past_due`.
      */
     @SerializedName("pending_verification")
     List<String> pendingVerification;

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

@@ -1675,6 +1675,10 @@ public static class SepaDebit extends StripeObject {
       /** Last four characters of the IBAN. */
       @SerializedName("last4")
       String last4;
+
+      /** ID of the mandate used to make this payment. */
+      @SerializedName("mandate")
+      String mandate;
     }
 
     @Getter

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

@@ -324,9 +324,9 @@ public static class Requirements extends StripeObject {
     List<String> pastDue;
 
     /**
-     * Additional fields that may be required depending on the results of verification or review for
-     * provided requirements. If any of these fields become required, they appear in `currently_due`
-     * or `past_due`.
+     * Fields that may become required depending on the results of verification or review. An empty
+     * array unless an asynchronous verification is pending. If verification fails, the fields in
+     * this array become required and move to `currently_due` or `past_due`.
      */
     @SerializedName("pending_verification")
     List<String> pendingVerification;
@@ -351,8 +351,9 @@ public static class Verification extends StripeObject {
     String details;
 
     /**
-     * One of `scan_name_mismatch`, `failed_keyed_identity`, or `failed_other`. A machine-readable
-     * code specifying the verification state for the person.
+     * One of `document_address_mismatch`, `document_dob_mismatch`, `document_duplicate_type`,
+     * `document_id_number_mismatch`, `document_name_mismatch`, `failed_keyed_identity`, or
+     * `failed_other`. A machine-readable code specifying the verification state for the person.
      */
     @SerializedName("details_code")
     String detailsCode;
@@ -390,13 +391,13 @@ public static class VerificationDocument extends StripeObject {
     String details;
 
     /**
-     * One of `document_corrupt`, `document_failed_copy`, `document_not_readable`,
-     * `document_failed_greyscale`, `document_not_uploaded`, `document_id_type_not_supported`,
-     * `document_id_country_not_supported`, `document_failed_other`, `document_fraudulent`,
+     * One of `document_corrupt`, `document_country_not_supported`, `document_expired`,
+     * `document_failed_copy`, `document_failed_other`, `document_failed_test_mode`,
+     * `document_fraudulent`, `document_failed_greyscale`, `document_incomplete`,
      * `document_invalid`, `document_manipulated`, `document_missing_back`,
-     * `document_missing_front`, `document_photo_mismatch`, `document_too_large`, or
-     * `document_failed_test_mode`. A machine-readable code specifying the verification state for
-     * this document.
+     * `document_missing_front`, `document_not_readable`, `document_not_uploaded`,
+     * `document_photo_mismatch`, `document_too_large`, or `document_type_not_supported`. A
+     * machine-readable code specifying the verification state for this document.
      */
     @SerializedName("details_code")
     String detailsCode;

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

@@ -129,6 +129,10 @@ public static class GbpCreditTransferData extends StripeObject {
     @SerializedName("last4")
     String last4;
 
+    /** Sender entered arbitrary information about the transfer. */
+    @SerializedName("reference")
+    String reference;
+
     /** Sender name associated with the transfer. */
     @SerializedName("sender_name")
     String senderName;

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

@@ -47,8 +47,9 @@ public class Session extends ApiResource implements HasId {
   String clientReferenceId;
 
   /**
-   * The ID of the customer for this session. A new customer will be created unless an existing
-   * customer was provided in when the session was created.
+   * The ID of the customer for this session. For Checkout Sessions in `payment` or `subscription`
+   * mode, Checkout will create a new customer object based on information provided during the
+   * session unless an existing customer was provided when the session was created.
    */
   @SerializedName("customer")
   @Getter(lombok.AccessLevel.NONE)
@@ -95,7 +96,7 @@ public class Session extends ApiResource implements HasId {
   @SerializedName("object")
   String object;
 
-  /** The ID of the PaymentIntent for `payment` mode. */
+  /** The ID of the PaymentIntent for Checkout Sessions in `payment` mode. */
   @SerializedName("payment_intent")
   @Getter(lombok.AccessLevel.NONE)
   @Setter(lombok.AccessLevel.NONE)
@@ -107,7 +108,7 @@ public class Session extends ApiResource implements HasId {
   @SerializedName("payment_method_types")
   List<String> paymentMethodTypes;
 
-  /** The ID of the SetupIntent if mode was set to `setup`. */
+  /** The ID of the SetupIntent for Checkout Sessions in `setup` mode. */
   @SerializedName("setup_intent")
   @Getter(lombok.AccessLevel.NONE)
   @Setter(lombok.AccessLevel.NONE)
@@ -116,13 +117,13 @@ 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 using line items or a SKU, but not Checkout Sessions for subscriptions. Supported
-   * values are `auto`, `book`, `donate`, or `pay`.
+   * Sessions in `payment` mode, but not Checkout Sessions in `subscription` or `setup` mode.
+   * Supported values are `auto`, `book`, `donate`, or `pay`.
    */
   @SerializedName("submit_type")
   String submitType;
 
-  /** The ID of the subscription created if one or more plans were provided. */
+  /** The ID of the subscription for Checkout Sessions in `subscription` mode. */
   @SerializedName("subscription")
   @Getter(lombok.AccessLevel.NONE)
   @Setter(lombok.AccessLevel.NONE)

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

@@ -274,7 +274,7 @@ public Card update(CardUpdateParams params, RequestOptions options) throws Strip
   }
 
   /**
-   * For virtual cards only. Retrieves an Issuing <code>Card_details</code> object that contains <a
+   * For virtual cards only. Retrieves an Issuing <code>card_details</code> object that contains <a
    * href="/docs/issuing/cards/management#virtual-card-info">the sensitive details</a> of a virtual
    * card.
    */
@@ -283,7 +283,7 @@ public CardDetails details() throws StripeException {
   }
 
   /**
-   * For virtual cards only. Retrieves an Issuing <code>Card_details</code> object that contains <a
+   * For virtual cards only. Retrieves an Issuing <code>card_details</code> object that contains <a
    * href="/docs/issuing/cards/management#virtual-card-info">the sensitive details</a> of a virtual
    * card.
    */
@@ -292,7 +292,7 @@ public CardDetails details(Map<String, Object> params) throws StripeException {
   }
 
   /**
-   * For virtual cards only. Retrieves an Issuing <code>Card_details</code> object that contains <a
+   * For virtual cards only. Retrieves an Issuing <code>card_details</code> object that contains <a
    * href="/docs/issuing/cards/management#virtual-card-info">the sensitive details</a> of a virtual
    * card.
    */
@@ -308,7 +308,7 @@ public CardDetails details(Map<String, Object> params, RequestOptions options)
   }
 
   /**
-   * For virtual cards only. Retrieves an Issuing <code>Card_details</code> object that contains <a
+   * For virtual cards only. Retrieves an Issuing <code>card_details</code> object that contains <a
    * href="/docs/issuing/cards/management#virtual-card-info">the sensitive details</a> of a virtual
    * card.
    */
@@ -317,7 +317,7 @@ public CardDetails details(CardDetailsParams params) throws StripeException {
   }
 
   /**
-   * For virtual cards only. Retrieves an Issuing <code>Card_details</code> object that contains <a
+   * For virtual cards only. Retrieves an Issuing <code>card_details</code> object that contains <a
    * href="/docs/issuing/cards/management#virtual-card-info">the sensitive details</a> of a virtual
    * card.
    */

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

@@ -1443,7 +1443,8 @@ public Builder putAllExtraParam(Map<String, Object> map) {
       public static class Document {
         /**
          * The back of a document returned by a [file upload](#create_file) with a `purpose` value
-         * of `additional_verification`.
+         * of `additional_verification`. The uploaded file needs to be a color image (smaller than
+         * 8,000px by 8,000px), in JPG or PNG format, and less than 10 MB in size.
          */
         @SerializedName("back")
         String back;
@@ -1460,7 +1461,8 @@ public static class Document {
 
         /**
          * The front of a document returned by a [file upload](#create_file) with a `purpose` value
-         * of `additional_verification`.
+         * of `additional_verification`. The uploaded file needs to be a color image (smaller than
+         * 8,000px by 8,000px), in JPG or PNG format, and less than 10 MB in size.
          */
         @SerializedName("front")
         String front;
@@ -1489,7 +1491,8 @@ public Document build() {
 
           /**
            * The back of a document returned by a [file upload](#create_file) with a `purpose` value
-           * of `additional_verification`.
+           * of `additional_verification`. The uploaded file needs to be a color image (smaller than
+           * 8,000px by 8,000px), in JPG or PNG format, and less than 10 MB in size.
            */
           public Builder setBack(String back) {
             this.back = back;
@@ -1526,7 +1529,8 @@ public Builder putAllExtraParam(Map<String, Object> map) {
 
           /**
            * The front of a document returned by a [file upload](#create_file) with a `purpose`
-           * value of `additional_verification`.
+           * value of `additional_verification`. The uploaded file needs to be a color image
+           * (smaller than 8,000px by 8,000px), in JPG or PNG format, and less than 10 MB in size.
            */
           public Builder setFront(String front) {
             this.front = front;
@@ -2581,7 +2585,8 @@ public Builder putAllExtraParam(Map<String, Object> map) {
       public static class AdditionalDocument {
         /**
          * The back of an ID returned by a [file upload](#create_file) with a `purpose` value of
-         * `identity_document`.
+         * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by
+         * 8,000px), in JPG or PNG format, and less than 10 MB in size.
          */
         @SerializedName("back")
         String back;
@@ -2598,7 +2603,8 @@ public static class AdditionalDocument {
 
         /**
          * The front of an ID returned by a [file upload](#create_file) with a `purpose` value of
-         * `identity_document`.
+         * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by
+         * 8,000px), in JPG or PNG format, and less than 10 MB in size.
          */
         @SerializedName("front")
         String front;
@@ -2627,7 +2633,8 @@ public AdditionalDocument build() {
 
           /**
            * The back of an ID returned by a [file upload](#create_file) with a `purpose` value of
-           * `identity_document`.
+           * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px
+           * by 8,000px), in JPG or PNG format, and less than 10 MB in size.
            */
           public Builder setBack(String back) {
             this.back = back;
@@ -2666,7 +2673,8 @@ public Builder putAllExtraParam(Map<String, Object> map) {
 
           /**
            * The front of an ID returned by a [file upload](#create_file) with a `purpose` value of
-           * `identity_document`.
+           * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px
+           * by 8,000px), in JPG or PNG format, and less than 10 MB in size.
            */
           public Builder setFront(String front) {
             this.front = front;
@@ -2678,7 +2686,8 @@ public Builder setFront(String front) {
       public static class Document {
         /**
          * The back of an ID returned by a [file upload](#create_file) with a `purpose` value of
-         * `identity_document`.
+         * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by
+         * 8,000px), in JPG or PNG format, and less than 10 MB in size.
          */
         @SerializedName("back")
         String back;
@@ -2695,7 +2704,8 @@ public static class Document {
 
         /**
          * The front of an ID returned by a [file upload](#create_file) with a `purpose` value of
-         * `identity_document`.
+         * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by
+         * 8,000px), in JPG or PNG format, and less than 10 MB in size.
          */
         @SerializedName("front")
         String front;
@@ -2724,7 +2734,8 @@ public Document build() {
 
           /**
            * The back of an ID returned by a [file upload](#create_file) with a `purpose` value of
-           * `identity_document`.
+           * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px
+           * by 8,000px), in JPG or PNG format, and less than 10 MB in size.
            */
           public Builder setBack(String back) {
             this.back = back;
@@ -2761,7 +2772,8 @@ public Builder putAllExtraParam(Map<String, Object> map) {
 
           /**
            * The front of an ID returned by a [file upload](#create_file) with a `purpose` value of
-           * `identity_document`.
+           * `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px
+           * by 8,000px), in JPG or PNG format, and less than 10 MB in size.
            */
           public Builder setFront(String front) {
             this.front = front;