stripe 17.0.1 → 19.0.0

data/lib/stripe/resources/customer_session.rb

@@ -16,8 +16,8 @@ module Stripe
       "customer_session"
     end
 
-    class Components < Stripe::StripeObject
-      class BuyButton < Stripe::StripeObject
+    class Components < ::Stripe::StripeObject
+      class BuyButton < ::Stripe::StripeObject
         # Whether the buy button is enabled.
         attr_reader :enabled
 
@@ -30,8 +30,84 @@ module Stripe
         end
       end
 
-      class PaymentElement < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class CustomerSheet < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
+          # A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the customer sheet displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+          #
+          # If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+          attr_reader :payment_method_allow_redisplay_filters
+          # Controls whether the customer sheet displays the option to remove a saved payment method."
+          #
+          # Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+          attr_reader :payment_method_remove
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Whether the customer sheet is enabled.
+        attr_reader :enabled
+        # This hash defines whether the customer sheet supports certain features.
+        attr_reader :features
+
+        def self.inner_class_types
+          @inner_class_types = { features: Features }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class MobilePaymentElement < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
+          # A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the mobile payment element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+          #
+          # If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+          attr_reader :payment_method_allow_redisplay_filters
+          # Controls whether or not the mobile payment element shows saved payment methods.
+          attr_reader :payment_method_redisplay
+          # Controls whether the mobile payment element displays the option to remove a saved payment method."
+          #
+          # Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+          attr_reader :payment_method_remove
+          # Controls whether the mobile payment element displays a checkbox offering to save a new payment method.
+          #
+          # If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
+          attr_reader :payment_method_save
+          # Allows overriding the value of allow_override when saving a new payment method when payment_method_save is set to disabled. Use values: "always", "limited", or "unspecified".
+          #
+          # If not specified, defaults to `nil` (no override value).
+          attr_reader :payment_method_save_allow_redisplay_override
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Whether the mobile payment element is enabled.
+        attr_reader :enabled
+        # This hash defines whether the mobile payment element supports certain features.
+        attr_reader :features
+
+        def self.inner_class_types
+          @inner_class_types = { features: Features }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class PaymentElement < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the Payment Element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
           #
           # If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
@@ -75,7 +151,7 @@ module Stripe
         end
       end
 
-      class PricingTable < Stripe::StripeObject
+      class PricingTable < ::Stripe::StripeObject
         # Whether the pricing table is enabled.
         attr_reader :enabled
 
@@ -89,6 +165,10 @@ module Stripe
       end
       # This hash contains whether the buy button is enabled.
       attr_reader :buy_button
+      # This hash contains whether the customer sheet is enabled and the features it supports.
+      attr_reader :customer_sheet
+      # This hash contains whether the mobile payment element is enabled and the features it supports.
+      attr_reader :mobile_payment_element
       # This hash contains whether the Payment Element is enabled and the features it supports.
       attr_reader :payment_element
       # This hash contains whether the pricing table is enabled.
@@ -97,6 +177,8 @@ module Stripe
       def self.inner_class_types
         @inner_class_types = {
           buy_button: BuyButton,
+          customer_sheet: CustomerSheet,
+          mobile_payment_element: MobilePaymentElement,
           payment_element: PaymentElement,
           pricing_table: PricingTable,
         }
@@ -116,9 +198,11 @@ module Stripe
     attr_reader :created
     # The Customer the Customer Session was created for.
     attr_reader :customer
+    # The Account that the Customer Session was created for.
+    attr_reader :customer_account
     # The timestamp at which this Customer Session will expire.
     attr_reader :expires_at
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/discount.rb

@@ -2,17 +2,17 @@
 # frozen_string_literal: true
 
 module Stripe
-  # A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
+  # A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes).
   # It contains information about when the discount began, when it will end, and what it is applied to.
   #
-  # Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts)
+  # Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts)
   class Discount < StripeObject
     OBJECT_NAME = "discount"
     def self.object_name
       "discount"
     end
 
-    class Source < Stripe::StripeObject
+    class Source < ::Stripe::StripeObject
       # The coupon that was redeemed to create this discount.
       attr_reader :coupon
       # The source type of the discount.
