stripe 18.1.0.pre.alpha.4 → 18.2.0.pre.alpha.1

data/lib/stripe/params/v2/payments/settlement_allocation_intent_submit_params.rb

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Payments
+      class SettlementAllocationIntentSubmitParams < ::Stripe::RequestParams; end
+    end
+  end
+end

data/lib/stripe/params/v2/payments/settlement_allocation_intent_update_params.rb

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Payments
+      class SettlementAllocationIntentUpdateParams < ::Stripe::RequestParams
+        class Amount < ::Stripe::RequestParams
+          # A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
+          attr_accessor :value
+          # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+          attr_accessor :currency
+
+          def initialize(value: nil, currency: nil)
+            @value = value
+            @currency = currency
+          end
+        end
+        # The new amount for the SettlementAllocationIntent. Only amount.value can be updated and currency must remain same.
+        attr_accessor :amount
+        # The new reference for the SettlementAllocationIntent.
+        attr_accessor :reference
+
+        def initialize(amount: nil, reference: nil)
+          @amount = amount
+          @reference = reference
+        end
+      end
+    end
+  end
+end

data/lib/stripe/params/v2/payments/settlement_allocation_intents/split_cancel_params.rb

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Payments
+      module SettlementAllocationIntents
+        class SplitCancelParams < ::Stripe::RequestParams; end
+      end
+    end
+  end
+end

data/lib/stripe/params/v2/payments/settlement_allocation_intents/split_create_params.rb

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Payments
+      module SettlementAllocationIntents
+        class SplitCreateParams < ::Stripe::RequestParams
+          class Amount < ::Stripe::RequestParams
+            # A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
+            attr_accessor :value
+            # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+            attr_accessor :currency
+
+            def initialize(value: nil, currency: nil)
+              @value = value
+              @currency = currency
+            end
+          end
+          # The target account for settling the SettlementAllocationIntentSplit.
+          attr_accessor :account
+          # The amount and currency of the SettlementAllocationIntentSplit.
+          attr_accessor :amount
+          # Metadata associated with the SettlementAllocationIntentSplit.
+          attr_accessor :metadata
+          # The type of the fund transfer.
+          attr_accessor :type
+
+          def initialize(account: nil, amount: nil, metadata: nil, type: nil)
+            @account = account
+            @amount = amount
+            @metadata = metadata
+            @type = type
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stripe/params/v2/payments/settlement_allocation_intents/split_retrieve_params.rb

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Payments
+      module SettlementAllocationIntents
+        class SplitRetrieveParams < ::Stripe::RequestParams; end
+      end
+    end
+  end
+end

data/lib/stripe/params/v2/tax/manual_rule_create_params.rb

