stripe 17.3.0.pre.alpha.2 → 18.1.0.pre.alpha.1

data/lib/stripe/resources/delegated_checkout/requested_session.rb

@@ -164,10 +164,10 @@ module Stripe
       end
 
       class OrderDetails < ::Stripe::StripeObject
-        # The URL to the order status.
-        attr_reader :order_status_url
         # The seller's order identifier.
         attr_reader :order_id
+        # The URL to the order status.
+        attr_reader :order_status_url
 
         def self.inner_class_types
           @inner_class_types = {}
@@ -178,51 +178,6 @@ module Stripe
         end
       end
 
-      class SellerDetails < ::Stripe::StripeObject
-        def self.inner_class_types
-          @inner_class_types = {}
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
-
-      class TotalDetails < ::Stripe::StripeObject
-        class ApplicableFee < ::Stripe::StripeObject
-          # The amount of the applicable fee.
-          attr_reader :amount
-          # The description of the applicable fee.
-          attr_reader :description
-          # The display name of the applicable fee.
-          attr_reader :display_name
-
-          def self.inner_class_types
-            @inner_class_types = {}
-          end
-
-          def self.field_remappings
-            @field_remappings = {}
-          end
-        end
-        # The amount discount of the total details.
-        attr_reader :amount_discount
-        # The amount fulfillment of the total details.
-        attr_reader :amount_fulfillment
-        # The amount tax of the total details.
-        attr_reader :amount_tax
-        # The applicable fees of the total details.
-        attr_reader :applicable_fees
-
-        def self.inner_class_types
-          @inner_class_types = { applicable_fees: ApplicableFee }
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
-
       class PaymentMethodPreview < ::Stripe::StripeObject
         class BillingDetails < ::Stripe::StripeObject
           class Address < ::Stripe::StripeObject
@@ -296,6 +251,51 @@ module Stripe
           @field_remappings = {}
         end
       end
+
+      class SellerDetails < ::Stripe::StripeObject
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class TotalDetails < ::Stripe::StripeObject
+        class ApplicableFee < ::Stripe::StripeObject
+          # The amount of the applicable fee.
+          attr_reader :amount
+          # The description of the applicable fee.
+          attr_reader :description
+          # The display name of the applicable fee.
+          attr_reader :display_name
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The amount discount of the total details.
+        attr_reader :amount_discount
+        # The amount fulfillment of the total details.
+        attr_reader :amount_fulfillment
+        # The amount tax of the total details.
+        attr_reader :amount_tax
+        # The applicable fees of the total details.
+        attr_reader :applicable_fees
+
+        def self.inner_class_types
+          @inner_class_types = { applicable_fees: ApplicableFee }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       # The subtotal amount of the requested session.
       attr_reader :amount_subtotal
       # The total amount of the requested session.
@@ -324,6 +324,8 @@ module Stripe
       attr_reader :order_details
       # The payment method used for the requested session.
       attr_reader :payment_method
+      # The preview of the payment method to be created when the requested session is confirmed.
+      attr_reader :payment_method_preview
       # Attribute for field seller_details
       attr_reader :seller_details
       # Whether or not the payment method should be saved for future use.
@@ -338,8 +340,6 @@ module Stripe
       attr_reader :total_details
       # Time at which the object was last updated. Measured in seconds since the Unix epoch.
       attr_reader :updated_at
-      # The preview of the payment method to be created when the requested session is confirmed.
-      attr_reader :payment_method_preview
 
       # Confirms a requested session
       def confirm(params = {}, opts = {})
@@ -406,9 +406,9 @@ module Stripe
           fulfillment_details: FulfillmentDetails,
           line_item_details: LineItemDetail,
           order_details: OrderDetails,
+          payment_method_preview: PaymentMethodPreview,
           seller_details: SellerDetails,
           total_details: TotalDetails,
-          payment_method_preview: PaymentMethodPreview,
         }
       end
 

data/lib/stripe/resources/financial_connections/account.rb

@@ -34,6 +34,25 @@ module Stripe
         end
       end
 
+      class AccountNumber < ::Stripe::StripeObject
+        # When the account number is expected to expire, if applicable.
+        attr_reader :expected_expiry_date
+        # The type of account number associated with the account.
+        attr_reader :identifier_type
+        # Whether the account number is currently active and usable for transactions.
+        attr_reader :status
+        # The payment networks that the account number can be used for.
+        attr_reader :supported_networks
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class Balance < ::Stripe::StripeObject
         class Cash < ::Stripe::StripeObject
           # The funds available to the account holder. Typically this is the current balance after subtracting any outbound pending transactions and adding any inbound pending transactions.