@@ -30,6 +30,8 @@ module Stripe
     attr_reader :checkout_session
     # The ID of the customer associated with this discount.
     attr_reader :customer
+    # The ID of the account representing the customer associated with this discount.
+    attr_reader :customer_account
     # If the coupon has a duration of `repeating`, the date that this discount will end. If the coupon has a duration of `once` or `forever`, this attribute will be null.
     attr_reader :end
     # The ID of the discount object. Discounts cannot be fetched by ID. Use `expand[]=discounts` in API calls to expand discount IDs in an array.

data/lib/stripe/resources/dispute.rb

@@ -6,7 +6,7 @@ module Stripe
   # When this happens, you have the opportunity to respond to the dispute with
   # evidence that shows that the charge is legitimate.
   #
-  # Related guide: [Disputes and fraud](https://stripe.com/docs/disputes)
+  # Related guide: [Disputes and fraud](https://docs.stripe.com/disputes)
   class Dispute < APIResource
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
@@ -16,11 +16,11 @@ module Stripe
       "dispute"
     end
 
-    class Evidence < Stripe::StripeObject
-      class EnhancedEvidence < Stripe::StripeObject
-        class VisaCompellingEvidence3 < Stripe::StripeObject
-          class DisputedTransaction < Stripe::StripeObject
-            class ShippingAddress < Stripe::StripeObject
+    class Evidence < ::Stripe::StripeObject
+      class EnhancedEvidence < ::Stripe::StripeObject
+        class VisaCompellingEvidence3 < ::Stripe::StripeObject
+          class DisputedTransaction < ::Stripe::StripeObject
+            class ShippingAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -31,7 +31,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -68,8 +68,8 @@ module Stripe
             end
           end
 
-          class PriorUndisputedTransaction < Stripe::StripeObject
-            class ShippingAddress < Stripe::StripeObject
+          class PriorUndisputedTransaction < ::Stripe::StripeObject
+            class ShippingAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -80,7 +80,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -133,7 +133,7 @@ module Stripe
           end
         end
 
-        class VisaCompliance < Stripe::StripeObject
+        class VisaCompliance < ::Stripe::StripeObject
           # A field acknowledging the fee incurred when countering a Visa compliance dispute. If this field is set to true, evidence can be submitted for the compliance dispute. Stripe collects a 500 USD (or local equivalent) amount to cover the network costs associated with resolving compliance disputes. Stripe refunds the 500 USD network fee if you win the dispute.
           attr_reader :fee_acknowledged
 
@@ -227,9 +227,9 @@ module Stripe
       end
     end
 
-    class EvidenceDetails < Stripe::StripeObject
-      class EnhancedEligibility < Stripe::StripeObject
-        class VisaCompellingEvidence3 < Stripe::StripeObject
+    class EvidenceDetails < ::Stripe::StripeObject
+      class EnhancedEligibility < ::Stripe::StripeObject
+        class VisaCompellingEvidence3 < ::Stripe::StripeObject
           # List of actions required to qualify dispute for Visa Compelling Evidence 3.0 evidence submission.
           attr_reader :required_actions
           # Visa Compelling Evidence 3.0 eligibility status.
@@ -244,7 +244,7 @@ module Stripe
           end
         end
 
-        class VisaCompliance < Stripe::StripeObject
+        class VisaCompliance < ::Stripe::StripeObject
           # Visa compliance eligibility status.
           attr_reader :status
 
@@ -292,8 +292,8 @@ module Stripe
       end
     end
 
-    class PaymentMethodDetails < Stripe::StripeObject
-      class AmazonPay < Stripe::StripeObject
+    class PaymentMethodDetails < ::Stripe::StripeObject
+      class AmazonPay < ::Stripe::StripeObject
         # The AmazonPay dispute type, chargeback or claim
         attr_reader :dispute_type
 
@@ -306,7 +306,7 @@ module Stripe
         end
       end
 
-      class Card < Stripe::StripeObject
+      class Card < ::Stripe::StripeObject
         # Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
         attr_reader :brand
         # The type of dispute opened. Different case types may have varying fees and financial impact.
