stripe 19.4.0.pre.alpha.3 → 19.4.0.pre.alpha.4

data/lib/stripe/params/subscription_schedule_create_params.rb

@@ -198,6 +198,138 @@ module Stripe
       end
     end
 
+    class PauseSchedule < ::Stripe::RequestParams
+      class Pause < ::Stripe::RequestParams
+        class PauseAt < ::Stripe::RequestParams
+          # The Unix timestamp at which to pause the subscription. Required when `type` is `timestamp`.
+          attr_accessor :timestamp
+          # When to pause the subscription. Use `now` to pause immediately or `timestamp` to pause at a specific time.
+          attr_accessor :type
+
+          def initialize(timestamp: nil, type: nil)
+            @timestamp = timestamp
+            @type = type
+          end
+        end
+
+        class Settings < ::Stripe::RequestParams
+          class BillFor < ::Stripe::RequestParams
+            class OutstandingUsageThrough < ::Stripe::RequestParams
+              # Determines whether to collect metered usage accrued up to the pause date.
+              attr_accessor :type
+
+              def initialize(type: nil)
+                @type = type
+              end
+            end
+
+            class UnusedTimeFrom < ::Stripe::RequestParams
+              # Determines which point in the billing period unused time is credited from.
+              attr_accessor :type
+
+              def initialize(type: nil)
+                @type = type
+              end
+            end
+            # Controls whether to collect metered usage accrued up to the pause date.
+            attr_accessor :outstanding_usage_through
+            # Controls how unused time on subscription items is credited when pausing.
+            attr_accessor :unused_time_from
+
+            def initialize(outstanding_usage_through: nil, unused_time_from: nil)
+              @outstanding_usage_through = outstanding_usage_through
+              @unused_time_from = unused_time_from
+            end
+          end
+          # Controls what to bill for when pausing the subscription.
+          attr_accessor :bill_for
+          # Determines whether to generate an invoice for outstanding amounts when pausing.
+          attr_accessor :invoicing_behavior
+          # The pause type. Currently only `subscription` is supported.
+          attr_accessor :type
+
+          def initialize(bill_for: nil, invoicing_behavior: nil, type: nil)
+            @bill_for = bill_for
+            @invoicing_behavior = invoicing_behavior
+            @type = type
+          end
+        end
+        # When to pause the subscription.
+        attr_accessor :pause_at
+        # Settings controlling billing behavior during the pause.
+        attr_accessor :settings
+
+        def initialize(pause_at: nil, settings: nil)
+          @pause_at = pause_at
+          @settings = settings
+        end
+      end
+
+      class Resume < ::Stripe::RequestParams
+        class ResumeAt < ::Stripe::RequestParams
+          class Duration < ::Stripe::RequestParams
+            # The time unit for the resume duration. One of `day`, `week`, `month`, or `year`.
+            attr_accessor :interval
+            # The number of intervals after which the subscription resumes.
+            attr_accessor :interval_count
+
+            def initialize(interval: nil, interval_count: nil)
+              @interval = interval
+              @interval_count = interval_count
+            end
+          end
+          # The duration after which to resume the subscription. Required when `type` is `duration`.
+          attr_accessor :duration
+          # The Unix timestamp at which to resume the subscription. Required when `type` is `timestamp`.
+          attr_accessor :timestamp
+          # When to resume the subscription. Use `now` to resume immediately, `duration` to resume after a set duration, or `timestamp` to resume at a specific time.
+          attr_accessor :type
+
+          def initialize(duration: nil, timestamp: nil, type: nil)
+            @duration = duration
+            @timestamp = timestamp
+            @type = type
+          end
+        end
+
+        class Settings < ::Stripe::RequestParams
+          # Controls the billing cycle anchor when the subscription resumes.
+          attr_accessor :billing_cycle_anchor
+          # Controls whether Stripe attempts payment on the resumption invoice and how payment affects the subscription's status. The default is `resume_on_payment_attempt`.
+          attr_accessor :payment_behavior
+          # Determines how to handle prorations when the subscription resumes. The default is `create_prorations`.
+          attr_accessor :proration_behavior
+
+          def initialize(billing_cycle_anchor: nil, payment_behavior: nil, proration_behavior: nil)
+            @billing_cycle_anchor = billing_cycle_anchor
+            @payment_behavior = payment_behavior
+            @proration_behavior = proration_behavior
+          end
+        end
+        # When to resume the subscription.
+        attr_accessor :resume_at
+        # Settings controlling how the subscription resumes.
+        attr_accessor :settings
+
+        def initialize(resume_at: nil, settings: nil)
+          @resume_at = resume_at
+          @settings = settings
+        end
+      end
+      # A unique identifier for this pause schedule entry.
+      attr_accessor :key
+      # Configuration for when and how the subscription pauses.
+      attr_accessor :pause
+      # Configuration for when and how the subscription resumes.
+      attr_accessor :resume
+
+      def initialize(key: nil, pause: nil, resume: nil)
+        @key = key
+        @pause = pause
+        @resume = resume
+      end
+    end
+
     class Phase < ::Stripe::RequestParams
       class AddInvoiceItem < ::Stripe::RequestParams
         class Discount < ::Stripe::RequestParams
