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

data/lib/stripe/resources/invoice_line_item.rb

@@ -2,9 +2,9 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Invoice Line Items represent the individual lines within an [invoice](https://stripe.com/docs/api/invoices) and only exist within the context of an invoice.
+  # Invoice Line Items represent the individual lines within an [invoice](https://docs.stripe.com/api/invoices) and only exist within the context of an invoice.
   #
-  # Each line item is backed by either an [invoice item](https://stripe.com/docs/api/invoiceitems) or a [subscription item](https://stripe.com/docs/api/subscription_items).
+  # Each line item is backed by either an [invoice item](https://docs.stripe.com/api/invoiceitems) or a [subscription item](https://docs.stripe.com/api/subscription_items).
   class InvoiceLineItem < APIResource
     include Stripe::APIOperations::Save
 
@@ -89,6 +89,61 @@ module Stripe
         end
       end
 
+      class LicenseFeeSubscriptionDetails < ::Stripe::StripeObject
+        # The invoice item that generated this line item
+        attr_reader :invoice_item
+        # The license fee subscription that generated this line item
+        attr_reader :license_fee_subscription
+        # The license fee version at the time this line item was generated
+        attr_reader :license_fee_version
+        # The pricing plan subscription that manages the license fee subscription
+        attr_reader :pricing_plan_subscription
+        # The pricing plan version at the time this line item was generated
+        attr_reader :pricing_plan_version
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class RateCardSubscriptionDetails < ::Stripe::StripeObject
+        # The invoice item that generated this line item
+        attr_reader :invoice_item
+        # The pricing plan subscription that manages the rate card subscription
+        attr_reader :pricing_plan_subscription
+        # The pricing plan version at the time this line item was generated
+        attr_reader :pricing_plan_version
+        # The rate card subscription that generated this line item
+        attr_reader :rate_card_subscription
+        # The rate card version at the time this line item was generated
+        attr_reader :rate_card_version
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class ScheduleDetails < ::Stripe::StripeObject
+        # The subscription schedule that generated this line item
+        attr_reader :schedule
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class SubscriptionItemDetails < ::Stripe::StripeObject
         class ProrationDetails < ::Stripe::StripeObject
           class CreditedItems < ::Stripe::StripeObject
@@ -137,6 +192,12 @@ module Stripe
       end
       # Details about the invoice item that generated this line item
       attr_reader :invoice_item_details
+      # Details about the license fee subscription that generated this line item
+      attr_reader :license_fee_subscription_details
+      # Details about the rate card subscription that generated this line item
+      attr_reader :rate_card_subscription_details
+      # Details about the subscription schedule that generated this line item
+      attr_reader :schedule_details
       # Details about the subscription item that generated this line item
       attr_reader :subscription_item_details
       # The type of parent that generated this line item
@@ -145,6 +206,9 @@ module Stripe
       def self.inner_class_types
         @inner_class_types = {
           invoice_item_details: InvoiceItemDetails,
+          license_fee_subscription_details: LicenseFeeSubscriptionDetails,
+          rate_card_subscription_details: RateCardSubscriptionDetails,
+          schedule_details: ScheduleDetails,
           subscription_item_details: SubscriptionItemDetails,
         }
       end
@@ -191,6 +255,23 @@ module Stripe
     end
 
     class Pricing < ::Stripe::StripeObject
+      class LicenseFeeDetails < ::Stripe::StripeObject
+        # The ID of the license fee this item is associated with
+        attr_reader :license_fee
+        # The version of the license fee this item is associated with
+        attr_reader :license_fee_version
+        # The ID of the licensed item this item is associated with
+        attr_reader :licensed_item
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class PriceDetails < ::Stripe::StripeObject
         # The ID of the price this item is associated with.
         attr_reader :price
@@ -205,15 +286,40 @@ module Stripe
           @field_remappings = {}
         end
       end
+
+      class RateCardRateDetails < ::Stripe::StripeObject
+        # The ID of billable item this item is associated with
+        attr_reader :metered_item
+        # The ID of the rate card this item is associated with
+        attr_reader :rate_card
+        # The ID of the rate card rate this item is associated with
+        attr_reader :rate_card_rate
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Attribute for field license_fee_details
+      attr_reader :license_fee_details
       # Attribute for field price_details
       attr_reader :price_details
+      # Attribute for field rate_card_rate_details
+      attr_reader :rate_card_rate_details
       # The type of the pricing details.
       attr_reader :type
       # The unit amount (in the `currency` specified) of the item which contains a decimal value with at most 12 decimal places.
       attr_reader :unit_amount_decimal
 
       def self.inner_class_types
-        @inner_class_types = { price_details: PriceDetails }
+        @inner_class_types = {
+          license_fee_details: LicenseFeeDetails,
+          price_details: PriceDetails,
+          rate_card_rate_details: RateCardRateDetails,
+        }
       end
 
       def self.field_remappings
@@ -238,7 +344,7 @@ module Stripe
 
     class Tax < ::Stripe::StripeObject
       class TaxRateDetails < ::Stripe::StripeObject
-        # Attribute for field tax_rate
+        # ID of the tax rate
         attr_reader :tax_rate
 
         def self.inner_class_types
@@ -292,7 +398,7 @@ module Stripe
     attr_reader :margin_amounts
     # The margins applied to the line item. When set, the `default_margins` on the invoice do not apply to the line item. Use `expand[]=margins` to expand each margin.
     attr_reader :margins
-    # 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. Note that for line items with `type=subscription`, `metadata` reflects the current metadata from the subscription associated with the line item, unless the invoice line was directly updated with different metadata after creation.
+    # 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. Note that for line items with `type=subscription`, `metadata` reflects the current metadata from the subscription associated with the line item, unless the invoice line was directly updated with different metadata after creation.
     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/invoice_payment.rb

@@ -4,7 +4,7 @@
 module Stripe
   # Invoice Payments represent payments made against invoices. Invoice Payments can
   # be accessed in two ways:
-  # 1. By expanding the `payments` field on the [Invoice](https://stripe.com/docs/api#invoice) resource.
+  # 1. By expanding the `payments` field on the [Invoice](https://api.stripe.com#invoice) resource.
   # 2. By using the Invoice Payment retrieve and list endpoints.
   #
   # Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices.

data/lib/stripe/resources/invoice_rendering_template.rb

@@ -18,7 +18,7 @@ module Stripe
     attr_reader :id
     # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
     attr_reader :livemode
-    # 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
     # A brief description of the template, hidden from customers
     attr_reader :nickname

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

@@ -3,11 +3,11 @@
 
 module Stripe
   module Issuing
-    # When an [issued card](https://stripe.com/docs/issuing) is used to make a purchase, an Issuing `Authorization`
-    # object is created. [Authorizations](https://stripe.com/docs/issuing/purchases/authorizations) must be approved for the
+    # When an [issued card](https://docs.stripe.com/issuing) is used to make a purchase, an Issuing `Authorization`
+    # object is created. [Authorizations](https://docs.stripe.com/issuing/purchases/authorizations) must be approved for the
     # purchase to be completed successfully.
     #
-    # Related guide: [Issued card authorizations](https://stripe.com/docs/issuing/purchases/authorizations)
+    # Related guide: [Issued card authorizations](https://docs.stripe.com/issuing/purchases/authorizations)
     class Authorization < APIResource
       extend Gem::Deprecate
       extend Stripe::APIOperations::List
@@ -173,7 +173,7 @@ module Stripe
       end
 
       class MerchantData < ::Stripe::StripeObject
-        # 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_reader :category
         # The merchant category code for the seller’s business
         attr_reader :category_code
@@ -237,15 +237,15 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The additional amount Stripe will hold if the authorization is approved, in the card's [currency](https://stripe.com/docs/api#issuing_authorization_object-pending-request-currency) and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The additional amount Stripe will hold if the authorization is approved, in the card's [currency](https://docs.stripe.com/api#issuing_authorization_object-pending-request-currency) and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :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_reader :amount_details
         # 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_reader :currency
-        # 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_reader :is_amount_controllable
-        # The amount the merchant is requesting to be authorized in the `merchant_currency`. The amount is in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount the merchant is requesting to be authorized in the `merchant_currency`. The amount is in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :merchant_amount
         # The local currency the merchant is requesting to authorize.
         attr_reader :merchant_currency
@@ -276,9 +276,9 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The `pending_request.amount` at the time of the request, presented in your card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Stripe held this amount from your account to fund the authorization if the request was approved.
+        # The `pending_request.amount` at the time of the request, presented in your card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Stripe held this amount from your account to fund the authorization if the request was approved.
         attr_reader :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_reader :amount_details
         # Whether this request was approved.
         attr_reader :approved
@@ -288,7 +288,7 @@ module Stripe
         attr_reader :created
         # 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_reader :currency
-        # The `pending_request.merchant_amount` at the time of the request, presented in the `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The `pending_request.merchant_amount` at the time of the request, presented in the `merchant_currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :merchant_amount
         # The currency that was collected by the merchant and presented to the cardholder for the authorization. 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_reader :merchant_currency
@@ -311,11 +311,11 @@ module Stripe
       end
 
       class Treasury < ::Stripe::StripeObject
-        # The array of [ReceivedCredits](https://stripe.com/docs/api/treasury/received_credits) associated with this authorization
+        # The array of [ReceivedCredits](https://docs.stripe.com/api/treasury/received_credits) associated with this authorization
         attr_reader :received_credits
-        # The array of [ReceivedDebits](https://stripe.com/docs/api/treasury/received_debits) associated with this authorization
+        # The array of [ReceivedDebits](https://docs.stripe.com/api/treasury/received_debits) associated with this authorization
         attr_reader :received_debits
-        # The Treasury [Transaction](https://stripe.com/docs/api/treasury/transactions) associated with this authorization
+        # The Treasury [Transaction](https://docs.stripe.com/api/treasury/transactions) associated with this authorization
         attr_reader :transaction
 
         def self.inner_class_types
@@ -383,7 +383,7 @@ module Stripe
       end
       # The total amount that was authorized or rejected. This amount is in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). `amount` should be the same as `merchant_amount`, unless `currency` and `merchant_currency` are different.
       attr_reader :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_reader :amount_details
       # Whether the authorization has been approved.
       attr_reader :approved
@@ -391,7 +391,7 @@ module Stripe
       attr_reader :authorization_method
       # List of balance transactions associated with this authorization.
       attr_reader :balance_transactions
-      # You can [create physical or virtual cards](https://stripe.com/docs/issuing) that are issued to cardholders.
+      # You can [create physical or virtual cards](https://docs.stripe.com/issuing) that are issued to cardholders.
       attr_reader :card
       # The cardholder to whom this authorization belongs.
       attr_reader :cardholder
@@ -415,7 +415,7 @@ module Stripe
       attr_reader :merchant_currency
       # Attribute for field merchant_data
       attr_reader :merchant_data
-      # 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
       # Details about the authorization, such as identifiers, set by the card network.
       attr_reader :network_data
@@ -427,11 +427,11 @@ module Stripe
       attr_reader :request_history
       # The current status of the authorization in its lifecycle.
       attr_reader :status
-      # [Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this authorization. If a network token was not used for this authorization, this field will be null.
+      # [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this authorization. If a network token was not used for this authorization, this field will be null.
       attr_reader :token
-      # List of [transactions](https://stripe.com/docs/api/issuing/transactions) associated with this authorization.
+      # List of [transactions](https://docs.stripe.com/api/issuing/transactions) associated with this authorization.
       attr_reader :transactions
-      # [Treasury](https://stripe.com/docs/api/treasury) details related to this authorization if it was created on a [FinancialAccount](https://stripe.com/docs/api/treasury/financial_accounts).
+      # [Treasury](https://docs.stripe.com/api/treasury) details related to this authorization if it was created on a [FinancialAccount](https://docs.stripe.com/api/treasury/financial_accounts).
       attr_reader :treasury
       # Attribute for field verification_data
       attr_reader :verification_data

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

@@ -3,7 +3,7 @@
 
 module Stripe
   module Issuing
-    # You can [create physical or virtual cards](https://stripe.com/docs/issuing) that are issued to cardholders.
+    # You can [create physical or virtual cards](https://docs.stripe.com/issuing) that are issued to cardholders.
     class Card < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
@@ -41,7 +41,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
@@ -65,7 +65,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
@@ -146,9 +146,9 @@ module Stripe
 
       class SpendingControls < ::Stripe::StripeObject
         class SpendingLimit < ::Stripe::StripeObject
-          # Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
           attr_reader :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_reader :categories
           # Interval (or event) to which the amount applies.
           attr_reader :interval
@@ -161,11 +161,11 @@ module Stripe
             @field_remappings = {}
           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_reader :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_reader :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_reader :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_reader :blocked_merchant_countries
@@ -189,6 +189,8 @@ module Stripe
           attr_reader :eligible
           # Reason the card is ineligible for Apple Pay
           attr_reader :ineligible_reason
+          # Unique identifier for the card in Apple Pay
+          attr_reader :primary_account_identifier
 
           def self.inner_class_types
             @inner_class_types = {}
@@ -204,6 +206,8 @@ module Stripe
           attr_reader :eligible
           # Reason the card is ineligible for Google Pay
           attr_reader :ineligible_reason
+          # Unique identifier for the card in Google Pay
+          attr_reader :primary_account_identifier
 
           def self.inner_class_types
             @inner_class_types = {}
@@ -232,15 +236,15 @@ module Stripe
       attr_reader :brand
       # The reason why the card was canceled.
       attr_reader :cancellation_reason
-      # An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards.
+      # An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://docs.stripe.com/issuing) cards.
       #
-      # Related guide: [How to create a cardholder](https://stripe.com/docs/issuing/cards/virtual/issue-cards#create-cardholder)
+      # Related guide: [How to create a cardholder](https://docs.stripe.com/issuing/cards/virtual/issue-cards#create-cardholder)
       attr_reader :cardholder
       # Time at which the object was created. Measured in seconds since the Unix epoch.
       attr_reader :created
       # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Supported currencies are `usd` in the US, `eur` in the EU, and `gbp` in the UK.
       attr_reader :currency
-      # The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.
+      # The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://docs.stripe.com/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.
       attr_reader :cvc
       # The expiration month of the card.
       attr_reader :exp_month
@@ -256,9 +260,9 @@ module Stripe
       attr_reader :latest_fraud_warning
       # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
       attr_reader :livemode
-      # 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
-      # The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.
+      # The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://docs.stripe.com/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.
       attr_reader :number
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object

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

@@ -3,9 +3,9 @@
 
 module Stripe
   module Issuing
-    # An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards.
+    # An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://docs.stripe.com/issuing) cards.
     #
-    # Related guide: [How to create a cardholder](https://stripe.com/docs/issuing/cards/virtual/issue-cards#create-cardholder)
+    # Related guide: [How to create a cardholder](https://docs.stripe.com/issuing/cards/virtual/issue-cards#create-cardholder)
     class Cardholder < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
@@ -28,7 +28,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
@@ -113,9 +113,9 @@ 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 `identity_document`.
+            # The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`.
             attr_reader :back
-            # The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`.
+            # The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`.
             attr_reader :front
 
             def self.inner_class_types
@@ -174,9 +174,9 @@ module Stripe
 
       class SpendingControls < ::Stripe::StripeObject
         class SpendingLimit < ::Stripe::StripeObject
-          # Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
           attr_reader :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_reader :categories
           # Interval (or event) to which the amount applies.
           attr_reader :interval
@@ -189,11 +189,11 @@ module Stripe
             @field_remappings = {}
           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_reader :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_reader :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_reader :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_reader :blocked_merchant_countries
@@ -224,24 +224,24 @@ module Stripe
       attr_reader :individual
       # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
       attr_reader :livemode
-      # 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
       # The cardholder's name. This will be printed on cards issued to them.
       attr_reader :name
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
-      # The cardholder's phone number. This is required for all cardholders who will be creating EU cards. 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 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_reader :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_reader :preferred_locales
       # Attribute for field requirements
       attr_reader :requirements
-      # 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_reader :spending_controls
       # Specifies whether to permit authorizations on this cardholder's cards.
       attr_reader :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_reader :type
 
       # Creates a new Issuing Cardholder object that can be issued cards.

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

@@ -5,7 +5,7 @@ module Stripe
   module Issuing
     # Every time an applicant submits an application for a Charge Card product your platform offers, or every time your platform takes a proactive credit decision on an existing account, you must record the decision by creating a new `CreditUnderwritingRecord` object on a connected account.
     #
-    # [Follow the guide](https://stripe.com/docs/issuing/credit/report-credit-decisions-and-manage-aans) to learn about your requirements as a platform.
+    # [Follow the guide](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans) to learn about your requirements as a platform.
     class CreditUnderwritingRecord < APIResource
       extend Stripe::APIOperations::List
 
@@ -63,7 +63,7 @@ module Stripe
         end
 
         class CreditLimitApproved < ::Stripe::StripeObject
-          # Credit amount approved. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy).
+          # Credit amount approved. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://docs.stripe.com/api/issuing/credit_policy).
           attr_reader :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_reader :currency
@@ -78,7 +78,7 @@ module Stripe
         end
 
         class CreditLimitDecreased < ::Stripe::StripeObject
-          # Credit amount approved after decrease. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy).
+          # Credit amount approved after decrease. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://docs.stripe.com/api/issuing/credit_policy).
           attr_reader :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_reader :currency
@@ -167,11 +167,11 @@ module Stripe
       attr_reader :id
       # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
       attr_reader :livemode
-      # 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
-      # File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://stripe.com/docs/issuing/credit/report-required-regulatory-data-for-credit-decisions).
+      # File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://docs.stripe.com/issuing/credit/report-required-regulatory-data-for-credit-decisions).
       attr_reader :regulatory_reporting_file
       # If an exception to the usual underwriting criteria was made for this application, details about the exception must be provided. Exceptions should only be granted in rare circumstances, in consultation with Stripe Compliance.
       attr_reader :underwriting_exception

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

@@ -3,9 +3,9 @@
 
 module Stripe
   module Issuing
-    # As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with.
+    # As a [card issuer](https://docs.stripe.com/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with.
     #
-    # Related guide: [Issuing disputes](https://stripe.com/docs/issuing/purchases/disputes)
+    # Related guide: [Issuing disputes](https://docs.stripe.com/issuing/purchases/disputes)
     class Dispute < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
@@ -222,9 +222,9 @@ module Stripe
       end
 
       class Treasury < ::Stripe::StripeObject
-        # The Treasury [DebitReversal](https://stripe.com/docs/api/treasury/debit_reversals) representing this Issuing dispute
+        # The Treasury [DebitReversal](https://docs.stripe.com/api/treasury/debit_reversals) representing this Issuing dispute
         attr_reader :debit_reversal
-        # The Treasury [ReceivedDebit](https://stripe.com/docs/api/treasury/received_debits) that is being disputed.
+        # The Treasury [ReceivedDebit](https://docs.stripe.com/api/treasury/received_debits) that is being disputed.
         attr_reader :received_debit
 
         def self.inner_class_types
@@ -235,7 +235,7 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # Disputed amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).
+      # Disputed amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).
       attr_reader :amount
       # List of balance transactions associated with the dispute.
       attr_reader :balance_transactions
@@ -251,7 +251,7 @@ module Stripe
       attr_reader :livemode
       # The enum that describes the dispute loss outcome. If the dispute is not lost, this field will be absent. New enum values may be added in the future, so be sure to handle unknown values.
       attr_reader :loss_reason
-      # 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
@@ -259,7 +259,7 @@ module Stripe
       attr_reader :status
       # The transaction being disputed.
       attr_reader :transaction
-      # [Treasury](https://stripe.com/docs/api/treasury) details related to this dispute if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts
+      # [Treasury](https://docs.stripe.com/api/treasury) details related to this dispute if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts
       attr_reader :treasury
 
       # Creates an Issuing Dispute object. Individual pieces of evidence within the evidence object are optional at this point. Stripe only validates that required evidence is present during submission. Refer to [Dispute reasons and evidence](https://docs.stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence) for more details about evidence requirements.

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

@@ -14,7 +14,7 @@ module Stripe
 
       # Debited amount. This is equal to the disputed amount and is given in the card’s currency and in the smallest currency unit.
       attr_reader :amount
-      # ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this debit.
+      # ID of the [balance transaction](https://docs.stripe.com/api/balance_transactions) associated with this debit.
       attr_reader :balance_transaction
       # Time at which the object was created. Measured in seconds since the Unix epoch.
       attr_reader :created

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

@@ -74,7 +74,7 @@ module Stripe
       attr_reader :livemode
       # A lookup key used to retrieve personalization designs dynamically from a static string. This may be up to 200 characters.
       attr_reader :lookup_key
-      # 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
       # Friendly display name.
       attr_reader :name