stripe 15.0.0 → 15.3.0

data/rbi/stripe/resources/credit_note.rbi

@@ -152,6 +152,12 @@ module Stripe
     # The link to download the PDF of the credit note.
     sig { returns(String) }
     attr_reader :pdf
+    # The amount of the credit note that was refunded to the customer, credited to the customer's balance, credited outside of Stripe, or any combination thereof.
+    sig { returns(Integer) }
+    attr_reader :post_payment_amount
+    # The amount of the credit note by which the invoice's `amount_remaining` and `amount_due` were reduced.
+    sig { returns(Integer) }
+    attr_reader :pre_payment_amount
     # The pretax credit amounts (ex: discount, credit grants, etc) for all line items.
     sig { returns(T::Array[PretaxCreditAmount]) }
     attr_reader :pretax_credit_amounts
@@ -317,7 +323,7 @@ module Stripe
         sig { params(shipping_rate: T.nilable(String)).void }
         def initialize(shipping_rate: nil); end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
@@ -335,7 +341,7 @@ module Stripe
       # ID of the invoice.
       sig { returns(String) }
       attr_accessor :invoice
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(T::Array[::Stripe::CreditNote::CreateParams::Line])) }
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
@@ -356,7 +362,7 @@ module Stripe
       # Refunds to link to this credit note.
       sig { returns(T.nilable(T::Array[::Stripe::CreditNote::CreateParams::Refund])) }
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(::Stripe::CreditNote::CreateParams::ShippingCost)) }
       attr_accessor :shipping_cost
       sig {
@@ -470,7 +476,7 @@ module Stripe
         sig { params(shipping_rate: T.nilable(String)).void }
         def initialize(shipping_rate: nil); end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
@@ -488,7 +494,7 @@ module Stripe
       # ID of the invoice.
       sig { returns(String) }
       attr_accessor :invoice
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(T::Array[::Stripe::CreditNote::PreviewParams::Line])) }
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
@@ -509,7 +515,7 @@ module Stripe
       # Refunds to link to this credit note.
       sig { returns(T.nilable(T::Array[::Stripe::CreditNote::PreviewParams::Refund])) }
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(::Stripe::CreditNote::PreviewParams::ShippingCost)) }
       attr_accessor :shipping_cost
       sig {
@@ -608,7 +614,7 @@ module Stripe
         sig { params(shipping_rate: T.nilable(String)).void }
         def initialize(shipping_rate: nil); end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
@@ -632,7 +638,7 @@ module Stripe
       # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :limit
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(T::Array[::Stripe::CreditNote::ListPreviewLineItemsParams::Line])) }
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
@@ -653,7 +659,7 @@ module Stripe
       # Refunds to link to this credit note.
       sig { returns(T.nilable(T::Array[::Stripe::CreditNote::ListPreviewLineItemsParams::Refund])) }
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       sig { returns(T.nilable(::Stripe::CreditNote::ListPreviewLineItemsParams::ShippingCost)) }
       attr_accessor :shipping_cost
       # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
@@ -689,20 +695,19 @@ module Stripe
       sig { params(expand: T.nilable(T::Array[String])).void }
       def initialize(expand: nil); end
     end
-    # Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces
-    # its amount_due. For a status=paid invoice, a credit note does not affect its amount_due. Instead, it can result
-    # in any combination of the following:
+    # Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice's amount_remaining (and amount_due), but not below zero.
+    # This amount is indicated by the credit note's pre_payment_amount. The excess amount is indicated by post_payment_amount, and it can result in any combination of the following:
     #
     #
-    # Refund: create a new refund (using refund_amount) or link an existing refund (using refund).
+    # Refunds: create a new refund (using refund_amount) or link existing refunds (using refunds).
     # Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized.
     # Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount).
     #
     #
-    # For post-payment credit notes the sum of the refund, credit and outside of Stripe amounts must equal the credit note total.
+    # The sum of refunds, customer balance credits, and outside of Stripe credits must equal the post_payment_amount.
     #