@@ -323,7 +323,7 @@ module Stripe
         end
       end
 
-      class Klarna < Stripe::StripeObject
+      class Klarna < ::Stripe::StripeObject
         # Chargeback loss reason mapped by Stripe from Klarna's chargeback loss reason
         attr_reader :chargeback_loss_reason_code
         # The reason for the dispute as defined by Klarna
@@ -338,7 +338,7 @@ module Stripe
         end
       end
 
-      class Paypal < Stripe::StripeObject
+      class Paypal < ::Stripe::StripeObject
         # The ID of the dispute in PayPal.
         attr_reader :case_id
         # The reason for the dispute as defined by PayPal
@@ -391,9 +391,9 @@ module Stripe
     attr_reader :id
     # If true, it's still possible to refund the disputed payment. After the payment has been fully refunded, no further funds are withdrawn from your Stripe account as a result of this dispute.
     attr_reader :is_charge_refundable
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     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.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # Network-dependent reason code for the dispute.
     attr_reader :network_reason_code
@@ -403,7 +403,7 @@ module Stripe
     attr_reader :payment_intent
     # Attribute for field payment_method_details
     attr_reader :payment_method_details
-    # Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://stripe.com/docs/disputes/categories).
+    # Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://docs.stripe.com/disputes/categories).
     attr_reader :reason
     # The current status of a dispute. Possible values include:`warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, `lost`, or `prevented`.
     attr_reader :status

data/lib/stripe/resources/entitlements/active_entitlement.rb

@@ -12,11 +12,11 @@ module Stripe
         "entitlements.active_entitlement"
       end
 
-      # The [Feature](https://stripe.com/docs/api/entitlements/feature) that the customer is entitled to.
+      # The [Feature](https://docs.stripe.com/api/entitlements/feature) that the customer is entitled to.
       attr_reader :feature
       # Unique identifier for the object.
       attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # A unique key you provide as your own system identifier. This may be up to 80 characters.
       attr_reader :lookup_key

data/lib/stripe/resources/entitlements/active_entitlement_summary.rb

@@ -14,7 +14,7 @@ module Stripe
       attr_reader :customer
       # The list of entitlements this customer has.
       attr_reader :entitlements
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object

data/lib/stripe/resources/entitlements/feature.rb

@@ -19,7 +19,7 @@ module Stripe
       attr_reader :active
       # Unique identifier for the object.
       attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # A unique key you provide as your own system identifier. This may be up to 80 characters.
       attr_reader :lookup_key

data/lib/stripe/resources/ephemeral_key.rb

@@ -17,7 +17,7 @@ module Stripe
     attr_reader :expires
     # Unique identifier for the object.
     attr_reader :id
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/event.rb

@@ -28,8 +28,8 @@ module Stripe
       "event"
     end
 
-    class Data < Stripe::StripeObject
-      # Object containing the API resource relevant to the event. For example, an `invoice.created` event will have a full [invoice object](https://stripe.com/docs/api#invoice_object) as the value of the object key.
+    class Data < ::Stripe::StripeObject
+      # Object containing the API resource relevant to the event. For example, an `invoice.created` event will have a full [invoice object](https://api.stripe.com#invoice_object) as the value of the object key.
       attr_reader :object
       # Object containing the names of the updated attributes and their values prior to the event (only included in events of type `*.updated`). If an array attribute has any updated elements, this object contains the entire array. In Stripe API versions 2017-04-06 or earlier, an updated array attribute in this object includes only the updated array elements.
       attr_reader :previous_attributes
@@ -43,7 +43,7 @@ module Stripe
       end
     end
 
-    class Request < Stripe::StripeObject
+    class Request < ::Stripe::StripeObject
       # ID of the API request that caused the event. If null, the event was automatic (e.g., Stripe's automatic subscription handling). Request logs are available in the [dashboard](https://dashboard.stripe.com/logs), but currently not in the API.
       attr_reader :id
       # The idempotency key transmitted during the request, if any. *Note: This property is populated only for events on or after May 23, 2017*.
@@ -69,7 +69,7 @@ module Stripe
     attr_reader :data
     # Unique identifier for the object.
     attr_reader :id
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/exchange_rate.rb