@@ -927,6 +1059,8 @@ module Stripe
     attr_accessor :from_subscription
     # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
     attr_accessor :metadata
+    # Sets the pause schedules for the subscription schedule. Each entry configures when and how the subscription pauses and optionally when and how it resumes.
+    attr_accessor :pause_schedules
     # List representing phases of the subscription schedule. Each phase can be customized to have different durations, plans, and coupons. If there are multiple phases, the `end_date` of one phase will always equal the `start_date` of the next phase.
     attr_accessor :phases
     # If specified, the invoicing for the given billing cycle iterations will be processed now.
@@ -945,6 +1079,7 @@ module Stripe
       expand: nil,
       from_subscription: nil,
       metadata: nil,
+      pause_schedules: nil,
       phases: nil,
       prebilling: nil,
       start_date: nil
@@ -959,6 +1094,7 @@ module Stripe
       @expand = expand
       @from_subscription = from_subscription
       @metadata = metadata
+      @pause_schedules = pause_schedules
       @phases = phases
       @prebilling = prebilling
       @start_date = start_date

data/lib/stripe/params/subscription_schedule_update_params.rb

@@ -178,6 +178,138 @@ module Stripe
       end
     end
 
+    class PauseSchedule < ::Stripe::RequestParams
+      class Pause < ::Stripe::RequestParams
+        class PauseAt < ::Stripe::RequestParams
+          # The Unix timestamp at which to pause the subscription. Required when `type` is `timestamp`.
+          attr_accessor :timestamp
+          # When to pause the subscription. Use `now` to pause immediately or `timestamp` to pause at a specific time.
+          attr_accessor :type
+
+          def initialize(timestamp: nil, type: nil)
+            @timestamp = timestamp
+            @type = type
+          end
+        end
+
+        class Settings < ::Stripe::RequestParams
+          class BillFor < ::Stripe::RequestParams
+            class OutstandingUsageThrough < ::Stripe::RequestParams
+              # Determines whether to collect metered usage accrued up to the pause date.
+              attr_accessor :type
+
+              def initialize(type: nil)
+                @type = type
+              end
+            end
+
+            class UnusedTimeFrom < ::Stripe::RequestParams
+              # Determines which point in the billing period unused time is credited from.
+              attr_accessor :type
+
+              def initialize(type: nil)
+                @type = type
+              end
+            end
+            # Controls whether to collect metered usage accrued up to the pause date.
+            attr_accessor :outstanding_usage_through
+            # Controls how unused time on subscription items is credited when pausing.
+            attr_accessor :unused_time_from
+
+            def initialize(outstanding_usage_through: nil, unused_time_from: nil)
+              @outstanding_usage_through = outstanding_usage_through
+              @unused_time_from = unused_time_from
+            end
+          end
+          # Controls what to bill for when pausing the subscription.
+          attr_accessor :bill_for
+          # Determines whether to generate an invoice for outstanding amounts when pausing.
+          attr_accessor :invoicing_behavior
+          # The pause type. Currently only `subscription` is supported.
+          attr_accessor :type
+
+          def initialize(bill_for: nil, invoicing_behavior: nil, type: nil)
+            @bill_for = bill_for
+            @invoicing_behavior = invoicing_behavior
+            @type = type
+          end
+        end
+        # When to pause the subscription.
+        attr_accessor :pause_at
+        # Settings controlling billing behavior during the pause.
+        attr_accessor :settings
+
+        def initialize(pause_at: nil, settings: nil)
+          @pause_at = pause_at
+          @settings = settings
+        end
+      end
+
+      class Resume < ::Stripe::RequestParams
+        class ResumeAt < ::Stripe::RequestParams
+          class Duration < ::Stripe::RequestParams
+            # The time unit for the resume duration. One of `day`, `week`, `month`, or `year`.
+            attr_accessor :interval
+            # The number of intervals after which the subscription resumes.
+            attr_accessor :interval_count
+
+            def initialize(interval: nil, interval_count: nil)
+              @interval = interval
+              @interval_count = interval_count
+            end
+          end
+          # The duration after which to resume the subscription. Required when `type` is `duration`.
+          attr_accessor :duration
+          # The Unix timestamp at which to resume the subscription. Required when `type` is `timestamp`.
+          attr_accessor :timestamp
+          # When to resume the subscription. Use `now` to resume immediately, `duration` to resume after a set duration, or `timestamp` to resume at a specific time.
+          attr_accessor :type
+
+          def initialize(duration: nil, timestamp: nil, type: nil)
+            @duration = duration
+            @timestamp = timestamp
+            @type = type
+          end
+        end
+
+        class Settings < ::Stripe::RequestParams
+          # Controls the billing cycle anchor when the subscription resumes.
+          attr_accessor :billing_cycle_anchor
+          # Controls whether Stripe attempts payment on the resumption invoice and how payment affects the subscription's status. The default is `resume_on_payment_attempt`.
+          attr_accessor :payment_behavior
+          # Determines how to handle prorations when the subscription resumes. The default is `create_prorations`.
+          attr_accessor :proration_behavior
+
+          def initialize(billing_cycle_anchor: nil, payment_behavior: nil, proration_behavior: nil)
+            @billing_cycle_anchor = billing_cycle_anchor
+            @payment_behavior = payment_behavior
+            @proration_behavior = proration_behavior
+          end
+        end
+        # When to resume the subscription.
+        attr_accessor :resume_at
+        # Settings controlling how the subscription resumes.
+        attr_accessor :settings
+
+        def initialize(resume_at: nil, settings: nil)
+          @resume_at = resume_at
+          @settings = settings
+        end
+      end
+      # A unique identifier for this pause schedule entry.
+      attr_accessor :key
+      # Configuration for when and how the subscription pauses.
+      attr_accessor :pause
+      # Configuration for when and how the subscription resumes.
+      attr_accessor :resume
+
+      def initialize(key: nil, pause: nil, resume: nil)
+        @key = key
+        @pause = pause
+        @resume = resume
+      end
+    end
+
     class Phase < ::Stripe::RequestParams
       class AddInvoiceItem < ::Stripe::RequestParams
         class Discount < ::Stripe::RequestParams