@@ -0,0 +1,94 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Tax
+      class ManualRuleCreateParams < ::Stripe::RequestParams
+        class Location < ::Stripe::RequestParams
+          # Country ISO-3166.
+          attr_accessor :country
+          # State ISO-3166.
+          attr_accessor :state
+
+          def initialize(country: nil, state: nil)
+            @country = country
+            @state = state
+          end
+        end
+
+        class Product < ::Stripe::RequestParams
+          # The type of the product.
+          attr_accessor :type
+          # The licensed item identifier.
+          attr_accessor :licensed_item
+          # The metered item identifier.
+          attr_accessor :metered_item
+          # The tax code for the product.
+          attr_accessor :tax_code
+
+          def initialize(type: nil, licensed_item: nil, metered_item: nil, tax_code: nil)
+            @type = type
+            @licensed_item = licensed_item
+            @metered_item = metered_item
+            @tax_code = tax_code
+          end
+        end
+
+        class ScheduledTaxRate < ::Stripe::RequestParams
+          class Rate < ::Stripe::RequestParams
+            # Country of the tax rate.
+            attr_accessor :country
+            # Description of the tax rate.
+            attr_accessor :description
+            # Display name of the tax rate as it will be shown on the invoice.
+            attr_accessor :display_name
+            # Jurisdiction of the tax rate should apply as it will be shown on the invoice.
+            attr_accessor :jurisdiction
+            # Percentage of the tax rate. Must be positive and maximum of 4 decimal points.
+            attr_accessor :percentage
+            # State of the tax rate.
+            attr_accessor :state
+
+            def initialize(
+              country: nil,
+              description: nil,
+              display_name: nil,
+              jurisdiction: nil,
+              percentage: nil,
+              state: nil
+            )
+              @country = country
+              @description = description
+              @display_name = display_name
+              @jurisdiction = jurisdiction
+              @percentage = percentage
+              @state = state
+            end
+          end
+          # The tax rates to be applied.
+          attr_accessor :rates
+          # The start time for the tax rate.
+          attr_accessor :starts_at
+
+          def initialize(rates: nil, starts_at: nil)
+            @rates = rates
+            @starts_at = starts_at
+          end
+        end
+        # Location where the rule applies.
+        attr_accessor :location
+        # Products associated with the rule.
+        attr_accessor :products
+        # Tax rates to be applied.
+        attr_accessor :scheduled_tax_rates
+
+        def initialize(location: nil, products: nil, scheduled_tax_rates: nil)
+          @location = location
+          @products = products
+          @scheduled_tax_rates = scheduled_tax_rates
+        end
+      end
+    end
+  end
+end

data/lib/stripe/params/v2/tax/manual_rule_deactivate_params.rb

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Tax
+      class ManualRuleDeactivateParams < ::Stripe::RequestParams; end
+    end
+  end
+end

data/lib/stripe/params/v2/tax/manual_rule_list_params.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Tax
+      class ManualRuleListParams < ::Stripe::RequestParams
+        # Optionally set the maximum number of results per page. Defaults to 20.
+        attr_accessor :limit
+
+        def initialize(limit: nil)
+          @limit = limit
+        end
+      end
+    end
+  end
+end

data/lib/stripe/params/v2/tax/manual_rule_retrieve_params.rb

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Tax
+      class ManualRuleRetrieveParams < ::Stripe::RequestParams; end
+    end
+  end
+end

data/lib/stripe/params/v2/tax/manual_rule_update_params.rb

@@ -0,0 +1,94 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Tax
+      class ManualRuleUpdateParams < ::Stripe::RequestParams
+        class Location < ::Stripe::RequestParams
+          # Country ISO-3166.
+          attr_accessor :country
+          # State ISO-3166.
+          attr_accessor :state
+
+          def initialize(country: nil, state: nil)
+            @country = country
+            @state = state
+          end
+        end
+
+        class Product < ::Stripe::RequestParams
+          # The type of the product.
+          attr_accessor :type
+          # The licensed item identifier.
+          attr_accessor :licensed_item
+          # The metered item identifier.
+          attr_accessor :metered_item
+          # The tax code for the product.
+          attr_accessor :tax_code
+
+          def initialize(type: nil, licensed_item: nil, metered_item: nil, tax_code: nil)
+            @type = type
+            @licensed_item = licensed_item
+            @metered_item = metered_item
+            @tax_code = tax_code
+          end
+        end
+
+        class ScheduledTaxRate < ::Stripe::RequestParams
+          class Rate < ::Stripe::RequestParams
+            # Country of the tax rate.
+            attr_accessor :country
+            # Description of the tax rate.
+            attr_accessor :description
+            # Display name of the tax rate as it will be shown on the invoice.
+            attr_accessor :display_name
+            # Jurisdiction of the tax rate should apply as it will be shown on the invoice.
+            attr_accessor :jurisdiction
+            # Percentage of the tax rate. Must be positive and maximum of 4 decimal points.
+            attr_accessor :percentage
+            # State of the tax rate.
+            attr_accessor :state
+
+            def initialize(
+              country: nil,
+              description: nil,
+              display_name: nil,
+              jurisdiction: nil,
+              percentage: nil,
+              state: nil
+            )
+              @country = country
+              @description = description
+              @display_name = display_name
+              @jurisdiction = jurisdiction
+              @percentage = percentage
+              @state = state
+            end
+          end
+          # The tax rates to be applied.
+          attr_accessor :rates
+          # The start time for the tax rate.
+          attr_accessor :starts_at
+
+          def initialize(rates: nil, starts_at: nil)
+            @rates = rates
+            @starts_at = starts_at
+          end
+        end
+        # Location where the rule applies.
+        attr_accessor :location
+        # Products associated with the rule.
+        attr_accessor :products
+        # Tax rates to be applied.
+        attr_accessor :scheduled_tax_rates
+
+        def initialize(location: nil, products: nil, scheduled_tax_rates: nil)
+          @location = location
+          @products = products
+          @scheduled_tax_rates = scheduled_tax_rates
+        end
+      end
+    end
+  end
+end

