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

data/lib/stripe/params/credit_note_update_params.rb

@@ -7,7 +7,7 @@ module Stripe
     attr_accessor :expand
     # Credit note memo.
     attr_accessor :memo
-    # 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
 
     def initialize(expand: nil, memo: nil, metadata: nil)

data/lib/stripe/params/customer_balance_transaction_create_params.rb

@@ -5,13 +5,13 @@ module Stripe
   class CustomerBalanceTransactionCreateParams < ::Stripe::RequestParams
     # The integer amount in **cents (or local equivalent)** to apply to the customer's credit balance.
     attr_accessor :amount
-    # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Specifies the [`invoice_credit_balance`](https://stripe.com/docs/api/customers/object#customer_object-invoice_credit_balance) that this transaction will apply to. If the customer's `currency` is not set, it will be updated to this 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). Specifies the [`invoice_credit_balance`](https://docs.stripe.com/api/customers/object#customer_object-invoice_credit_balance) that this transaction will apply to. If the customer's `currency` is not set, it will be updated to this value.
     attr_accessor :currency
     # An arbitrary string attached to the object. Often useful for displaying to users.
     attr_accessor :description
     # 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
 
     def initialize(amount: nil, currency: nil, description: nil, expand: nil, metadata: nil)

data/lib/stripe/params/customer_balance_transaction_list_params.rb

@@ -26,15 +26,25 @@ module Stripe
     attr_accessor :ending_before
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
+    # Only return transactions that are related to the specified invoice.
+    attr_accessor :invoice
     # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
     attr_accessor :limit
     # 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.
     attr_accessor :starting_after
 
-    def initialize(created: nil, ending_before: nil, expand: nil, limit: nil, starting_after: nil)
+    def initialize(
+      created: nil,
+      ending_before: nil,
+      expand: nil,
+      invoice: nil,
+      limit: nil,
+      starting_after: nil
+    )
       @created = created
       @ending_before = ending_before
       @expand = expand
+      @invoice = invoice
       @limit = limit
       @starting_after = starting_after
     end

data/lib/stripe/params/customer_balance_transaction_update_params.rb

@@ -7,7 +7,7 @@ module Stripe
     attr_accessor :description
     # 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
 
     def initialize(description: nil, expand: nil, metadata: nil)

data/lib/stripe/params/customer_cash_balance_update_params.rb

@@ -4,7 +4,7 @@
 module Stripe
   class CustomerCashBalanceUpdateParams < ::Stripe::RequestParams
     class Settings < ::Stripe::RequestParams
-      # Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation).
+      # Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation).
       attr_accessor :reconciliation_mode
 
       def initialize(reconciliation_mode: nil)

data/lib/stripe/params/customer_create_params.rb

@@ -14,7 +14,7 @@ module Stripe
       attr_accessor :line2
       # ZIP or postal code.
       attr_accessor :postal_code
-      # State, county, province, or region.
+      # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
       attr_accessor :state
 
       def initialize(city: nil, country: nil, line1: nil, line2: nil, postal_code: nil, state: nil)
@@ -29,7 +29,7 @@ module Stripe
 
     class CashBalance < ::Stripe::RequestParams
       class Settings < ::Stripe::RequestParams
-        # Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation).
+        # Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation).
         attr_accessor :reconciliation_mode
 
         def initialize(reconciliation_mode: nil)
@@ -103,7 +103,7 @@ module Stripe
         attr_accessor :line2
         # ZIP or postal code.
         attr_accessor :postal_code