@@ -799,7 +931,7 @@ module Stripe
       attr_accessor :trial
       # Specify trial behavior when crossing phase boundaries
       attr_accessor :trial_continuation
-      # Sets the phase to trialing from the start date to this date. Must be before the phase end date, can not be combined with `trial`
+      # Sets the phase to trialing from the start date to this date. Must be within the phase. When combined with `trial=true`, it must match the phase end date.
       attr_accessor :trial_end
       # Settings related to subscription trials.
       attr_accessor :trial_settings
@@ -903,6 +1035,8 @@ module Stripe
     attr_accessor :expand
     # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
     attr_accessor :metadata
+    # Sets the pause schedules for the subscription schedule. Include a `key` to update an existing entry or omit it to add a new one. Pass `""` to clear all entries or `[]` to leave them unchanged.
+    attr_accessor :pause_schedules
     # List representing phases of the subscription schedule. Each phase can be customized to have different durations, plans, and coupons. If there are multiple phases, the `end_date` of one phase will always equal the `start_date` of the next phase. Note that past phases can be omitted.
     attr_accessor :phases
     # If specified, the invoicing for the given billing cycle iterations will be processed now.
@@ -917,6 +1051,7 @@ module Stripe
       end_behavior: nil,
       expand: nil,
       metadata: nil,