@@ -10,13 +10,13 @@ module Stripe
   # rate (for example, to dynamically price an item for a user with a default
   # payment in a foreign currency).
   #
-  # Please refer to our [Exchange Rates API](https://stripe.com/docs/fx-rates) guide for more details.
+  # Please refer to our [Exchange Rates API](https://docs.stripe.com/fx-rates) guide for more details.
   #
   # *[Note: this integration path is supported but no longer recommended]* Additionally,
   # you can guarantee that a charge is made with an exchange rate that you expect is
   # current. To do so, you must pass in the exchange_rate to charges endpoints. If the
   # value is no longer up to date, the charge won't go through. Please refer to our
-  # [Using with charges](https://stripe.com/docs/exchange-rates) guide for more details.
+  # [Using with charges](https://docs.stripe.com/exchange-rates) guide for more details.
   #
   # -----
   #

data/lib/stripe/resources/file.rb

@@ -3,12 +3,12 @@
 
 module Stripe
   # This object represents files hosted on Stripe's servers. You can upload
-  # files with the [create file](https://stripe.com/docs/api#create_file) request
+  # files with the [create file](https://api.stripe.com#create_file) request
   # (for example, when uploading dispute evidence). Stripe also
   # creates files independently (for example, the results of a [Sigma scheduled
   # query](https://docs.stripe.com/api#scheduled_queries)).
   #
-  # Related guide: [File upload guide](https://stripe.com/docs/file-upload)
+  # Related guide: [File upload guide](https://docs.stripe.com/file-upload)
   class File < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -26,11 +26,11 @@ module Stripe
     attr_reader :filename
     # Unique identifier for the object.
     attr_reader :id
-    # A list of [file links](https://stripe.com/docs/api#file_links) that point at this file.
+    # A list of [file links](https://api.stripe.com#file_links) that point at this file.
     attr_reader :links
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
-    # The [purpose](https://stripe.com/docs/file-upload#uploading-a-file) of the uploaded file.
+    # The [purpose](https://docs.stripe.com/file-upload#uploading-a-file) of the uploaded file.
     attr_reader :purpose
     # The size of the file object in bytes.
     attr_reader :size

data/lib/stripe/resources/file_link.rb

@@ -25,9 +25,9 @@ module Stripe
     attr_reader :file
     # Unique identifier for the object.
     attr_reader :id
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     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.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

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

@@ -12,11 +12,13 @@ module Stripe
         "financial_connections.account"
       end
 
-      class AccountHolder < Stripe::StripeObject
-        # The ID of the Stripe account this account belongs to. Should only be present if `account_holder.type` is `account`.
+      class AccountHolder < ::Stripe::StripeObject
+        # The ID of the Stripe account that this account belongs to. Only available when `account_holder.type` is `account`.
         attr_reader :account
-        # ID of the Stripe customer this account belongs to. Present if and only if `account_holder.type` is `customer`.
+        # The ID for an Account representing a customer that this account belongs to. Only available when `account_holder.type` is `customer`.
         attr_reader :customer
+        # Attribute for field customer_account
+        attr_reader :customer_account
         # Type of account holder that this account belongs to.
         attr_reader :type
 
@@ -29,8 +31,27 @@ module Stripe
         end
       end
 
-      class Balance < Stripe::StripeObject
-        class Cash < Stripe::StripeObject
+      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.
           #
           # Each key is a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
@@ -47,7 +68,7 @@ module Stripe
           end
         end
 
-        class Credit < Stripe::StripeObject
+        class Credit < ::Stripe::StripeObject
           # The credit that has been used by the account holder.
           #
           # Each key is a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
@@ -87,7 +108,7 @@ module Stripe
         end
       end
 
-      class BalanceRefresh < Stripe::StripeObject
+      class BalanceRefresh < ::Stripe::StripeObject
         # The time at which the last refresh attempt was initiated. Measured in seconds since the Unix epoch.
         attr_reader :last_attempted_at
         # Time at which the next balance refresh can be initiated. This value will be `null` when `status` is `pending`. Measured in seconds since the Unix epoch.
@@ -104,7 +125,7 @@ module Stripe
         end
       end
 