-        # State, county, province, or region.
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
         attr_accessor :state
 
         def initialize(
@@ -159,7 +159,7 @@ module Stripe
         @value = value
       end
     end
-    # The customer's address.
+    # The customer's address. Learn about [country-specific requirements for calculating tax](https://docs.stripe.com/invoicing/taxes?dashboard-or-api=dashboard#set-up-customer).
     attr_accessor :address
     # An integer amount in cents (or local equivalent) that represents the customer's current balance, which affect the customer's future invoices. A negative amount represents a credit that decreases the amount due on an invoice; a positive amount increases the amount due on an invoice.
     attr_accessor :balance
@@ -179,7 +179,7 @@ module Stripe
     attr_accessor :invoice_prefix
     # Default invoice settings for this customer.
     attr_accessor :invoice_settings
-    # 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 customer's full name or business name.
     attr_accessor :name

data/lib/stripe/params/customer_fund_cash_balance_params.rb

@@ -3,13 +3,13 @@
 
 module Stripe
   class CustomerFundCashBalanceParams < ::Stripe::RequestParams
-    # Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency).
+    # Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency).
     attr_accessor :amount
     # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
     attr_accessor :currency
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
-    # A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://stripe.com/docs/payments/customer-balance/reconciliation) applies to different user inputs.
+    # A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://docs.stripe.com/payments/customer-balance/reconciliation) applies to different user inputs.
     attr_accessor :reference
 
     def initialize(amount: nil, currency: nil, expand: nil, reference: nil)

data/lib/stripe/params/customer_payment_source_create_params.rb

@@ -5,9 +5,9 @@ module Stripe
   class CustomerPaymentSourceCreateParams < ::Stripe::RequestParams
     # 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
-    # Please refer to full [documentation](https://stripe.com/docs/api) instead.
+    # Please refer to full [documentation](https://api.stripe.com) instead.
     attr_accessor :source
     # Attribute for param field validate
     attr_accessor :validate

data/lib/stripe/params/customer_payment_source_update_params.rb

@@ -15,7 +15,7 @@ module Stripe
         attr_accessor :line2
         # ZIP or postal code.
         attr_accessor :postal_code
-        # State, county, province, or region.
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
         attr_accessor :state
 
         def initialize(
@@ -72,7 +72,7 @@ module Stripe
     attr_accessor :exp_year
     # 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
     # Cardholder name.
     attr_accessor :name

data/lib/stripe/params/customer_search_params.rb

@@ -9,7 +9,7 @@ module Stripe
     attr_accessor :limit
     # A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
     attr_accessor :page
-    # The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for customers](https://stripe.com/docs/search#query-fields-for-customers).
+    # The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for customers](https://docs.stripe.com/search#query-fields-for-customers).
     attr_accessor :query
 
     def initialize(expand: nil, limit: nil, page: nil, query: nil)

data/lib/stripe/params/customer_update_params.rb

@@ -14,7 +14,7 @@ module Stripe
       attr_accessor :line2
       # ZIP or postal code.
       attr_accessor :postal_code
-      # State, county, province, or region.
+      # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
       attr_accessor :state
 
       def initialize(city: nil, country: nil, line1: nil, line2: nil, postal_code: nil, state: nil)
@@ -29,7 +29,7 @@ module Stripe
 
     class CashBalance < ::Stripe::RequestParams
       class Settings < ::Stripe::RequestParams
-        # Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation).
+        # Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation).
         attr_accessor :reconciliation_mode
 
         def initialize(reconciliation_mode: nil)
@@ -103,7 +103,7 @@ module Stripe
         attr_accessor :line2
         # ZIP or postal code.
         attr_accessor :postal_code
-        # State, county, province, or region.
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
         attr_accessor :state
 
         def initialize(
@@ -147,7 +147,7 @@ module Stripe
         @validate_location = validate_location
       end
     end
-    # The customer's address.
+    # The customer's address. Learn about [country-specific requirements for calculating tax](https://docs.stripe.com/invoicing/taxes?dashboard-or-api=dashboard#set-up-customer).
     attr_accessor :address
     # An integer amount in cents (or local equivalent) that represents the customer's current balance, which affect the customer's future invoices. A negative amount represents a credit that decreases the amount due on an invoice; a positive amount increases the amount due on an invoice.
     attr_accessor :balance
@@ -155,11 +155,11 @@ module Stripe
     attr_accessor :business_name
     # Balance information and default balance settings for this customer.
     attr_accessor :cash_balance
-    # If you are using payment methods created via the PaymentMethods API, see the [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method) parameter.
+    # If you are using payment methods created via the PaymentMethods API, see the [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/update#update_customer-invoice_settings-default_payment_method) parameter.
     #
     # Provide the ID of a payment source already attached to this customer to make it this customer's default payment source.
     #
-    # If you want to add a new payment source and make it the default, see the [source](https://stripe.com/docs/api/customers/update#update_customer-source) property.
+    # If you want to add a new payment source and make it the default, see the [source](https://docs.stripe.com/api/customers/update#update_customer-source) property.
     attr_accessor :default_source
     # An arbitrary string that you can attach to a customer object. It is displayed alongside the customer in the dashboard.
     attr_accessor :description
@@ -173,7 +173,7 @@ module Stripe
     attr_accessor :invoice_prefix
     # Default invoice settings for this customer.
     attr_accessor :invoice_settings
-    # 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 customer's full name or business name.
     attr_accessor :name

data/lib/stripe/params/delegated_checkout/requested_session_confirm_params.rb

@@ -4,6 +4,86 @@
 module Stripe
   module DelegatedCheckout
     class RequestedSessionConfirmParams < ::Stripe::RequestParams
+      class PaymentMethodData < ::Stripe::RequestParams
+        class BillingDetails < ::Stripe::RequestParams
+          class Address < ::Stripe::RequestParams
+            # City, district, suburb, town, or village.
+            attr_accessor :city
+            # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+            attr_accessor :country
+            # Address line 1, such as the street, PO Box, or company name.
+            attr_accessor :line1
+            # Address line 2, such as the apartment, suite, unit, or building.
+            attr_accessor :line2
+            # ZIP or postal code.
+            attr_accessor :postal_code
+            # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
+            attr_accessor :state
+
+            def initialize(
+              city: nil,
+              country: nil,
+              line1: nil,
+              line2: nil,
+              postal_code: nil,
+              state: nil
+            )
+              @city = city
+              @country = country
+              @line1 = line1
+              @line2 = line2
+              @postal_code = postal_code
+              @state = state
+            end
+          end
+          # The address for the billing details.
+          attr_accessor :address
+          # The email for the billing details.
+          attr_accessor :email
+          # The name for the billing details.
+          attr_accessor :name
+          # The phone for the billing details.
+          attr_accessor :phone
+
+          def initialize(address: nil, email: nil, name: nil, phone: nil)
+            @address = address
+            @email = email
+            @name = name
+            @phone = phone
+          end
+        end
+
+        class Card < ::Stripe::RequestParams
+          # The CVC of the card.
+          attr_accessor :cvc
+          # The expiration month of the card.
+          attr_accessor :exp_month
+          # The expiration year of the card.
+          attr_accessor :exp_year
+          # The number of the card.
+          attr_accessor :number
+
+          def initialize(cvc: nil, exp_month: nil, exp_year: nil, number: nil)
+            @cvc = cvc
+            @exp_month = exp_month
+            @exp_year = exp_year
+            @number = number
+          end
+        end
+        # The billing details for the payment method data.
+        attr_accessor :billing_details
+        # The card for the payment method data.
+        attr_accessor :card
+        # The type of the payment method data.
+        attr_accessor :type
+
+        def initialize(billing_details: nil, card: nil, type: nil)
+          @billing_details = billing_details
+          @card = card
+          @type = type
+        end
+      end
+
       class RiskDetails < ::Stripe::RequestParams
         class ClientDeviceMetadataDetails < ::Stripe::RequestParams
           # The radar session.
@@ -42,12 +122,15 @@ module Stripe
       attr_accessor :expand
       # The PaymentMethod to use with the requested session.
       attr_accessor :payment_method
+      # The payment method data for this requested session.
+      attr_accessor :payment_method_data
       # Risk details/signals associated with the requested session
       attr_accessor :risk_details
 
-      def initialize(expand: nil, payment_method: nil, risk_details: nil)
+      def initialize(expand: nil, payment_method: nil, payment_method_data: nil, risk_details: nil)
         @expand = expand
         @payment_method = payment_method
+        @payment_method_data = payment_method_data
         @risk_details = risk_details
       end
     end

data/lib/stripe/params/dispute_update_params.rb

@@ -18,7 +18,7 @@ module Stripe
               attr_accessor :line2
               # ZIP or postal code.
               attr_accessor :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_accessor :state
 
               def initialize(
@@ -87,7 +87,7 @@ module Stripe
               attr_accessor :line2
               # ZIP or postal code.
               attr_accessor :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_accessor :state
 
               def initialize(
@@ -295,7 +295,7 @@ module Stripe
     attr_accessor :expand
     # Intended submission method for the dispute.
     attr_accessor :intended_submission_method
-    # 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
     # Whether to immediately submit evidence to the bank. If `false`, evidence is staged on the dispute. Staged evidence is visible in the API and Dashboard, and can be submitted to the bank by making another request with this attribute set to `true` (the default).
     attr_accessor :submit

data/lib/stripe/params/external_account_create_params.rb

@@ -119,9 +119,9 @@ module Stripe
     attr_accessor :default_for_currency
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
-    # Either a token, like the ones returned by [Stripe.js](https://stripe.com/docs/js), or a dictionary containing a user’s external account details (with the options shown below).
+    # Either a token, like the ones returned by [Stripe.js](https://docs.stripe.com/js), or a dictionary containing a user’s external account details (with the options shown below).
     attr_accessor :external_account
-    # 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
 
     def initialize(default_for_currency: nil, expand: nil, external_account: nil, metadata: nil)

data/lib/stripe/params/external_account_update_params.rb

@@ -5,7 +5,7 @@ module Stripe
   class ExternalAccountUpdateParams < ::Stripe::RequestParams
     class Documents < ::Stripe::RequestParams
       class BankAccountOwnershipVerification < ::Stripe::RequestParams
-        # One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`.
+        # One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`.
         attr_accessor :files
 
         def initialize(files: nil)
@@ -47,7 +47,7 @@ module Stripe
     attr_accessor :exp_year
     # 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
     # Cardholder name.
     attr_accessor :name

data/lib/stripe/params/file_create_params.rb

@@ -8,7 +8,7 @@ module Stripe
       attr_accessor :create
       # The link isn't available after this future timestamp.
       attr_accessor :expires_at
-      # 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
 
       def initialize(create: nil, expires_at: nil, metadata: nil)
@@ -21,9 +21,9 @@ module Stripe
     attr_accessor :expand
     # A file to upload. Make sure that the specifications follow RFC 2388, which defines file transfers for the `multipart/form-data` protocol.
     attr_accessor :file
-    # Optional parameters that automatically create a [file link](https://stripe.com/docs/api#file_links) for the newly created file.
+    # Optional parameters that automatically create a [file link](https://api.stripe.com#file_links) for the newly created file.
     attr_accessor :file_link_data
-    # The [purpose](https://stripe.com/docs/file-upload#uploading-a-file) of the uploaded file.
+    # The [purpose](https://docs.stripe.com/file-upload#uploading-a-file) of the uploaded file.
     attr_accessor :purpose
 
     def initialize(expand: nil, file: nil, file_link_data: nil, purpose: nil)

data/lib/stripe/params/file_link_create_params.rb

@@ -9,7 +9,7 @@ module Stripe
     attr_accessor :expires_at
     # The ID of the file. The file's `purpose` must be one of the following: `business_icon`, `business_logo`, `customer_signature`, `dispute_evidence`, `finance_report_run`, `financial_account_statement`, `identity_document_downloadable`, `issuing_regulatory_reporting`, `pci_document`, `selfie`, `sigma_scheduled_query`, `tax_document_user_upload`, `terminal_android_apk`, or `terminal_reader_splashscreen`.
     attr_accessor :file
-    # 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
 
     def initialize(expand: nil, expires_at: nil, file: nil, metadata: nil)

data/lib/stripe/params/file_link_update_params.rb

@@ -7,7 +7,7 @@ module Stripe
     attr_accessor :expand
     # A future timestamp after which the link will no longer be usable, or `now` to expire the link immediately.
     attr_accessor :expires_at
-    # 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
 
     def initialize(expand: nil, expires_at: nil, metadata: nil)

data/lib/stripe/params/financial_connections/account_list_params.rb

@@ -5,11 +5,11 @@ module Stripe
   module FinancialConnections
     class AccountListParams < ::Stripe::RequestParams
       class AccountHolder < ::Stripe::RequestParams
-        # The ID of the Stripe account whose accounts will be retrieved.
+        # The ID of the Stripe account whose accounts you will retrieve.
         attr_accessor :account
-        # The ID of the Stripe customer whose accounts will be retrieved.
+        # The ID of the Stripe customer whose accounts you will retrieve.
         attr_accessor :customer
-        # The Account ID of the Stripe customer whose accounts will be retrieved.
+        # The ID of the Account representing a customer whose accounts you will retrieve.
         attr_accessor :customer_account
 
         def initialize(account: nil, customer: nil, customer_account: nil)

data/lib/stripe/params/financial_connections/session_create_params.rb

@@ -5,11 +5,11 @@ module Stripe
   module FinancialConnections
     class SessionCreateParams < ::Stripe::RequestParams
       class AccountHolder < ::Stripe::RequestParams
-        # The ID of the Stripe account whose accounts will be retrieved. Should only be present if `type` is `account`.
+        # The ID of the Stripe account whose accounts you will retrieve. Only available when `type` is `account`.
         attr_accessor :account
-        # The ID of the Stripe customer whose accounts will be retrieved. Should only be present if `type` is `customer`.
+        # The ID of the Stripe customer whose accounts you will retrieve. Only available when `type` is `customer`.
         attr_accessor :customer
-        # The ID of the Stripe customer Account whose accounts will be retrieved. Should only be present if `type` is `customer`.
+        # The ID of Account representing a customer whose accounts you will retrieve. Only available when `type` is `customer`.
         attr_accessor :customer_account
         # Type of account holder to collect accounts for.
         attr_accessor :type

data/lib/stripe/params/forwarding/request_create_params.rb

@@ -28,7 +28,7 @@ module Stripe
       end
       # 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 PaymentMethod to insert into the forwarded request. Forwarding previously consumed PaymentMethods is allowed.
       attr_accessor :payment_method

data/lib/stripe/params/identity/verification_session_create_params.rb

@@ -8,11 +8,11 @@ module Stripe
         class Document < ::Stripe::RequestParams
           # Array of strings of allowed identity document types. If the provided identity document isn’t one of the allowed types, the verification check will fail with a document_type_not_allowed error code.
           attr_accessor :allowed_types
-          # Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document’s extracted name and date of birth.
+          # Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document’s extracted name and date of birth.
           attr_accessor :require_id_number
           # Disable image uploads, identity document images have to be captured using the device’s camera.
           attr_accessor :require_live_capture
-          # Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user’s face. [Learn more](https://stripe.com/docs/identity/selfie).
+          # Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user’s face. [Learn more](https://docs.stripe.com/identity/selfie).
           attr_accessor :require_matching_selfie
 
           def initialize(
@@ -27,7 +27,7 @@ module Stripe
             @require_matching_selfie = require_matching_selfie
           end
         end
-        # Options that apply to the [document check](https://stripe.com/docs/identity/verification-checks?type=document).
+        # Options that apply to the [document check](https://docs.stripe.com/identity/verification-checks?type=document).
         attr_accessor :document
 
         def initialize(document: nil)
@@ -62,7 +62,7 @@ module Stripe
       attr_accessor :client_reference_id
       # 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
       # A set of options for the session’s verification checks.
       attr_accessor :options
@@ -70,13 +70,13 @@ module Stripe
       attr_accessor :provided_details
       # Customer ID
       attr_accessor :related_customer
-      # Token referencing a Customer Account resource.
+      # The ID of the Account representing a customer.
       attr_accessor :related_customer_account
       # Tokens referencing a Person resource and it's associated account.
       attr_accessor :related_person
       # The URL that the user will be redirected to upon completing the verification flow.
       attr_accessor :return_url
-      # The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. You must provide a `type` if not passing `verification_flow`.
+      # The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed. You must provide a `type` if not passing `verification_flow`.
       attr_accessor :type
       # The ID of a verification flow from the Dashboard. See https://docs.stripe.com/identity/verification-flows.
       attr_accessor :verification_flow

data/lib/stripe/params/identity/verification_session_list_params.rb

@@ -31,13 +31,13 @@ module Stripe
       attr_accessor :expand
       # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
       attr_accessor :limit
-      # Attribute for param field related_customer
+      # Customer ID
       attr_accessor :related_customer
-      # Attribute for param field related_customer_account
+      # The ID of the Account representing a customer.
       attr_accessor :related_customer_account
       # 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.
       attr_accessor :starting_after
-      # Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work).
+      # Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://docs.stripe.com/identity/how-sessions-work).
       attr_accessor :status
 
       def initialize(

data/lib/stripe/params/identity/verification_session_update_params.rb

@@ -8,11 +8,11 @@ module Stripe
         class Document < ::Stripe::RequestParams
           # Array of strings of allowed identity document types. If the provided identity document isn’t one of the allowed types, the verification check will fail with a document_type_not_allowed error code.
           attr_accessor :allowed_types
-          # Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document’s extracted name and date of birth.
+          # Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document’s extracted name and date of birth.
           attr_accessor :require_id_number
           # Disable image uploads, identity document images have to be captured using the device’s camera.
           attr_accessor :require_live_capture
-          # Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user’s face. [Learn more](https://stripe.com/docs/identity/selfie).
+          # Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user’s face. [Learn more](https://docs.stripe.com/identity/selfie).
           attr_accessor :require_matching_selfie
 
           def initialize(
@@ -27,7 +27,7 @@ module Stripe
             @require_matching_selfie = require_matching_selfie
           end
         end
-        # Options that apply to the [document check](https://stripe.com/docs/identity/verification-checks?type=document).
+        # Options that apply to the [document check](https://docs.stripe.com/identity/verification-checks?type=document).
         attr_accessor :document
 
         def initialize(document: nil)
@@ -48,13 +48,13 @@ module Stripe
       end
       # 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
       # A set of options for the session’s verification checks.
       attr_accessor :options
       # Details provided about the user being verified. These details may be shown to the user.
       attr_accessor :provided_details
-      # The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed.
+      # The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed.
       attr_accessor :type
 
       def initialize(expand: nil, metadata: nil, options: nil, provided_details: nil, type: nil)