+      pause_schedules: nil,
       phases: nil,
       prebilling: nil,
       proration_behavior: nil
@@ -927,6 +1062,7 @@ module Stripe
       @end_behavior = end_behavior
       @expand = expand
       @metadata = metadata
+      @pause_schedules = pause_schedules
       @phases = phases
       @prebilling = prebilling
       @proration_behavior = proration_behavior

data/lib/stripe/params/test_helpers/issuing/authorization_capture_params.rb

@@ -45,7 +45,7 @@ module Stripe
 
             class ReportedBreakdown < ::Stripe::RequestParams
               class Fuel < ::Stripe::RequestParams
-                # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
+                # Gross fuel amount that should equal Fuel Volume multiplied by Fuel Unit Cost, inclusive of taxes.
                 attr_accessor :gross_amount_decimal
 
                 def initialize(gross_amount_decimal: nil)

data/lib/stripe/params/test_helpers/issuing/authorization_create_params.rb

@@ -47,7 +47,7 @@ module Stripe
 
           class ReportedBreakdown < ::Stripe::RequestParams
             class Fuel < ::Stripe::RequestParams
-              # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
+              # Gross fuel amount that should equal Fuel Volume multiplied by Fuel Unit Cost, inclusive of taxes.
               attr_accessor :gross_amount_decimal
 
               def initialize(gross_amount_decimal: nil)

data/lib/stripe/params/test_helpers/issuing/authorization_finalize_amount_params.rb

@@ -35,7 +35,7 @@ module Stripe
 
           class ReportedBreakdown < ::Stripe::RequestParams
             class Fuel < ::Stripe::RequestParams
-              # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
+              # Gross fuel amount that should equal Fuel Volume multiplied by Fuel Unit Cost, inclusive of taxes.
               attr_accessor :gross_amount_decimal
 
               def initialize(gross_amount_decimal: nil)

data/lib/stripe/params/test_helpers/issuing/transaction_create_force_capture_params.rb

@@ -96,7 +96,7 @@ module Stripe
 
             class ReportedBreakdown < ::Stripe::RequestParams
               class Fuel < ::Stripe::RequestParams
-                # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
+                # Gross fuel amount that should equal Fuel Volume multiplied by Fuel Unit Cost, inclusive of taxes.
                 attr_accessor :gross_amount_decimal
 
                 def initialize(gross_amount_decimal: nil)

data/lib/stripe/params/test_helpers/issuing/transaction_create_unlinked_refund_params.rb

@@ -87,7 +87,7 @@ module Stripe
 
             class ReportedBreakdown < ::Stripe::RequestParams
               class Fuel < ::Stripe::RequestParams
-                # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
+                # Gross fuel amount that should equal Fuel Volume multiplied by Fuel Unit Cost, inclusive of taxes.
                 attr_accessor :gross_amount_decimal
 
                 def initialize(gross_amount_decimal: nil)