data/lib/stripe/params/webhook_endpoint_create_params.rb

@@ -13,7 +13,7 @@ module Stripe
     attr_accessor :enabled_events
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
-    # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+    # 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
     # The URL of the webhook endpoint.
     attr_accessor :url

data/lib/stripe/params/webhook_endpoint_update_params.rb

@@ -11,7 +11,7 @@ module Stripe
     attr_accessor :enabled_events
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
-    # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+    # 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
     # The URL of the webhook endpoint.
     attr_accessor :url

data/lib/stripe/params.rb

@@ -473,6 +473,9 @@ require "stripe/params/setup_intent_list_params"
 require "stripe/params/setup_intent_retrieve_params"
 require "stripe/params/setup_intent_update_params"
 require "stripe/params/setup_intent_verify_microdeposits_params"
+require "stripe/params/shared_payment/granted_token_create_params"
+require "stripe/params/shared_payment/granted_token_retrieve_params"
+require "stripe/params/shared_payment/granted_token_update_params"
 require "stripe/params/shipping_rate_create_params"
 require "stripe/params/shipping_rate_list_params"
 require "stripe/params/shipping_rate_retrieve_params"
@@ -588,6 +591,8 @@ require "stripe/params/test_helpers/issuing/transaction_create_force_capture_par
 require "stripe/params/test_helpers/issuing/transaction_create_unlinked_refund_params"
 require "stripe/params/test_helpers/issuing/transaction_refund_params"
 require "stripe/params/test_helpers/refund_expire_params"
+require "stripe/params/test_helpers/shared_payment/granted_token_create_params"
+require "stripe/params/test_helpers/shared_payment/granted_token_update_params"
 require "stripe/params/test_helpers/terminal/reader_present_payment_method_params"
 require "stripe/params/test_helpers/terminal/reader_succeed_input_collection_params"
 require "stripe/params/test_helpers/terminal/reader_timeout_input_collection_params"
@@ -798,6 +803,12 @@ require "stripe/params/v2/core/vault/us_bank_account_list_params"
 require "stripe/params/v2/core/vault/us_bank_account_retrieve_params"
 require "stripe/params/v2/core/vault/us_bank_account_send_microdeposits_params"
 require "stripe/params/v2/core/vault/us_bank_account_update_params"
+require "stripe/params/v2/iam/api_key_create_params"
+require "stripe/params/v2/iam/api_key_expire_params"
+require "stripe/params/v2/iam/api_key_list_params"
+require "stripe/params/v2/iam/api_key_retrieve_params"
+require "stripe/params/v2/iam/api_key_rotate_params"
+require "stripe/params/v2/iam/api_key_update_params"
 require "stripe/params/v2/money_management/adjustment_list_params"
 require "stripe/params/v2/money_management/adjustment_retrieve_params"
 require "stripe/params/v2/money_management/currency_conversion_create_params"
@@ -850,9 +861,22 @@ require "stripe/params/v2/payments/off_session_payment_capture_params"
 require "stripe/params/v2/payments/off_session_payment_create_params"
 require "stripe/params/v2/payments/off_session_payment_list_params"
 require "stripe/params/v2/payments/off_session_payment_retrieve_params"
