stripe 18.1.0.pre.alpha.4 → 18.1.0

data/lib/stripe/params/invoice_update_params.rb

@@ -3,24 +3,6 @@
 
 module Stripe
   class InvoiceUpdateParams < ::Stripe::RequestParams
-    class AmountsDue < ::Stripe::RequestParams
-      # The amount in cents (or local equivalent).
-      attr_accessor :amount
-      # Number of days from when invoice is finalized until the payment is due.
-      attr_accessor :days_until_due
-      # An arbitrary string attached to the object. Often useful for displaying to users.
-      attr_accessor :description
-      # Date on which a payment plan’s payment is due.
-      attr_accessor :due_date
-
-      def initialize(amount: nil, days_until_due: nil, description: nil, due_date: nil)
-        @amount = amount
-        @days_until_due = days_until_due
-        @description = description
-        @due_date = due_date
-      end
-    end
-
     class AutomaticTax < ::Stripe::RequestParams
       class Liability < ::Stripe::RequestParams
         # The connected account being referenced when `type` is `account`.
@@ -33,7 +15,7 @@ module Stripe
           @type = type
         end
       end
-      # Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices.
+      # Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices.
       attr_accessor :enabled
       # The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
       attr_accessor :liability
@@ -57,44 +39,16 @@ module Stripe
     end
 
     class Discount < ::Stripe::RequestParams
-      class DiscountEnd < ::Stripe::RequestParams
-        class Duration < ::Stripe::RequestParams
-          # Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-          attr_accessor :interval
-          # The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-          attr_accessor :interval_count
-
-          def initialize(interval: nil, interval_count: nil)
-            @interval = interval
-            @interval_count = interval_count
-          end
-        end
-        # Time span for the redeemed discount.
-        attr_accessor :duration
-        # A precise Unix timestamp for the discount to end. Must be in the future.
-        attr_accessor :timestamp
-        # The type of calculation made to determine when the discount ends.
-        attr_accessor :type
-
-        def initialize(duration: nil, timestamp: nil, type: nil)
-          @duration = duration
-          @timestamp = timestamp
-          @type = type
-        end
-      end
       # ID of the coupon to create a new discount for.
       attr_accessor :coupon
       # ID of an existing discount on the object (or one of its ancestors) to reuse.
       attr_accessor :discount
-      # Details to determine how long the discount should be applied for.
-      attr_accessor :discount_end
       # ID of the promotion code to create a new discount for.
       attr_accessor :promotion_code
 
-      def initialize(coupon: nil, discount: nil, discount_end: nil, promotion_code: nil)
+      def initialize(coupon: nil, discount: nil, promotion_code: nil)
         @coupon = coupon
         @discount = discount
-        @discount_end = discount_end
         @promotion_code = promotion_code
       end
     end
@@ -172,9 +126,9 @@ module Stripe
           end
           # Installment configuration for payments attempted on this invoice.
           #
-          # For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
+          # For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments).
           attr_accessor :installments
-          # We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
+          # We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
           attr_accessor :request_three_d_secure
 
           def initialize(installments: nil, request_three_d_secure: nil)
@@ -214,39 +168,21 @@ module Stripe
           end
         end
 
-        class IdBankTransfer < ::Stripe::RequestParams; end
         class Konbini < ::Stripe::RequestParams; end
 
-        class Pix < ::Stripe::RequestParams
-          # Determines if the amount includes the IOF tax. Defaults to `never`.
-          attr_accessor :amount_includes_iof
-
-          def initialize(amount_includes_iof: nil)
-            @amount_includes_iof = amount_includes_iof
-          end
-        end
-
-        class SepaDebit < ::Stripe::RequestParams; end
-
-        class Upi < ::Stripe::RequestParams
+        class Payto < ::Stripe::RequestParams
           class MandateOptions < ::Stripe::RequestParams
-            # Amount to be charged for future payments.
+            # The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
             attr_accessor :amount