data/lib/stripe/params/token_create_params.rb

@@ -226,6 +226,8 @@ module Stripe
         # The category identifying the legal structure of the company or legal entity. See [Business structure](/connect/identity-verification#business-structure) for more details. Pass an empty string to unset this value.
         attr_accessor :structure
         # The business ID number of the company, as appropriate for the company’s country. (Examples are an Employer ID Number in the U.S., a Business Number in Canada, or a Company Number in the UK.)
+        #
+        # Changing this value requires that the account re-accept the [terms of service](/api/accounts/object#account_object-tos_acceptance).
         attr_accessor :tax_id
         # The jurisdiction in which the `tax_id` is registered (Germany-based companies only).
         attr_accessor :tax_id_registrar
@@ -1197,8 +1199,12 @@ module Stripe
       # The person's gender (International regulations require either "male" or "female").
       attr_accessor :gender
       # The person's ID number, as appropriate for their country. For example, a social security number in the U.S., social insurance number in Canada, etc. Instead of the number itself, you can also provide a [PII token provided by Stripe.js](https://docs.stripe.com/js/tokens/create_token?type=pii).
+      #
+      # Changing this value for the account's representative requires that the account re-accept the [terms of service](/api/accounts/object#account_object-tos_acceptance).
       attr_accessor :id_number
       # The person's secondary ID number, as appropriate for their country, will be used for enhanced verification checks. In Thailand, this would be the laser code found on the back of an ID card. Instead of the number itself, you can also provide a [PII token provided by Stripe.js](https://docs.stripe.com/js/tokens/create_token?type=pii).
+      #
+      # Changing this value for the account's representative requires that the account re-accept the [terms of service](/api/accounts/object#account_object-tos_acceptance).
       attr_accessor :id_number_secondary
       # The person's last name.
       attr_accessor :last_name
@@ -1225,6 +1231,8 @@ module Stripe
       # The credit applicant's self-reported monthly housing payment in minor units.
       attr_accessor :self_reported_monthly_housing_payment
       # The last four digits of the person's Social Security number (U.S. only).
+      #
+      # Changing this value for the account's representative requires that the account re-accept the [terms of service](/api/accounts/object#account_object-tos_acceptance).
       attr_accessor :ssn_last_4
       # Demographic data related to the person.
       attr_accessor :us_cfpb_data

data/lib/stripe/params.rb

@@ -126,10 +126,6 @@ module Stripe
   autoload :FileLinkUpdateParams, "stripe/params/file_link_update_params"
   autoload :FileListParams, "stripe/params/file_list_params"
   autoload :FileRetrieveParams, "stripe/params/file_retrieve_params"
-  autoload :FrMealVouchersOnboardingCreateParams, "stripe/params/fr_meal_vouchers_onboarding_create_params"
-  autoload :FrMealVouchersOnboardingListParams, "stripe/params/fr_meal_vouchers_onboarding_list_params"
-  autoload :FrMealVouchersOnboardingRetrieveParams, "stripe/params/fr_meal_vouchers_onboarding_retrieve_params"
-  autoload :FrMealVouchersOnboardingUpdateParams, "stripe/params/fr_meal_vouchers_onboarding_update_params"
   autoload :FxQuoteCreateParams, "stripe/params/fx_quote_create_params"
   autoload :FxQuoteListParams, "stripe/params/fx_quote_list_params"
   autoload :FxQuoteRetrieveParams, "stripe/params/fx_quote_retrieve_params"
@@ -244,6 +240,7 @@ module Stripe
   autoload :PaymentMethodListParams, "stripe/params/payment_method_list_params"
   autoload :PaymentMethodRetrieveParams, "stripe/params/payment_method_retrieve_params"
   autoload :PaymentMethodUpdateParams, "stripe/params/payment_method_update_params"