-    # You may issue multiple credit notes for an invoice. Each credit note will increment the invoice's pre_payment_credit_notes_amount
-    # or post_payment_credit_notes_amount depending on its status at the time of credit note creation.
+    # You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
+    # post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.
     sig {
       params(params: T.any(::Stripe::CreditNote::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::CreditNote)
      }
@@ -732,13 +737,13 @@ module Stripe
      }
     def self.update(id, params = {}, opts = {}); end
 
-    # Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+    # Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
     sig {
       params(params: T.any(::Stripe::CreditNote::VoidCreditNoteParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::CreditNote)
      }
     def void_credit_note(params = {}, opts = {}); end
 
-    # Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+    # Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
     sig {
       params(id: String, params: T.any(::Stripe::CreditNote::VoidCreditNoteParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::CreditNote)
      }

data/rbi/stripe/resources/customer.rbi

@@ -210,9 +210,7 @@ module Stripe
     # Always true for a deleted object
     sig { returns(T::Boolean) }
     attr_reader :deleted
-    class DeleteParams < Stripe::RequestParams
-
-    end
+    class DeleteParams < Stripe::RequestParams; end
     class UpdateParams < Stripe::RequestParams
       class Address < Stripe::RequestParams
         # City, district, suburb, town, or village.
@@ -459,9 +457,7 @@ module Stripe
         validate: nil
       ); end
     end
-    class DeleteDiscountParams < Stripe::RequestParams
-
-    end
+    class DeleteDiscountParams < Stripe::RequestParams; end
     class ListParams < Stripe::RequestParams
       class Created < Stripe::RequestParams
         # Minimum value to filter by (exclusive)
@@ -672,7 +668,7 @@ module Stripe
         def initialize(ip_address: nil, validate_location: nil); end
       end
       class TaxIdDatum < Stripe::RequestParams
-        # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `ba_tin`, `bb_tin`, `bg_uic`, `bh_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cn_tin`, `co_nit`, `cr_tin`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kh_tin`, `kr_brn`, `kz_bin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
+        # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `aw_tin`, `az_tin`, `ba_tin`, `bb_tin`, `bd_bin`, `bf_ifu`, `bg_uic`, `bh_vat`, `bj_ifu`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cm_niu`, `cn_tin`, `co_nit`, `cr_tin`, `cv_nif`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `et_tin`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kg_tin`, `kh_tin`, `kr_brn`, `kz_bin`, `la_tin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
         sig { returns(String) }
         attr_accessor :type
         # Value of the tax ID.
@@ -776,7 +772,7 @@ module Stripe
       ); end
     end
     class ListPaymentMethodsParams < Stripe::RequestParams
-      # This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to `unspecified`.
+      # This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow.
       sig { returns(T.nilable(String)) }
       attr_accessor :allow_redisplay
       # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.

data/rbi/stripe/resources/customer_session.rbi

@@ -6,9 +6,9 @@ module Stripe
   # A Customer Session allows you to grant Stripe's frontend SDKs (like Stripe.js) client-side access
   # control over a Customer.
   #
-  # Related guides: [Customer Session with the Payment Element](https://stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
-  # [Customer Session with the Pricing Table](https://stripe.com/payments/checkout/pricing-table#customer-session),
-  # [Customer Session with the Buy Button](https://stripe.com/payment-links/buy-button#pass-an-existing-customer).
+  # Related guides: [Customer Session with the Payment Element](https://docs.stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
+  # [Customer Session with the Pricing Table](https://docs.stripe.com/payments/checkout/pricing-table#customer-session),
+  # [Customer Session with the Buy Button](https://docs.stripe.com/payment-links/buy-button#pass-an-existing-customer).
   class CustomerSession < APIResource
     class Components < Stripe::StripeObject
       class BuyButton < Stripe::StripeObject
@@ -26,7 +26,7 @@ module Stripe
           # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
           sig { returns(String) }
           attr_reader :payment_method_redisplay