-            # One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
-            attr_accessor :amount_type
-            # A description of the mandate or subscription that is meant to be displayed to the customer.
-            attr_accessor :description
-            # End date of the mandate or subscription. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
-            attr_accessor :end_date
-
-            def initialize(amount: nil, amount_type: nil, description: nil, end_date: nil)
+            # The purpose for which payments are made. Has a default value based on your merchant category code.
+            attr_accessor :purpose
+
+            def initialize(amount: nil, purpose: nil)
               @amount = amount
-              @amount_type = amount_type
-              @description = description
-              @end_date = end_date
+              @purpose = purpose
             end
           end
-          # Configuration options for setting up an eMandate
+          # Additional fields for Mandate creation.
           attr_accessor :mandate_options
 
           def initialize(mandate_options: nil)
@@ -254,17 +190,16 @@ module Stripe
           end
         end
 
+        class SepaDebit < ::Stripe::RequestParams; end
+
         class UsBankAccount < ::Stripe::RequestParams
           class FinancialConnections < ::Stripe::RequestParams
             class Filters < ::Stripe::RequestParams
               # The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
               attr_accessor :account_subcategories
-              # ID of the institution to use to filter for selectable accounts.
-              attr_accessor :institution
 
-              def initialize(account_subcategories: nil, institution: nil)
+              def initialize(account_subcategories: nil)
                 @account_subcategories = account_subcategories
-                @institution = institution
               end
             end
             # Provide filters for the linked accounts that the customer can select for the payment method.
@@ -298,16 +233,12 @@ module Stripe
         attr_accessor :card
         # If paying by `customer_balance`, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent.
         attr_accessor :customer_balance
-        # If paying by `id_bank_transfer`, this sub-hash contains details about the Indonesia bank transfer payment method options to pass to the invoice’s PaymentIntent.
-        attr_accessor :id_bank_transfer
         # If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice’s PaymentIntent.
         attr_accessor :konbini
-        # If paying by `pix`, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent.
-        attr_accessor :pix
+        # If paying by `payto`, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent.
+        attr_accessor :payto
         # If paying by `sepa_debit`, this sub-hash contains details about the SEPA Direct Debit payment method options to pass to the invoice’s PaymentIntent.
         attr_accessor :sepa_debit
-        # If paying by `upi`, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent.
-        attr_accessor :upi
         # If paying by `us_bank_account`, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
         attr_accessor :us_bank_account
 
@@ -316,22 +247,18 @@ module Stripe
           bancontact: nil,
           card: nil,
           customer_balance: nil,
-          id_bank_transfer: nil,
           konbini: nil,
-          pix: nil,
+          payto: nil,
           sepa_debit: nil,
-          upi: nil,
           us_bank_account: nil
         )
           @acss_debit = acss_debit
           @bancontact = bancontact
           @card = card
           @customer_balance = customer_balance
-          @id_bank_transfer = id_bank_transfer
           @konbini = konbini
-          @pix = pix
+          @payto = payto
           @sepa_debit = sepa_debit
-          @upi = upi
           @us_bank_account = us_bank_account
         end
       end
@@ -445,11 +372,11 @@ module Stripe
         attr_accessor :display_name
         # Describes a fixed amount to charge for shipping. Must be present if type is `fixed_amount`.
         attr_accessor :fixed_amount
-        # 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
         # Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
         attr_accessor :tax_behavior
-        # A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
+        # A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
         attr_accessor :tax_code
         # The type of calculation to use on the shipping rate.
         attr_accessor :type