+require "stripe/params/v2/payments/settlement_allocation_intent_cancel_params"
+require "stripe/params/v2/payments/settlement_allocation_intent_create_params"
+require "stripe/params/v2/payments/settlement_allocation_intent_retrieve_params"
+require "stripe/params/v2/payments/settlement_allocation_intent_submit_params"
+require "stripe/params/v2/payments/settlement_allocation_intent_update_params"
+require "stripe/params/v2/payments/settlement_allocation_intents/split_cancel_params"
+require "stripe/params/v2/payments/settlement_allocation_intents/split_create_params"
+require "stripe/params/v2/payments/settlement_allocation_intents/split_retrieve_params"
 require "stripe/params/v2/reporting/report_retrieve_params"
 require "stripe/params/v2/reporting/report_run_create_params"
 require "stripe/params/v2/reporting/report_run_retrieve_params"
+require "stripe/params/v2/tax/manual_rule_create_params"
+require "stripe/params/v2/tax/manual_rule_deactivate_params"
+require "stripe/params/v2/tax/manual_rule_list_params"
+require "stripe/params/v2/tax/manual_rule_retrieve_params"
+require "stripe/params/v2/tax/manual_rule_update_params"
 require "stripe/params/v2/test_helpers/financial_address_credit_params"
 require "stripe/params/v2/test_helpers/financial_address_generate_microdeposits_params"
 require "stripe/params/v2/test_helpers/money_management_recipient_verifications_params"

data/lib/stripe/resources/account.rb

@@ -78,7 +78,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
@@ -300,7 +300,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
@@ -432,13 +432,13 @@ module Stripe
 
       class Verification < ::Stripe::StripeObject
         class Document < ::Stripe::StripeObject
-          # The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](/file-upload#uploading-a-file).
+          # The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](/file-upload#uploading-a-file).
           attr_reader :back
           # A user-displayable string describing the verification state of this document.
           attr_reader :details
           # One of `document_corrupt`, `document_expired`, `document_failed_copy`, `document_failed_greyscale`, `document_failed_other`, `document_failed_test_mode`, `document_fraudulent`, `document_incomplete`, `document_invalid`, `document_manipulated`, `document_not_readable`, `document_not_uploaded`, `document_type_not_supported`, or `document_too_large`. A machine-readable code specifying the verification state for this document.
           attr_reader :details_code
-          # The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](/file-upload#uploading-a-file).
+          # The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](/file-upload#uploading-a-file).
           attr_reader :front
 
           def self.inner_class_types
@@ -466,11 +466,11 @@ module Stripe
       attr_reader :address_kana
       # The Kanji variation of the company's primary address (Japan only).
       attr_reader :address_kanji
-      # Whether the company's directors have been provided. This Boolean will be `true` if you've manually indicated that all directors are provided via [the `directors_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-directors_provided).
+      # Whether the company's directors have been provided. This Boolean will be `true` if you've manually indicated that all directors are provided via [the `directors_provided` parameter](https://docs.stripe.com/api/accounts/update#update_account-company-directors_provided).
       attr_reader :directors_provided
       # This hash is used to attest that the director information provided to Stripe is both current and correct.
       attr_reader :directorship_declaration
-      # Whether the company's executives have been provided. This Boolean will be `true` if you've manually indicated that all executives are provided via [the `executives_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-executives_provided), or if Stripe determined that sufficient executives were provided.
+      # Whether the company's executives have been provided. This Boolean will be `true` if you've manually indicated that all executives are provided via [the `executives_provided` parameter](https://docs.stripe.com/api/accounts/update#update_account-company-executives_provided), or if Stripe determined that sufficient executives were provided.
       attr_reader :executives_provided
       # The export license ID number of the company, also referred as Import Export Code (India only).
       attr_reader :export_license_id