@@ -163,6 +182,8 @@ module Stripe
       end
       # The account holder that this account belongs to.
       attr_reader :account_holder
+      # Details about the account numbers.
+      attr_reader :account_numbers
       # The most recent information about the account's balance.
       attr_reader :balance
       # The state of the most recent attempt to refresh the account balance.
@@ -330,6 +351,7 @@ module Stripe
       def self.inner_class_types
         @inner_class_types = {
           account_holder: AccountHolder,
+          account_numbers: AccountNumber,
           balance: Balance,
           balance_refresh: BalanceRefresh,
           inferred_balances_refresh: InferredBalancesRefresh,

data/lib/stripe/resources/invoice.rb

@@ -997,7 +997,7 @@ module Stripe
     # * `subscription_cycle`: A subscription advanced into a new period.
     # * `subscription_threshold`: A subscription reached a billing threshold.
     # * `subscription_update`: A subscription was updated.
-    # * `upcoming`: Reserved for simulated invoices, per the upcoming invoice endpoint.
+    # * `upcoming`: Reserved for upcoming invoices created through the Create Preview Invoice API or when an `invoice.upcoming` event is generated for an upcoming invoice on a subscription.
     attr_reader :billing_reason
     # Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions.
     attr_reader :collection_method

data/lib/stripe/resources/issuing/card.rb

@@ -14,6 +14,21 @@ module Stripe
         "issuing.card"
       end
 
+      class LatestFraudWarning < ::Stripe::StripeObject
+        # Timestamp of the most recent fraud warning.
+        attr_reader :started_at
+        # The type of fraud warning that most recently took place on this card. This field updates with every new fraud warning, so the value changes over time. If populated, cancel and reissue the card.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class Shipping < ::Stripe::StripeObject
         class Address < ::Stripe::StripeObject
           # City, district, suburb, town, or village.
@@ -237,6 +252,8 @@ module Stripe
       attr_reader :id
       # The last 4 digits of the card number.
       attr_reader :last4
+      # Stripe’s assessment of whether this card’s details have been compromised. If this property isn't null, cancel and reissue the card to prevent fraudulent activity risk.
+      attr_reader :latest_fraud_warning
       # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
       attr_reader :livemode
       # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
@@ -399,6 +416,7 @@ module Stripe
 
       def self.inner_class_types
         @inner_class_types = {
+          latest_fraud_warning: LatestFraudWarning,
           shipping: Shipping,
           spending_controls: SpendingControls,
           wallets: Wallets,

data/lib/stripe/resources/mandate.rb

@@ -234,15 +234,15 @@ module Stripe
       class Payto < ::Stripe::StripeObject
         # Amount that will be collected. It is required when `amount_type` is `fixed`.
         attr_reader :amount
-        # The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.
+        # The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.
         attr_reader :amount_type
         # Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
         attr_reader :end_date
-        # The periodicity at which payments will be collected.
+        # The periodicity at which payments will be collected. Defaults to `adhoc`.
         attr_reader :payment_schedule
         # The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
         attr_reader :payments_per_period
-        # The purpose for which payments are made. Defaults to retail.
+        # The purpose for which payments are made. Has a default value based on your merchant category code.
         attr_reader :purpose
         # Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
         attr_reader :start_date

data/lib/stripe/resources/payment_attempt_record.rb

@@ -897,7 +897,7 @@ module Stripe
       end
 
       class Ideal < ::Stripe::StripeObject
-        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
         attr_reader :bank
         # The Bank Identifier Code of the customer's bank.
         attr_reader :bic
@@ -907,6 +907,8 @@ module Stripe
         attr_reader :generated_sepa_debit_mandate
         # Last four characters of the IBAN.
         attr_reader :iban_last4
+        # Unique transaction ID generated by iDEAL.
+        attr_reader :transaction_id
         # Owner's verified full name. Values are verified or provided by iDEAL directly
         # (if supported) at the time of authorization or settlement. They cannot be set or mutated.
         attr_reader :verified_name
@@ -1681,9 +1683,9 @@ module Stripe
       end
 
       class UsBankAccount < ::Stripe::StripeObject
-        # Attribute for field account_holder_type
+        # The type of entity that holds the account. This can be either 'individual' or 'company'.
         attr_reader :account_holder_type
-        # Attribute for field account_type
+        # The type of the bank account. This can be either 'checking' or 'savings'.
         attr_reader :account_type
         # Name of the bank associated with the bank account.
         attr_reader :bank_name
@@ -1693,9 +1695,9 @@ module Stripe
         attr_reader :last4
         # ID of the mandate used to make this payment.
         attr_reader :mandate
-        # Reference number to locate ACH payments with customer’s bank.
+        # The ACH payment reference for this transaction.
         attr_reader :payment_reference
-        # Routing number of the bank account.
+        # The routing number for the bank account.
         attr_reader :routing_number
 
         def self.inner_class_types
@@ -1877,7 +1879,7 @@ module Stripe
       # An additional hash is included on `payment_method_details` with a name matching this value.
       # It contains information specific to the payment method.
       attr_reader :type
-      # Details of the US Bank Account used for this payment attempt.
+      # Attribute for field us_bank_account
       attr_reader :us_bank_account
       # Attribute for field wechat
       attr_reader :wechat

data/lib/stripe/resources/payment_intent.rb

@@ -27,13 +27,26 @@ module Stripe
 
     nested_resource_class_methods :amount_details_line_item, operations: %i[list]
 
+    class AllocatedFunds < ::Stripe::StripeObject
+      # Allocated Funds configuration for this PaymentIntent.
+      attr_reader :enabled
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
     class AmountDetails < ::Stripe::StripeObject
       class Shipping < ::Stripe::StripeObject
-        # Portion of the amount that is for shipping.
+        # If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0.
         attr_reader :amount
-        # The postal code that represents the shipping source.
+        # If a physical good is being shipped, the postal code of where it is being shipped from. At most 10 alphanumeric characters long, hyphens are allowed.
         attr_reader :from_postal_code
-        # The postal code that represents the shipping destination.
+        # If a physical good is being shipped, the postal code of where it is being shipped to. At most 10 alphanumeric characters long, hyphens are allowed.
         attr_reader :to_postal_code
 
         def self.inner_class_types
@@ -46,7 +59,9 @@ module Stripe
       end
 
       class Tax < ::Stripe::StripeObject
-        # Total portion of the amount that is for tax.
+        # The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0.
+        #
+        # This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field.
         attr_reader :total_tax_amount
 
         def self.inner_class_types
@@ -70,7 +85,9 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # The total discount applied on the transaction.
+      # The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0.
+      #
+      # This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field.
       attr_reader :discount_amount
       # A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items.
       attr_reader :line_items
@@ -1541,11 +1558,17 @@ module Stripe
       attr_reader :benefit
       # Attribute for field car_rental
       attr_reader :car_rental
-      # Some customers might be required by their company or organization to provide this information. If so, provide this value. Otherwise you can ignore this field.
+      # A unique value to identify the customer. This field is available only for card payments.
+      #
+      # This field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks.
       attr_reader :customer_reference
       # Attribute for field event_details
       attr_reader :event_details
-      # A unique value assigned by the business to identify the transaction.
+      # A unique value assigned by the business to identify the transaction. Required for L2 and L3 rates.
+      #
+      # Required when the Payment Method Types array contains `card`, including when [automatic_payment_methods.enabled](/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled) is set to `true`.
+      #
+      # For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks. For Klarna, this field is truncated to 255 characters and is visible to customers when they view the order in the Klarna app.
       attr_reader :order_reference
       # Attribute for field subscription
       attr_reader :subscription
@@ -2038,6 +2061,8 @@ module Stripe
             @field_remappings = {}
           end
         end
+        # Controls when the funds will be captured from the customer's account.
+        attr_reader :capture_method
         # Request ability to capture this payment beyond the standard [authorization validity window](https://stripe.com/docs/terminal/features/extended-authorizations#authorization-validity)
         attr_reader :request_extended_authorization
         # Request ability to [increment](https://stripe.com/docs/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://stripe.com/docs/api/payment_intents/confirm) response to verify support.
@@ -2677,15 +2702,15 @@ module Stripe
         class MandateOptions < ::Stripe::StripeObject
           # Amount that will be collected. It is required when `amount_type` is `fixed`.
           attr_reader :amount
-          # The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.
+          # The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.
           attr_reader :amount_type
           # Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
           attr_reader :end_date
-          # The periodicity at which payments will be collected.
+          # The periodicity at which payments will be collected. Defaults to `adhoc`.
           attr_reader :payment_schedule
           # The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
           attr_reader :payments_per_period
-          # The purpose for which payments are made. Defaults to retail.
+          # The purpose for which payments are made. Has a default value based on your merchant category code.
           attr_reader :purpose
 
           def self.inner_class_types
@@ -3434,19 +3459,8 @@ module Stripe
         @field_remappings = {}
       end
     end
-
-    class AllocatedFunds < ::Stripe::StripeObject
-      # Allocated Funds configuration for this PaymentIntent.
-      attr_reader :enabled
-
-      def self.inner_class_types
-        @inner_class_types = {}
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
+    # Allocated Funds configuration for this PaymentIntent.
+    attr_reader :allocated_funds
     # Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
     attr_reader :amount
     # Amount that can be captured from this PaymentIntent.
@@ -3559,8 +3573,6 @@ module Stripe
     attr_reader :transfer_data
     # A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers).
     attr_reader :transfer_group
-    # Allocated Funds configuration for this PaymentIntent.
-    attr_reader :allocated_funds
 
     # Manually reconcile the remaining amount for a customer_balance PaymentIntent.
     def apply_customer_balance(params = {}, opts = {})
@@ -3922,6 +3934,7 @@ module Stripe
 
     def self.inner_class_types
       @inner_class_types = {
+        allocated_funds: AllocatedFunds,
         amount_details: AmountDetails,
         automatic_payment_methods: AutomaticPaymentMethods,
         hooks: Hooks,
@@ -3934,7 +3947,6 @@ module Stripe
         processing: Processing,
         shipping: Shipping,
         transfer_data: TransferData,
-        allocated_funds: AllocatedFunds,
       }
     end
 

data/lib/stripe/resources/payment_intent_amount_details_line_item.rb

@@ -89,7 +89,9 @@ module Stripe
     end
 
     class Tax < ::Stripe::StripeObject
-      # Total portion of the amount that is for tax.
+      # The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0.
+      #
+      # This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field.
       attr_reader :total_tax_amount
 
       def self.inner_class_types
@@ -100,7 +102,9 @@ module Stripe
         @field_remappings = {}
       end
     end
-    # The amount an item was discounted for. Positive integer.
+    # The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0.
+    #
+    # This field is mutually exclusive with the `amount_details[discount_amount]` field.
     attr_reader :discount_amount
     # Unique identifier for the object.
     attr_reader :id
@@ -108,17 +112,19 @@ module Stripe
     attr_reader :object
     # Payment method-specific information for line items.
     attr_reader :payment_method_options
-    # Unique identifier of the product. At most 12 characters long.
+    # The product code of the line item, such as an SKU. Required for L3 rates. At most 12 characters long.
     attr_reader :product_code
-    # Name of the product. At most 100 characters long.
+    # The product name of the line item. Required for L3 rates. At most 1024 characters long.
+    #
+    # For Cards, this field is truncated to 26 alphanumeric characters before being sent to the card networks. For Paypal, this field is truncated to 127 characters.
     attr_reader :product_name
-    # Number of items of the product. Positive integer.
+    # The quantity of items. Required for L3 rates. An integer greater than 0.
     attr_reader :quantity
     # Contains information about the tax on the item.
     attr_reader :tax
-    # Cost of the product. Non-negative integer.
+    # The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0.
     attr_reader :unit_cost
-    # A unit of measure for the line item, such as gallons, feet, meters, etc.
+    # A unit of measure for the line item, such as gallons, feet, meters, etc. Required for L3 rates. At most 12 alphanumeric characters long.
     attr_reader :unit_of_measure
 
     def self.inner_class_types

data/lib/stripe/resources/payment_method.rb

@@ -927,7 +927,7 @@ module Stripe
     end
 
     class Ideal < ::Stripe::StripeObject
-      # The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+      # The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
       attr_reader :bank
       # The Bank Identifier Code of the customer's bank, if the bank was provided.
       attr_reader :bic

data/lib/stripe/resources/payment_record.rb

@@ -895,7 +895,7 @@ module Stripe
       end
 
       class Ideal < ::Stripe::StripeObject
-        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
         attr_reader :bank
         # The Bank Identifier Code of the customer's bank.
         attr_reader :bic
@@ -905,6 +905,8 @@ module Stripe
         attr_reader :generated_sepa_debit_mandate
         # Last four characters of the IBAN.
         attr_reader :iban_last4
+        # Unique transaction ID generated by iDEAL.
+        attr_reader :transaction_id
         # Owner's verified full name. Values are verified or provided by iDEAL directly
         # (if supported) at the time of authorization or settlement. They cannot be set or mutated.
         attr_reader :verified_name
@@ -1679,9 +1681,9 @@ module Stripe
       end
 
       class UsBankAccount < ::Stripe::StripeObject
-        # Attribute for field account_holder_type
+        # The type of entity that holds the account. This can be either 'individual' or 'company'.
         attr_reader :account_holder_type
-        # Attribute for field account_type
+        # The type of the bank account. This can be either 'checking' or 'savings'.
         attr_reader :account_type
         # Name of the bank associated with the bank account.
         attr_reader :bank_name
@@ -1691,9 +1693,9 @@ module Stripe
         attr_reader :last4
         # ID of the mandate used to make this payment.
         attr_reader :mandate
-        # Reference number to locate ACH payments with customer’s bank.
+        # The ACH payment reference for this transaction.
         attr_reader :payment_reference
-        # Routing number of the bank account.
+        # The routing number for the bank account.
         attr_reader :routing_number
 
         def self.inner_class_types
@@ -1875,7 +1877,7 @@ module Stripe
       # An additional hash is included on `payment_method_details` with a name matching this value.
       # It contains information specific to the payment method.
       attr_reader :type
-      # Details of the US Bank Account used for this payment attempt.
+      # Attribute for field us_bank_account
       attr_reader :us_bank_account
       # Attribute for field wechat
       attr_reader :wechat

data/lib/stripe/resources/person.rb

@@ -292,6 +292,36 @@ module Stripe
       end
     end
 
+    class SelfReportedIncome < ::Stripe::StripeObject
+      # Amount in the minor currency unit (e.g., cents for USD)
+      attr_reader :amount
+      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+      attr_reader :currency
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
+    class SelfReportedMonthlyHousingPayment < ::Stripe::StripeObject
+      # Amount in the minor currency unit (e.g., cents for USD)
+      attr_reader :amount
+      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+      attr_reader :currency
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
     class UsCfpbData < ::Stripe::StripeObject
       class EthnicityDetails < ::Stripe::StripeObject
         # The persons ethnicity
@@ -395,36 +425,6 @@ module Stripe
         @field_remappings = {}
       end
     end
-
-    class SelfReportedIncome < ::Stripe::StripeObject
-      # Amount in the minor currency unit (e.g., cents for USD)
-      attr_reader :amount
-      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
-      attr_reader :currency
-
-      def self.inner_class_types
-        @inner_class_types = {}
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
-
-    class SelfReportedMonthlyHousingPayment < ::Stripe::StripeObject
-      # Amount in the minor currency unit (e.g., cents for USD)
-      attr_reader :amount
-      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
-      attr_reader :currency
-
-      def self.inner_class_types
-        @inner_class_types = {}
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
     # The account the person is associated with.
     attr_reader :account
     # Attribute for field additional_tos_acceptances
@@ -483,16 +483,16 @@ module Stripe
     attr_reader :relationship
     # Information about the requirements for this person, including what information needs to be collected, and by when.
     attr_reader :requirements
+    # Attribute for field self_reported_income
+    attr_reader :self_reported_income
+    # Attribute for field self_reported_monthly_housing_payment
+    attr_reader :self_reported_monthly_housing_payment
     # Whether the last four digits of the person's Social Security number have been provided (U.S. only).
     attr_reader :ssn_last_4_provided
     # Demographic data related to the person.
     attr_reader :us_cfpb_data
     # Attribute for field verification
     attr_reader :verification
-    # Attribute for field self_reported_income
-    attr_reader :self_reported_income
-    # Attribute for field self_reported_monthly_housing_payment
-    attr_reader :self_reported_monthly_housing_payment
     # Always true for a deleted object
     attr_reader :deleted
 
@@ -528,10 +528,10 @@ module Stripe
         registered_address: RegisteredAddress,
         relationship: Relationship,
         requirements: Requirements,
-        us_cfpb_data: UsCfpbData,
-        verification: Verification,
         self_reported_income: SelfReportedIncome,
         self_reported_monthly_housing_payment: SelfReportedMonthlyHousingPayment,
+        us_cfpb_data: UsCfpbData,
+        verification: Verification,
       }
     end