+  autoload :PaymentRecordCreateParams, "stripe/params/payment_record_create_params"
   autoload :PaymentRecordReportPaymentAttemptCanceledParams,
            "stripe/params/payment_record_report_payment_attempt_canceled_params"
   autoload :PaymentRecordReportPaymentAttemptFailedParams,
@@ -1534,10 +1531,6 @@ module Stripe
     stripe/params/forwarding/request_create_params
     stripe/params/forwarding/request_list_params
     stripe/params/forwarding/request_retrieve_params
-    stripe/params/fr_meal_vouchers_onboarding_create_params
-    stripe/params/fr_meal_vouchers_onboarding_list_params
-    stripe/params/fr_meal_vouchers_onboarding_retrieve_params
-    stripe/params/fr_meal_vouchers_onboarding_update_params
     stripe/params/fx_quote_create_params
     stripe/params/fx_quote_list_params
     stripe/params/fx_quote_retrieve_params
@@ -1728,6 +1721,7 @@ module Stripe
     stripe/params/payment_method_list_params
     stripe/params/payment_method_retrieve_params
     stripe/params/payment_method_update_params
+    stripe/params/payment_record_create_params
     stripe/params/payment_record_report_payment_attempt_canceled_params
     stripe/params/payment_record_report_payment_attempt_failed_params
     stripe/params/payment_record_report_payment_attempt_guaranteed_params

data/lib/stripe/resources/account_session.rb

@@ -296,6 +296,8 @@ module Stripe
           attr_reader :dispute_management
           # Whether sending refunds is enabled. This is `true` by default.
           attr_reader :refund_management
+          # Whether to allow connected accounts to submit disputes using Smart Disputes. Defaults to the value of `dispute_management`.
+          attr_reader :smart_disputes_management
 
           def self.inner_class_types
             @inner_class_types = {}
@@ -685,6 +687,8 @@ module Stripe
           attr_reader :dispute_management
           # Whether sending refunds is enabled. This is `true` by default.
           attr_reader :refund_management
+          # Whether to allow connected accounts to submit disputes using Smart Disputes. Defaults to the value of `dispute_management`.
+          attr_reader :smart_disputes_management
 
           def self.inner_class_types
             @inner_class_types = {}
@@ -716,6 +720,8 @@ module Stripe
           attr_reader :dispute_management
           # Whether sending refunds is enabled. This is `true` by default.
           attr_reader :refund_management
+          # Whether to allow connected accounts to submit disputes using Smart Disputes. Defaults to the value of `dispute_management`.
+          attr_reader :smart_disputes_management
 
           def self.inner_class_types
             @inner_class_types = {}
@@ -749,6 +755,8 @@ module Stripe
           attr_reader :dispute_management
           # Whether sending refunds is enabled. This is `true` by default.
           attr_reader :refund_management
+          # Whether to allow connected accounts to submit disputes using Smart Disputes. Defaults to the value of `dispute_management`.
+          attr_reader :smart_disputes_management
 
           def self.inner_class_types
             @inner_class_types = {}

data/lib/stripe/resources/balance_transaction.rb

@@ -46,7 +46,7 @@ module Stripe
     attr_reader :currency
     # An arbitrary string attached to the object. Often useful for displaying to users.
     attr_reader :description
-    # If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the `amount` in currency A, multipled by the `exchange_rate`, equals the `amount` in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent's `amount` is `1000` and `currency` is `eur`. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction's `amount` is `1234`, its `currency` is `usd`, and the `exchange_rate` is `1.234`.
+    # If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the `amount` in currency A, multiplied by the `exchange_rate`, equals the `amount` in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent's `amount` is `1000` and `currency` is `eur`. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction's `amount` is `1234`, its `currency` is `usd`, and the `exchange_rate` is `1.234`.
     attr_reader :exchange_rate
     # Fees (in cents (or local equivalent)) paid for this transaction. Represented as a positive integer when assessed.
     attr_reader :fee

data/lib/stripe/resources/billing_portal/configuration.rb