-      class OwnershipRefresh < Stripe::StripeObject
+      class OwnershipRefresh < ::Stripe::StripeObject
         # The time at which the last refresh attempt was initiated. Measured in seconds since the Unix epoch.
         attr_reader :last_attempted_at
         # Time at which the next ownership refresh can be initiated. This value will be `null` when `status` is `pending`. Measured in seconds since the Unix epoch.
@@ -121,7 +142,7 @@ module Stripe
         end
       end
 
-      class TransactionRefresh < Stripe::StripeObject
+      class TransactionRefresh < ::Stripe::StripeObject
         # Unique identifier for the object.
         attr_reader :id
         # The time at which the last refresh attempt was initiated. Measured in seconds since the Unix epoch.
@@ -141,6 +162,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.
@@ -157,7 +180,7 @@ module Stripe
       attr_reader :institution_name
       # The last 4 digits of the account number. If present, this will be 4 numeric characters.
       attr_reader :last4
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
@@ -186,7 +209,7 @@ module Stripe
       attr_reader :subcategory
       # The list of data refresh subscriptions requested on this account.
       attr_reader :subscriptions
-      # The [PaymentMethod type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account.
+      # The [PaymentMethod type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account.
       attr_reader :supported_payment_method_types
       # The state of the most recent attempt to refresh the account transactions.
       attr_reader :transaction_refresh
@@ -261,7 +284,7 @@ module Stripe
         )
       end
 
-      # Subscribes to periodic refreshes of data associated with a Financial Connections Account.
+      # Subscribes to periodic refreshes of data associated with a Financial Connections Account. When the account status is active, data is typically refreshed once a day.
       def subscribe(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -271,7 +294,7 @@ module Stripe
         )
       end
 
-      # Subscribes to periodic refreshes of data associated with a Financial Connections Account.
+      # Subscribes to periodic refreshes of data associated with a Financial Connections Account. When the account status is active, data is typically refreshed once a day.
       def self.subscribe(account, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -304,6 +327,7 @@ module Stripe
       def self.inner_class_types
         @inner_class_types = {
           account_holder: AccountHolder,
+          account_numbers: AccountNumber,
           balance: Balance,
           balance_refresh: BalanceRefresh,
           ownership_refresh: OwnershipRefresh,

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

@@ -12,11 +12,13 @@ module Stripe
         "financial_connections.session"
       end
 
-      class AccountHolder < Stripe::StripeObject
-        # The ID of the Stripe account this account belongs to. Should only be present if `account_holder.type` is `account`.
+      class AccountHolder < ::Stripe::StripeObject
+        # The ID of the Stripe account that this account belongs to. Only available when `account_holder.type` is `account`.
         attr_reader :account
-        # ID of the Stripe customer this account belongs to. Present if and only if `account_holder.type` is `customer`.
+        # The ID for an Account representing a customer that this account belongs to. Only available when `account_holder.type` is `customer`.
         attr_reader :customer
+        # Attribute for field customer_account
+        attr_reader :customer_account
         # Type of account holder that this account belongs to.
         attr_reader :type
 
@@ -29,7 +31,7 @@ module Stripe
         end
       end
 
-      class Filters < Stripe::StripeObject
+      class Filters < ::Stripe::StripeObject
         # Restricts the Session to subcategories of accounts that can be linked. Valid subcategories are: `checking`, `savings`, `mortgage`, `line_of_credit`, `credit_card`.
         attr_reader :account_subcategories
         # List of countries from which to filter accounts.
@@ -53,7 +55,7 @@ module Stripe
       attr_reader :filters
       # Unique identifier for the object.
       attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object

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

@@ -12,7 +12,7 @@ module Stripe
         "financial_connections.transaction"
       end
 
-      class StatusTransitions < Stripe::StripeObject
+      class StatusTransitions < ::Stripe::StripeObject
         # Time at which this transaction posted. Measured in seconds since the Unix epoch.
         attr_reader :posted_at
         # Time at which this transaction was voided. Measured in seconds since the Unix epoch.
@@ -36,7 +36,7 @@ module Stripe
       attr_reader :description
       # Unique identifier for the object.
       attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object