@@ -495,7 +422,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(
@@ -541,11 +468,9 @@ module Stripe
     end
     # The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
     attr_accessor :account_tax_ids
-    # List of expected payments and corresponding due dates. Valid only for invoices where `collection_method=send_invoice`.
-    attr_accessor :amounts_due
-    # A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees [documentation](https://stripe.com/docs/billing/invoices/connect#collecting-fees).
+    # A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees [documentation](https://docs.stripe.com/billing/invoices/connect#collecting-fees).
     attr_accessor :application_fee_amount
-    # Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice.
+    # Controls whether Stripe performs [automatic collection](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection) of the invoice.
     attr_accessor :auto_advance
     # Settings for automatic tax lookup for this invoice.
     attr_accessor :automatic_tax
@@ -557,8 +482,6 @@ module Stripe
     attr_accessor :custom_fields
     # The number of days from which the invoice is created until it is due. Only valid for invoices where `collection_method=send_invoice`. This field can only be updated on `draft` invoices.
     attr_accessor :days_until_due
-    # The ids of the margins to apply to the invoice. Can be overridden by line item `margins`.
-    attr_accessor :default_margins
     # ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
     attr_accessor :default_payment_method
     # ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
@@ -579,11 +502,11 @@ module Stripe
     attr_accessor :footer
     # The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
     attr_accessor :issuer
-    # 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
     # Set the number for this invoice. If no number is present then a number will be assigned automatically when the invoice is finalized. In many markets, regulations require invoices to be unique, sequential and / or gapless. You are responsible for ensuring this is true across all your different invoicing systems in the event that you edit the invoice number using our API. If you use only Stripe for your invoices and do not change invoice numbers, Stripe handles this aspect of compliance for you automatically.
     attr_accessor :number
-    # The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the [Invoices with Connect](https://stripe.com/docs/billing/invoices/connect) documentation for details.
+    # The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the [Invoices with Connect](https://docs.stripe.com/billing/invoices/connect) documentation for details.
     attr_accessor :on_behalf_of
     # Configuration settings for the PaymentIntent that is generated when the invoice is finalized.
     attr_accessor :payment_settings
@@ -600,7 +523,6 @@ module Stripe
 
     def initialize(
       account_tax_ids: nil,
-      amounts_due: nil,
       application_fee_amount: nil,
       auto_advance: nil,
       automatic_tax: nil,
@@ -608,7 +530,6 @@ module Stripe
       collection_method: nil,
       custom_fields: nil,
       days_until_due: nil,
-      default_margins: nil,
       default_payment_method: nil,
       default_source: nil,
       default_tax_rates: nil,
@@ -630,7 +551,6 @@ module Stripe
       transfer_data: nil
     )
       @account_tax_ids = account_tax_ids
-      @amounts_due = amounts_due
       @application_fee_amount = application_fee_amount
       @auto_advance = auto_advance
       @automatic_tax = automatic_tax
@@ -638,7 +558,6 @@ module Stripe
       @collection_method = collection_method
       @custom_fields = custom_fields
       @days_until_due = days_until_due
-      @default_margins = default_margins
       @default_payment_method = default_payment_method
       @default_source = default_source
       @default_tax_rates = default_tax_rates

data/lib/stripe/params/issuing/authorization_approve_params.rb

@@ -4,11 +4,11 @@
 module Stripe
   module Issuing
     class AuthorizationApproveParams < ::Stripe::RequestParams
-      # If the authorization's `pending_request.is_amount_controllable` property is `true`, you may provide this value to control how much to hold for the authorization. Must be positive (use [`decline`](https://stripe.com/docs/api/issuing/authorizations/decline) to decline an authorization request).
+      # If the authorization's `pending_request.is_amount_controllable` property is `true`, you may provide this value to control how much to hold for the authorization. Must be positive (use [`decline`](https://docs.stripe.com/api/issuing/authorizations/decline) to decline an authorization request).
       attr_accessor :amount
       # 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, expand: nil, metadata: nil)

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

@@ -240,7 +240,7 @@ module Stripe
           @reference = reference
         end
       end
-      # The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_accessor :capture_amount
       # Whether to close the authorization after capture. Defaults to true. Set to false to enable multi-capture flows.
       attr_accessor :close_authorization

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

@@ -137,7 +137,7 @@ module Stripe
       end
 
       class MerchantData < ::Stripe::RequestParams
-        # A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values.
+        # A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values.
         attr_accessor :category
         # City where the seller is located
         attr_accessor :city
@@ -295,9 +295,9 @@ module Stripe
           @three_d_secure = three_d_secure
         end
       end
-      # The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_accessor :amount
-      # Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_accessor :amount_details
       # How the card details were provided. Defaults to online.
       attr_accessor :authorization_method
@@ -313,9 +313,9 @@ module Stripe
       attr_accessor :fraud_disputability_likelihood
       # Information about fuel that was purchased with this transaction.
       attr_accessor :fuel
-      # If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization.
+      # If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization.
       attr_accessor :is_amount_controllable
-      # The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_accessor :merchant_amount
       # The currency of the authorization. If not provided, defaults to the currency of the card. 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 :merchant_currency

data/lib/stripe/params/issuing/authorization_decline_params.rb

@@ -6,7 +6,7 @@ module Stripe
     class AuthorizationDeclineParams < ::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
 
       def initialize(expand: nil, metadata: nil)

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

@@ -125,7 +125,7 @@ module Stripe
       end
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
-      # The final authorization amount that will be captured by the merchant. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The final authorization amount that will be captured by the merchant. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_accessor :final_amount
       # Fleet-specific information for authorizations using Fleet cards.
       attr_accessor :fleet

data/lib/stripe/params/issuing/authorization_increment_params.rb

@@ -6,9 +6,9 @@ module Stripe
     class AuthorizationIncrementParams < ::Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
-      # The amount to increment the authorization by. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The amount to increment the authorization by. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_accessor :increment_amount
-      # If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization.
+      # If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization.
       attr_accessor :is_amount_controllable
 
       def initialize(expand: nil, increment_amount: nil, is_amount_controllable: nil)

data/lib/stripe/params/issuing/authorization_reverse_params.rb

@@ -6,7 +6,7 @@ module Stripe
     class AuthorizationReverseParams < ::Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
-      # The amount to reverse from the authorization. If not provided, the full amount of the authorization will be reversed. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The amount to reverse from the authorization. If not provided, the full amount of the authorization will be reversed. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_accessor :reverse_amount
 
       def initialize(expand: nil, reverse_amount: nil)

data/lib/stripe/params/issuing/authorization_update_params.rb

@@ -6,7 +6,7 @@ module Stripe
     class AuthorizationUpdateParams < ::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
 
       def initialize(expand: nil, metadata: nil)

data/lib/stripe/params/issuing/card_create_params.rb

@@ -25,7 +25,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(
@@ -104,7 +104,7 @@ module Stripe
         class SpendingLimit < ::Stripe::RequestParams
           # Maximum amount allowed to spend per interval.
           attr_accessor :amount
-          # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
+          # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
           attr_accessor :categories
           # Interval (or event) to which the amount applies.
           attr_accessor :interval
@@ -115,11 +115,11 @@ module Stripe
             @interval = interval
           end
         end
-        # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
         attr_accessor :allowed_categories
         # Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `blocked_merchant_countries`. Provide an empty value to unset this control.
         attr_accessor :allowed_merchant_countries
-        # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
         attr_accessor :blocked_categories
         # Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `allowed_merchant_countries`. Provide an empty value to unset this control.
         attr_accessor :blocked_merchant_countries
@@ -140,7 +140,7 @@ module Stripe
           @spending_limits = spending_limits
         end
       end
-      # The [Cardholder](https://stripe.com/docs/api#issuing_cardholder_object) object with which the card will be associated.
+      # The [Cardholder](https://docs.stripe.com/api#issuing_cardholder_object) object with which the card will be associated.
       attr_accessor :cardholder
       # The currency for the card.
       attr_accessor :currency
@@ -152,7 +152,7 @@ module Stripe
       attr_accessor :expand
       # The new financial account ID the card will be associated with. This field allows a card to be reassigned to a different financial account.
       attr_accessor :financial_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
       # The personalization design object belonging to this card.
       attr_accessor :personalization_design
@@ -166,7 +166,7 @@ module Stripe
       attr_accessor :second_line
       # The address where the card will be shipped.
       attr_accessor :shipping
-      # Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
+      # Rules that control spending for this card. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details.
       attr_accessor :spending_controls
       # Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`.
       attr_accessor :status

data/lib/stripe/params/issuing/card_update_params.rb

@@ -25,7 +25,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(
@@ -104,7 +104,7 @@ module Stripe
         class SpendingLimit < ::Stripe::RequestParams
           # Maximum amount allowed to spend per interval.
           attr_accessor :amount
-          # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
+          # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
           attr_accessor :categories
           # Interval (or event) to which the amount applies.
           attr_accessor :interval
@@ -115,11 +115,11 @@ module Stripe
             @interval = interval
           end
         end
-        # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
         attr_accessor :allowed_categories
         # Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `blocked_merchant_countries`. Provide an empty value to unset this control.
         attr_accessor :allowed_merchant_countries
-        # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
         attr_accessor :blocked_categories
         # Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `allowed_merchant_countries`. Provide an empty value to unset this control.
         attr_accessor :blocked_merchant_countries
@@ -144,7 +144,7 @@ module Stripe
       attr_accessor :cancellation_reason
       # 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
       # Attribute for param field personalization_design
       attr_accessor :personalization_design
@@ -152,7 +152,7 @@ module Stripe
       attr_accessor :pin
       # Updated shipping information for the card.
       attr_accessor :shipping
-      # Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
+      # Rules that control spending for this card. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details.
       attr_accessor :spending_controls
       # Dictates whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`. If this card is being canceled because it was lost or stolen, this information should be provided as `cancellation_reason`.
       attr_accessor :status

data/lib/stripe/params/issuing/cardholder_create_params.rb

@@ -16,7 +16,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(
@@ -93,9 +93,9 @@ module Stripe
 
         class Verification < ::Stripe::RequestParams
           class Document < ::Stripe::RequestParams
-            # The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`.
+            # The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`.
             attr_accessor :back
-            # The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`.
+            # The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`.
             attr_accessor :front
 
             def initialize(back: nil, front: nil)
@@ -140,7 +140,7 @@ module Stripe
         class SpendingLimit < ::Stripe::RequestParams
           # Maximum amount allowed to spend per interval.
           attr_accessor :amount
-          # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
+          # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
           attr_accessor :categories
           # Interval (or event) to which the amount applies.
           attr_accessor :interval
@@ -151,11 +151,11 @@ module Stripe
             @interval = interval
           end
         end
-        # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
         attr_accessor :allowed_categories
         # Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `blocked_merchant_countries`. Provide an empty value to unset this control.
         attr_accessor :allowed_merchant_countries
-        # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
         attr_accessor :blocked_categories
         # Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `allowed_merchant_countries`. Provide an empty value to unset this control.
         attr_accessor :blocked_merchant_countries
@@ -190,21 +190,20 @@ module Stripe
       attr_accessor :expand
       # Additional information about an `individual` cardholder.
       attr_accessor :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. 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 cardholder's name. This will be printed on cards issued to them. The maximum length of this field is 24 characters. This field cannot contain any special characters or numbers.
       attr_accessor :name
-      # The cardholder's phone number. This will be transformed to [E.164](https://en.wikipedia.org/wiki/E.164) if it is not provided in that format already. This is required for all cardholders who will be creating EU cards.
-      #  While phone number is optional if the cardholder will not be creating EU cards, note that this cardholder will not be eligible for 3DS without a phone number. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure#when-is-3d-secure-applied) for more details.
+      # The cardholder's phone number. This will be transformed to [E.164](https://en.wikipedia.org/wiki/E.164) if it is not provided in that format already. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://docs.stripe.com/issuing/3d-secure#when-is-3d-secure-applied) for more details.
       attr_accessor :phone_number
       # The cardholder’s preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`.
-      #  This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder.
+      #  This changes the language of the [3D Secure flow](https://docs.stripe.com/issuing/3d-secure) and one-time password messages sent to the cardholder.
       attr_accessor :preferred_locales
-      # Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
+      # Rules that control spending across this cardholder's cards. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details.
       attr_accessor :spending_controls
       # Specifies whether to permit authorizations on this cardholder's cards. Defaults to `active`.
       attr_accessor :status
-      # One of `individual` or `company`. See [Choose a cardholder type](https://stripe.com/docs/issuing/other/choose-cardholder) for more details.
+      # One of `individual` or `company`. See [Choose a cardholder type](https://docs.stripe.com/issuing/other/choose-cardholder) for more details.
       attr_accessor :type
 
       def initialize(