@@ -482,7 +482,7 @@ module Stripe
       attr_reader :name_kana
       # The Kanji variation of the company's legal name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
       attr_reader :name_kanji
-      # Whether the company's owners have been provided. This Boolean will be `true` if you've manually indicated that all owners are provided via [the `owners_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-owners_provided), or if Stripe determined that sufficient owners were provided. Stripe determines ownership requirements using both the number of owners provided and their total percent ownership (calculated by adding the `percent_ownership` of each owner together).
+      # Whether the company's owners have been provided. This Boolean will be `true` if you've manually indicated that all owners are provided via [the `owners_provided` parameter](https://docs.stripe.com/api/accounts/update#update_account-company-owners_provided), or if Stripe determined that sufficient owners were provided. Stripe determines ownership requirements using both the number of owners provided and their total percent ownership (calculated by adding the `percent_ownership` of each owner together).
       attr_reader :owners_provided
       # This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct.
       attr_reader :ownership_declaration
@@ -494,7 +494,7 @@ module Stripe
       attr_reader :registration_date
       # This hash is used to attest that the representative is authorized to act as the representative of their legal entity.
       attr_reader :representative_declaration
-      # The category identifying the legal structure of the company or legal entity. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`. See [Business structure](https://stripe.com/docs/connect/identity-verification#business-structure) for more details.
+      # The category identifying the legal structure of the company or legal entity. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`. See [Business structure](https://docs.stripe.com/connect/identity-verification#business-structure) for more details.
       attr_reader :structure
       # Whether the company's business ID number was provided.
       attr_reader :tax_id_provided
@@ -598,7 +598,7 @@ module Stripe
       attr_reader :dashboard
       # Attribute for field fees
       attr_reader :fees
-      # `true` if the Connect application retrieving the resource controls the account and can therefore exercise [platform controls](https://stripe.com/docs/connect/platform-controls-for-standard-accounts). Otherwise, this field is null.
+      # `true` if the Connect application retrieving the resource controls the account and can therefore exercise [platform controls](https://docs.stripe.com/connect/platform-controls-for-standard-accounts). Otherwise, this field is null.
       attr_reader :is_controller
       # Attribute for field losses
       attr_reader :losses
@@ -626,9 +626,9 @@ module Stripe
 
     class FutureRequirements < ::Stripe::StripeObject
       class Alternative < ::Stripe::StripeObject
-        # Fields that can be provided to satisfy all fields in `original_fields_due`.
+        # Fields that can be provided to resolve all fields in `original_fields_due`.
         attr_reader :alternative_fields_due
-        # Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`.
+        # Fields that are due and can be resolved by providing all fields in `alternative_fields_due`.
         attr_reader :original_fields_due
 
         def self.inner_class_types
@@ -656,21 +656,21 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # Fields that are due and can be satisfied by providing the corresponding alternative fields instead.
+      # Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again.
       attr_reader :alternatives
       # Date on which `future_requirements` becomes the main `requirements` hash and `future_requirements` becomes empty. After the transition, `currently_due` requirements may immediately become `past_due`, but the account may also be given a grace period depending on its enablement state prior to transitioning.
       attr_reader :current_deadline
-      # Fields that need to be collected to keep the account enabled. If not collected by `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash.
+      # Fields that need to be resolved to keep the account enabled. If not resolved by `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash.
       attr_reader :currently_due
       # This is typed as an enum for consistency with `requirements.disabled_reason`.
       attr_reader :disabled_reason
-      # Fields that are `currently_due` and need to be collected again because validation or verification failed.
+      # Details about validation and verification failures for `due` requirements that must be resolved.
       attr_reader :errors
       # Fields you must collect when all thresholds are reached. As they become required, they appear in `currently_due` as well.
       attr_reader :eventually_due
-      # Fields that weren't collected by `requirements.current_deadline`. These fields need to be collected to enable the capability on the account. New fields will never appear here; `future_requirements.past_due` will always be a subset of `requirements.past_due`.
+      # Fields that haven't been resolved by `requirements.current_deadline`. These fields need to be resolved to enable the capability on the account. `future_requirements.past_due` is a subset of `requirements.past_due`.
       attr_reader :past_due