-          # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
+          # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`. The maximum redisplay limit is `10`.
           sig { returns(T.nilable(Integer)) }
           attr_reader :payment_method_redisplay_limit
           # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
@@ -109,7 +109,7 @@ module Stripe
             # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
             sig { returns(T.nilable(String)) }
             attr_accessor :payment_method_redisplay
-            # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
+            # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`. The maximum redisplay limit is `10`.
             sig { returns(T.nilable(Integer)) }
             attr_accessor :payment_method_redisplay_limit
             # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.

data/rbi/stripe/resources/dispute.rbi

@@ -340,7 +340,7 @@ module Stripe
     # Attribute for field payment_method_details
     sig { returns(PaymentMethodDetails) }
     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`, `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://stripe.com/docs/disputes/categories).
     sig { returns(String) }
     attr_reader :reason
     # Current status of dispute. Possible values are `warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, or `lost`.
@@ -752,7 +752,7 @@ module Stripe
 
     # When you get a dispute, contacting your customer is always the best first step. If that doesn't work, you can submit evidence to help us resolve the dispute in your favor. You can do this in your [dashboard](https://dashboard.stripe.com/disputes), but if you prefer, you can use the API to submit evidence programmatically.
     #
-    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://stripe.com/docs/disputes/categories).
+    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://docs.stripe.com/docs/disputes/categories).
     sig {
       params(dispute: String, params: T.any(::Stripe::Dispute::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Dispute)
      }

data/rbi/stripe/resources/event.rbi

@@ -53,9 +53,12 @@ module Stripe
     # The connected account that originates the event.
     sig { returns(String) }
     attr_reader :account
-    # The Stripe API version used to render `data`. This property is populated only for events on or after October 31, 2014.
+    # The Stripe API version used to render `data` when the event was created. The contents of `data` never change, so this value remains static regardless of the API version currently in use. This property is populated only for events created on or after October 31, 2014.
     sig { returns(T.nilable(String)) }
     attr_reader :api_version
+    # Authentication context needed to fetch the event or related object.
+    sig { returns(String) }
+    attr_reader :context
     # Time at which the object was created. Measured in seconds since the Unix epoch.
     sig { returns(Integer) }
     attr_reader :created

data/rbi/stripe/resources/file.rbi

@@ -7,7 +7,7 @@ module Stripe
   # files with the [create file](https://stripe.com/docs/api#create_file) request
   # (for example, when uploading dispute evidence). Stripe also
   # creates files independently (for example, the results of a [Sigma scheduled
-  # query](https://stripe.com/docs/api#scheduled_queries)).
+  # query](https://docs.stripe.com/api#scheduled_queries)).
   #
   # Related guide: [File upload guide](https://stripe.com/docs/file-upload)
   class File < APIResource

data/rbi/stripe/resources/identity/verification_report.rbi

@@ -108,12 +108,21 @@ module Stripe
         # Document ID number.
         sig { returns(T.nilable(String)) }
         attr_reader :number
+        # Sex of the person in the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :sex
         # Status of this `document` check.
         sig { returns(String) }
         attr_reader :status
         # Type of the document.
         sig { returns(T.nilable(String)) }
         attr_reader :type
+        # Place of birth as it appears in the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :unparsed_place_of_birth
+        # Sex as it appears in the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :unparsed_sex
       end
       class Email < Stripe::StripeObject
         class Error < Stripe::StripeObject

data/rbi/stripe/resources/identity/verification_session.rbi

@@ -6,11 +6,11 @@ module Stripe
   module Identity
     # A VerificationSession guides you through the process of collecting and verifying the identities
     # of your users. It contains details about the type of verification, such as what [verification
-    # check](https://stripe.com/docs/identity/verification-checks) to perform. Only create one VerificationSession for
+    # check](https://docs.stripe.com/docs/identity/verification-checks) to perform. Only create one VerificationSession for
     # each verification in your system.
     #
     # A VerificationSession transitions through [multiple
-    # statuses](https://stripe.com/docs/identity/how-sessions-work) throughout its lifetime as it progresses through
+    # statuses](https://docs.stripe.com/docs/identity/how-sessions-work) throughout its lifetime as it progresses through
     # the verification flow. The VerificationSession contains the user's verified data after
     # verification checks are complete.
     #
@@ -45,6 +45,14 @@ module Stripe
           attr_reader :require_verification
         end
         class IdNumber < Stripe::StripeObject; end
+        class Matching < Stripe::StripeObject
+          # Strictness of the DOB matching policy to apply.
+          sig { returns(String) }
+          attr_reader :dob
+          # Strictness of the name matching policy to apply.
+          sig { returns(String) }
+          attr_reader :name
+        end
         class Phone < Stripe::StripeObject
           # Request one time password verification of `provided_details.phone`.
           sig { returns(T::Boolean) }
@@ -59,6 +67,9 @@ module Stripe
         # Attribute for field id_number
         sig { returns(IdNumber) }
         attr_reader :id_number
+        # Attribute for field matching
+        sig { returns(Matching) }
+        attr_reader :matching
         # Attribute for field phone
         sig { returns(Phone) }
         attr_reader :phone
@@ -76,6 +87,14 @@ module Stripe
         sig { returns(String) }
         attr_reader :status
       end
+      class RelatedPerson < Stripe::StripeObject
+        # Token referencing the associated Account of the related Person resource.
+        sig { returns(String) }
+        attr_reader :account
+        # Token referencing the related Person resource.
+        sig { returns(String) }
+        attr_reader :person
+      end
       class VerifiedOutputs < Stripe::StripeObject
         class Address < Stripe::StripeObject
           # City, district, suburb, town, or village.
@@ -132,6 +151,15 @@ module Stripe
         # The user's verified phone number
         sig { returns(T.nilable(String)) }
         attr_reader :phone
+        # The user's verified sex.
+        sig { returns(T.nilable(String)) }
+        attr_reader :sex
+        # The user's verified place of birth as it appears in the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :unparsed_place_of_birth
+        # The user's verified sex as it appears in the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :unparsed_sex
       end
       # A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.
       sig { returns(T.nilable(String)) }
@@ -172,6 +200,9 @@ module Stripe
       # Customer ID
       sig { returns(T.nilable(String)) }
       attr_reader :related_customer
+      # Attribute for field related_person
+      sig { returns(RelatedPerson) }
+      attr_reader :related_person
       # Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work).
       sig { returns(String) }
       attr_reader :status
@@ -291,6 +322,16 @@ module Stripe
           sig { params(email: T.nilable(String), phone: T.nilable(String)).void }
           def initialize(email: nil, phone: nil); end
         end
+        class RelatedPerson < Stripe::RequestParams
+          # A token representing a connected account. If provided, the person parameter is also required and must be associated with the account.
+          sig { returns(String) }
+          attr_accessor :account
+          # A token referencing a Person resource that this verification is being used to verify.
+          sig { returns(String) }
+          attr_accessor :person
+          sig { params(account: String, person: String).void }
+          def initialize(account: nil, person: nil); end
+        end
         # A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.
         sig { returns(T.nilable(String)) }
         attr_accessor :client_reference_id
@@ -311,6 +352,11 @@ module Stripe
         # Customer ID
         sig { returns(T.nilable(String)) }
         attr_accessor :related_customer
+        # Tokens referencing a Person resource and it's associated account.
+        sig {
+          returns(T.nilable(::Stripe::Identity::VerificationSession::CreateParams::RelatedPerson))
+         }
+        attr_accessor :related_person
         # The URL that the user will be redirected to upon completing the verification flow.
         sig { returns(T.nilable(String)) }
         attr_accessor :return_url
@@ -321,7 +367,7 @@ module Stripe
         sig { returns(T.nilable(String)) }
         attr_accessor :verification_flow
         sig {
-          params(client_reference_id: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T::Hash[String, String]), options: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::Options), provided_details: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::ProvidedDetails), related_customer: T.nilable(String), return_url: T.nilable(String), type: T.nilable(String), verification_flow: T.nilable(String)).void
+          params(client_reference_id: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T::Hash[String, String]), options: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::Options), provided_details: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::ProvidedDetails), related_customer: T.nilable(String), related_person: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::RelatedPerson), return_url: T.nilable(String), type: T.nilable(String), verification_flow: T.nilable(String)).void
          }
         def initialize(
           client_reference_id: nil,
@@ -330,6 +376,7 @@ module Stripe
           options: nil,
           provided_details: nil,
           related_customer: nil,
+          related_person: nil,
           return_url: nil,
           type: nil,
           verification_flow: nil
@@ -422,17 +469,17 @@ module Stripe
         sig { params(expand: T.nilable(T::Array[String])).void }
         def initialize(expand: nil); end
       end
-      # A VerificationSession object can be canceled when it is in requires_input [status](https://stripe.com/docs/identity/how-sessions-work).
+      # A VerificationSession object can be canceled when it is in requires_input [status](https://docs.stripe.com/docs/identity/how-sessions-work).
       #
-      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://stripe.com/docs/identity/verification-sessions#cancel).
+      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#cancel).
       sig {
         params(params: T.any(::Stripe::Identity::VerificationSession::CancelParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Identity::VerificationSession)
        }
       def cancel(params = {}, opts = {}); end
 
-      # A VerificationSession object can be canceled when it is in requires_input [status](https://stripe.com/docs/identity/how-sessions-work).
+      # A VerificationSession object can be canceled when it is in requires_input [status](https://docs.stripe.com/docs/identity/how-sessions-work).
       #
-      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://stripe.com/docs/identity/verification-sessions#cancel).
+      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#cancel).
       sig {
         params(session: String, params: T.any(::Stripe::Identity::VerificationSession::CancelParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Identity::VerificationSession)
        }
@@ -444,7 +491,7 @@ module Stripe
       #
       # If your API key is in test mode, verification checks won't actually process, though everything else will occur as if in live mode.
       #
-      # Related guide: [Verify your users' identity documents](https://stripe.com/docs/identity/verify-identity-documents)
+      # Related guide: [Verify your users' identity documents](https://docs.stripe.com/docs/identity/verify-identity-documents)
       sig {
         params(params: T.any(::Stripe::Identity::VerificationSession::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Identity::VerificationSession)
        }
@@ -461,7 +508,7 @@ module Stripe
       # request logs, etc.
       #
       # A VerificationSession object can be redacted when it is in requires_input or verified
-      # [status](https://stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
+      # [status](https://docs.stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
       # state will automatically cancel it.
       #
       # The redaction process may take up to four days. When the redaction process is in progress, the
@@ -474,7 +521,7 @@ module Stripe
       # placeholder. The metadata field will also be erased. Redacted objects cannot be updated or
       # used for any purpose.
       #
-      # [Learn more](https://stripe.com/docs/identity/verification-sessions#redact).
+      # [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#redact).
       sig {
         params(params: T.any(::Stripe::Identity::VerificationSession::RedactParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Identity::VerificationSession)
        }
@@ -485,7 +532,7 @@ module Stripe
       # request logs, etc.
       #
       # A VerificationSession object can be redacted when it is in requires_input or verified
-      # [status](https://stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
+      # [status](https://docs.stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
       # state will automatically cancel it.
       #
       # The redaction process may take up to four days. When the redaction process is in progress, the
@@ -498,7 +545,7 @@ module Stripe
       # placeholder. The metadata field will also be erased. Redacted objects cannot be updated or
       # used for any purpose.
       #
-      # [Learn more](https://stripe.com/docs/identity/verification-sessions#redact).
+      # [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#redact).
       sig {
         params(session: String, params: T.any(::Stripe::Identity::VerificationSession::RedactParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Identity::VerificationSession)
        }