@@ -239,7 +239,7 @@ module Stripe
       attr_reader :business_profile
       # Time at which the object was created. Measured in seconds since the Unix epoch.
       attr_reader :created
-      # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
+      # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overridden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
       attr_reader :default_return_url
       # Attribute for field features
       attr_reader :features

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

@@ -226,7 +226,7 @@ module Stripe
         end
 
         class TaxId < ::Stripe::StripeObject
-          # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+          # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, `ic_nif`, or `unknown`
           attr_reader :type
           # The value of the tax ID.
           attr_reader :value
@@ -814,7 +814,7 @@ module Stripe
         end
 
         class TaxId < ::Stripe::StripeObject
-          # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+          # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, `ic_nif`, or `unknown`
           attr_reader :type
           # The value of the tax ID.
           attr_reader :value

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

@@ -79,6 +79,9 @@ module Stripe
       end
 
       class ManualEntry < ::Stripe::StripeObject
+        # Controls how manual entry of bank account details is presented to the user.
+        attr_reader :mode
+
         def self.inner_class_types
           @inner_class_types = {}
         end

data/lib/stripe/resources/invoice.rb

@@ -208,7 +208,7 @@ module Stripe
     end
 
     class CustomerTaxId < ::Stripe::StripeObject
-      # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+      # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, `ic_nif`, or `unknown`
       attr_reader :type
       # The value of the tax ID.
       attr_reader :value

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

@@ -146,6 +146,8 @@ module Stripe
         attr_reader :address
         # Address validation details for the shipment.
         attr_reader :address_validation
+        # The name of the business at the shipping address, used on the shipping label to ensure delivery when the card is shipped to a cardholder's workplace.
+        attr_reader :business_name
         # The delivery company that shipped a card.
         attr_reader :carrier
         # Additional information that may be required for clearing customs.

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

@@ -215,7 +215,7 @@ module Stripe
         attr_reader :retrieval_reference_number
         # The card network over which Stripe received the transaction. This field may differ from the associated card’s primary network.
         attr_reader :routed_network
-        # Attribute for field trace_id
+        # Mastercard identifier assigned by the card network for the transaction.
         attr_reader :trace_id
         # Unique identifier for the authorization assigned by the card network used to match subsequent messages, disputes, and transactions.
         attr_reader :transaction_id
@@ -254,7 +254,7 @@ module Stripe
 
           class ReportedBreakdown < ::Stripe::StripeObject
             class Fuel < ::Stripe::StripeObject
-              # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
+              # Gross fuel amount that should equal Fuel Volume multiplied by Fuel Unit Cost, inclusive of taxes.
               attr_reader :gross_amount_decimal
 
               def self.inner_class_types

data/lib/stripe/resources/order.rb

@@ -722,7 +722,7 @@ module Stripe
 
     class TaxDetails < ::Stripe::StripeObject
       class TaxId < ::Stripe::StripeObject
-        # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+        # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, `ic_nif`, or `unknown`
         attr_reader :type
         # The value of the tax ID.
         attr_reader :value

data/lib/stripe/resources/payment_method.rb

@@ -1908,7 +1908,7 @@ module Stripe
       request_stripe_object(method: :post, path: "/v1/payment_methods", params: params, opts: opts)
     end
 
-    # Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no longer be used for a payment or re-attached to a Customer.
+    # Detaches a PaymentMethod object from a Customer. Detachment is permanent and irreversible — once detached, a PaymentMethod can no longer be used for payments or re-attached to a Customer.
     def detach(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -1918,7 +1918,7 @@ module Stripe
       )
     end
 
-    # Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no longer be used for a payment or re-attached to a Customer.
+    # Detaches a PaymentMethod object from a Customer. Detachment is permanent and irreversible — once detached, a PaymentMethod can no longer be used for payments or re-attached to a Customer.
     def self.detach(payment_method, params = {}, opts = {})
       request_stripe_object(
         method: :post,