-      # Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`. Fields might appear in `eventually_due` or `currently_due` and in `pending_verification` if verification fails but another verification is still pending.
+      # Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending.
       attr_reader :pending_verification
 
       def self.inner_class_types
@@ -683,7 +683,7 @@ module Stripe
     end
 
     class Groups < ::Stripe::StripeObject
-      # The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://stripe.com/docs/connect/platform-pricing-tools) for details.
+      # The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://docs.stripe.com/connect/platform-pricing-tools) for details.
       attr_reader :payments_pricing
 
       def self.inner_class_types
@@ -697,9 +697,9 @@ module Stripe
 
     class Requirements < ::Stripe::StripeObject
       class Alternative < ::Stripe::StripeObject
-        # Fields that can be provided to satisfy all fields in `original_fields_due`.
+        # Fields that can be provided to resolve all fields in `original_fields_due`.
         attr_reader :alternative_fields_due
-        # Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`.
+        # Fields that are due and can be resolved by providing all fields in `alternative_fields_due`.
         attr_reader :original_fields_due
 
         def self.inner_class_types
@@ -727,21 +727,21 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # Fields that are due and can be satisfied by providing the corresponding alternative fields instead.
+      # Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again.
       attr_reader :alternatives
       # Date by which the fields in `currently_due` must be collected to keep the account enabled. These fields may disable the account sooner if the next threshold is reached before they are collected.
       attr_reader :current_deadline
-      # Fields that need to be collected to keep the account enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the account is disabled.
+      # Fields that need to be resolved to keep the account enabled. If not resolved by `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled.
       attr_reader :currently_due
-      # If the account is disabled, this enum describes why. [Learn more about handling verification issues](https://stripe.com/docs/connect/handling-api-verification).
+      # If the account is disabled, this enum describes why. [Learn more about handling verification issues](https://docs.stripe.com/connect/handling-api-verification).
       attr_reader :disabled_reason
-      # Fields that are `currently_due` and need to be collected again because validation or verification failed.
+      # Details about validation and verification failures for `due` requirements that must be resolved.
       attr_reader :errors
       # Fields you must collect when all thresholds are reached. As they become required, they appear in `currently_due` as well, and `current_deadline` becomes set.
       attr_reader :eventually_due
-      # Fields that weren't collected by `current_deadline`. These fields need to be collected to enable the account.
+      # Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the account.
       attr_reader :past_due
-      # Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
+      # Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending.
       attr_reader :pending_verification
 
       def self.inner_class_types
@@ -783,7 +783,7 @@ module Stripe
       attr_reader :charges
       # Attribute for field payouts
       attr_reader :payouts
-      # Represents the rejected reason of the account. Empty if account is not rejected, or rejected by Stripe. Please see [this page for more details](https://stripe.com/docs/connect/)
+      # Represents the rejected reason of the account. Empty if account is not rejected, or rejected by Stripe. Please see [this page for more details](https://docs.stripe.com/connect/)
       attr_reader :rejected_reason
 
       def self.inner_class_types
@@ -1186,7 +1186,7 @@ module Stripe
     #
     # See the [Standard onboarding](/connect/standard-accounts) or [Express onboarding](/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](/connect/handling-api-verification#person-information).
     attr_reader :individual
-    # 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/account_link.rb

@@ -5,7 +5,7 @@ module Stripe
   # Account Links are the means by which a Connect platform grants a connected account permission to access
   # Stripe-hosted applications, such as Connect Onboarding.
   #
-  # Related guide: [Connect Onboarding](https://stripe.com/docs/connect/custom/hosted-onboarding)
+  # Related guide: [Connect Onboarding](https://docs.stripe.com/connect/custom/hosted-onboarding)
   class AccountLink < APIResource
     extend Stripe::APIOperations::Create