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

data/lib/stripe/resources/customer.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  # This object represents a customer of your business. Use it to [create recurring charges](https://stripe.com/docs/invoicing/customer), [save payment](https://stripe.com/docs/payments/save-during-payment) and contact information,
+  # This object represents a customer of your business. Use it to [create recurring charges](https://docs.stripe.com/invoicing/customer), [save payment](https://docs.stripe.com/payments/save-during-payment) and contact information,
   # and track payments that belong to the same customer.
   class Customer < APIResource
     extend Stripe::APIOperations::Create
@@ -33,7 +33,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
@@ -105,7 +105,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
@@ -172,7 +172,7 @@ module Stripe
     end
     # The customer's address.
     attr_reader :address
-    # The current balance, if any, that's stored on the customer in their default currency. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that's added to their next invoice. The balance only considers amounts that Stripe hasn't successfully applied to any invoice. It doesn't reflect unpaid invoices. This balance is only taken into account after invoices finalize. For multi-currency balances, see [invoice_credit_balance](https://stripe.com/docs/api/customers/object#customer_object-invoice_credit_balance).
+    # The current balance, if any, that's stored on the customer in their default currency. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that's added to their next invoice. The balance only considers amounts that Stripe hasn't successfully applied to any invoice. It doesn't reflect unpaid invoices. This balance is only taken into account after invoices finalize. For multi-currency balances, see [invoice_credit_balance](https://docs.stripe.com/api/customers/object#customer_object-invoice_credit_balance).
     attr_reader :balance
     # The customer's business name.
     attr_reader :business_name
@@ -182,15 +182,15 @@ module Stripe
     attr_reader :created
     # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) the customer can be charged in for recurring billing purposes.
     attr_reader :currency
-    # Attribute for field customer_account
+    # The ID of an Account representing a customer. You can use this ID with any v1 API that accepts a customer_account parameter.
     attr_reader :customer_account
     # ID of the default payment source for the customer.
     #
-    # If you use payment methods created through the PaymentMethods API, see the [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) field instead.
+    # If you use payment methods created through the PaymentMethods API, see the [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) field instead.
     attr_reader :default_source
     # Tracks the most recent state change on any invoice belonging to the customer. Paying an invoice or marking it uncollectible via the API will set this field to false. An automatic payment failure or passing the `invoice.due_date` will set this field to `true`.
     #
-    # If an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.
+    # If an invoice becomes uncollectible by [dunning](https://docs.stripe.com/billing/automatic-collection), `delinquent` doesn't reset to `false`.
     #
     # If you care whether the customer has paid their most recent subscription invoice, use `subscription.status` instead. Paying or marking uncollectible any customer invoice regardless of whether it is the latest invoice for a subscription will always set this field to `false`.
     attr_reader :delinquent
@@ -212,7 +212,7 @@ module Stripe
     attr_reader :invoice_settings
     # 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 customer's full name or business name.
     attr_reader :name

data/lib/stripe/resources/customer_balance_transaction.rb

@@ -2,12 +2,12 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Each customer has a [Balance](https://stripe.com/docs/api/customers/object#customer_object-balance) value,
+  # Each customer has a [Balance](https://docs.stripe.com/api/customers/object#customer_object-balance) value,
   # which denotes a debit or credit that's automatically applied to their next invoice upon finalization.
-  # You may modify the value directly by using the [update customer API](https://stripe.com/docs/api/customers/update),
+  # You may modify the value directly by using the [update customer API](https://docs.stripe.com/api/customers/update),
   # or by creating a Customer Balance Transaction, which increments or decrements the customer's `balance` by the specified `amount`.
   #
-  # Related guide: [Customer balance](https://stripe.com/docs/billing/customer/balance)
+  # Related guide: [Customer balance](https://docs.stripe.com/billing/customer/balance)
   class CustomerBalanceTransaction < APIResource
     include Stripe::APIOperations::Save
 
@@ -28,7 +28,7 @@ module Stripe
     attr_reader :currency
     # The ID of the customer the transaction belongs to.
     attr_reader :customer
-    # Attribute for field customer_account
+    # The ID of an Account representing a customer that the transaction belongs to.
     attr_reader :customer_account
     # An arbitrary string attached to the object. Often useful for displaying to users.
     attr_reader :description
@@ -40,11 +40,11 @@ module Stripe
     attr_reader :invoice
     # 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
-    # Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_overpaid`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, `unapplied_from_invoice`, `checkout_session_subscription_payment`, or `checkout_session_subscription_payment_canceled`. See the [Customer Balance page](https://stripe.com/docs/billing/customer/balance#types) to learn more about transaction types.
+    # Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_overpaid`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, `unapplied_from_invoice`, `checkout_session_subscription_payment`, or `checkout_session_subscription_payment_canceled`. See the [Customer Balance page](https://docs.stripe.com/billing/customer/balance#types) to learn more about transaction types.
     attr_reader :type
 
     def resource_url

data/lib/stripe/resources/customer_cash_balance_transaction.rb

@@ -13,9 +13,9 @@ module Stripe
     end
 
     class AdjustedForOverdraft < ::Stripe::StripeObject
-      # The [Balance Transaction](https://stripe.com/docs/api/balance_transactions/object) that corresponds to funds taken out of your Stripe balance.
+      # The [Balance Transaction](https://docs.stripe.com/api/balance_transactions/object) that corresponds to funds taken out of your Stripe balance.
       attr_reader :balance_transaction
-      # The [Cash Balance Transaction](https://stripe.com/docs/api/cash_balance_transactions/object) that brought the customer balance negative, triggering the clawback of funds.
+      # The [Cash Balance Transaction](https://docs.stripe.com/api/cash_balance_transactions/object) that brought the customer balance negative, triggering the clawback of funds.
       attr_reader :linked_transaction
 
       def self.inner_class_types
@@ -28,7 +28,7 @@ module Stripe
     end
 
     class AppliedToPayment < ::Stripe::StripeObject
-      # The [Payment Intent](https://stripe.com/docs/api/payment_intents/object) that funds were applied to.
+      # The [Payment Intent](https://docs.stripe.com/api/payment_intents/object) that funds were applied to.
       attr_reader :payment_intent
 
       def self.inner_class_types
@@ -146,7 +146,7 @@ module Stripe
     end
 
     class RefundedFromPayment < ::Stripe::StripeObject
-      # The [Refund](https://stripe.com/docs/api/refunds/object) that moved these funds into the customer's cash balance.
+      # The [Refund](https://docs.stripe.com/api/refunds/object) that moved these funds into the customer's cash balance.
       attr_reader :refund
 
       def self.inner_class_types
@@ -159,7 +159,7 @@ module Stripe
     end
 
     class TransferredToBalance < ::Stripe::StripeObject
-      # The [Balance Transaction](https://stripe.com/docs/api/balance_transactions/object) that corresponds to funds transferred to your Stripe balance.
+      # The [Balance Transaction](https://docs.stripe.com/api/balance_transactions/object) that corresponds to funds transferred to your Stripe balance.
       attr_reader :balance_transaction
 
       def self.inner_class_types
@@ -172,7 +172,7 @@ module Stripe
     end
 
     class UnappliedFromPayment < ::Stripe::StripeObject
-      # The [Payment Intent](https://stripe.com/docs/api/payment_intents/object) that funds were unapplied from.
+      # The [Payment Intent](https://docs.stripe.com/api/payment_intents/object) that funds were unapplied from.
       attr_reader :payment_intent
 
       def self.inner_class_types
@@ -193,9 +193,9 @@ module Stripe
     attr_reader :currency
     # The customer whose available cash balance changed as a result of this transaction.
     attr_reader :customer
-    # Attribute for field customer_account
+    # The ID of an Account representing a customer whose available cash balance changed as a result of this transaction.
     attr_reader :customer_account
-    # The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+    # The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
     attr_reader :ending_balance
     # Attribute for field funded
     attr_reader :funded
@@ -203,7 +203,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
-    # The amount by which the cash balance changed, represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance.
+    # The amount by which the cash balance changed, represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance.
     attr_reader :net_amount
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
@@ -211,7 +211,7 @@ module Stripe
     attr_reader :refunded_from_payment
     # Attribute for field transferred_to_balance
     attr_reader :transferred_to_balance
-    # The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://stripe.com/docs/payments/customer-balance#types) to learn more about these types.
+    # The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://docs.stripe.com/payments/customer-balance#types) to learn more about these types.
     attr_reader :type
     # Attribute for field unapplied_from_payment
     attr_reader :unapplied_from_payment

data/lib/stripe/resources/delegated_checkout/requested_session.rb

@@ -139,6 +139,61 @@ module Stripe
       end
 
       class LineItemDetail < ::Stripe::StripeObject
+        class ProductDetails < ::Stripe::StripeObject
+          class CustomAttribute < ::Stripe::StripeObject
+            # The display name of the custom attribute.
+            attr_reader :display_name
+            # The value of the custom attribute.
+            attr_reader :value
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Disclosure < ::Stripe::StripeObject
+            # The content of the disclosure.
+            attr_reader :content
+            # The content type of the disclosure.
+            attr_reader :content_type
+            # The type of disclosure.
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Custom attributes for the product.
+          attr_reader :custom_attributes
+          # The description of the product.
+          attr_reader :description
+          # Disclosures for the product.
+          attr_reader :disclosures
+          # The images of the product.
+          attr_reader :images
+          # The title of the product.
+          attr_reader :title
+
+          def self.inner_class_types
+            @inner_class_types = { custom_attributes: CustomAttribute, disclosures: Disclosure }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The total discount for this line item. If no discount were applied, defaults to 0.
+        attr_reader :amount_discount
+        # The total before any discounts or taxes are applied.
+        attr_reader :amount_subtotal
         # The description of the line item.
         attr_reader :description
         # The images of the line item.
@@ -147,19 +202,17 @@ module Stripe
         attr_reader :key
         # The name of the line item.
         attr_reader :name
+        # Attribute for field product_details
+        attr_reader :product_details
         # The quantity of the line item.
         attr_reader :quantity
         # The SKU ID of the line item.
         attr_reader :sku_id
         # The per-unit amount of the item before any discounts or taxes are applied.
         attr_reader :unit_amount
-        # The total discount for this line item. If no discount were applied, defaults to 0.
-        attr_reader :amount_discount
-        # The total before any discounts or taxes are applied.
-        attr_reader :amount_subtotal
 
         def self.inner_class_types
-          @inner_class_types = {}
+          @inner_class_types = { product_details: ProductDetails }
         end
 
         def self.field_remappings
@@ -283,14 +336,14 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The amount fulfillment of the total details.
-        attr_reader :amount_fulfillment
-        # The amount tax of the total details.
-        attr_reader :amount_tax
         # The amount of order-level discounts applied to the cart. The total discount amount for this session can be computed by summing the cart discount and the item discounts.
         attr_reader :amount_cart_discount
+        # The amount fulfillment of the total details.
+        attr_reader :amount_fulfillment
         # The amount of item-level discounts applied to the cart. The total discount amount for this session can be computed by summing the cart discount and the item discounts.
         attr_reader :amount_items_discount
+        # The amount tax of the total details.
+        attr_reader :amount_tax
         # The applicable fees of the total details.
         attr_reader :applicable_fees
 
@@ -322,7 +375,7 @@ module Stripe
       attr_reader :line_item_details
       # 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

data/lib/stripe/resources/discount.rb

@@ -2,10 +2,10 @@
 # frozen_string_literal: true
 
 module Stripe
-  # A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
+  # A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes).
   # It contains information about when the discount began, when it will end, and what it is applied to.
   #
-  # Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts)
+  # Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts)
   class Discount < StripeObject
     OBJECT_NAME = "discount"
     def self.object_name
@@ -30,7 +30,7 @@ module Stripe
     attr_reader :checkout_session
     # The ID of the customer associated with this discount.
     attr_reader :customer
-    # The ID of the account associated with this discount.
+    # The ID of the account representing the customer associated with this discount.
     attr_reader :customer_account
     # If the coupon has a duration of `repeating`, the date that this discount will end. If the coupon has a duration of `once` or `forever`, this attribute will be null.
     attr_reader :end
@@ -44,6 +44,8 @@ module Stripe
     attr_reader :object
     # The promotion code applied to create this discount.
     attr_reader :promotion_code
+    # The subscription schedule that this coupon is applied to, if it is applied to a particular subscription schedule.
+    attr_reader :schedule
     # Attribute for field source
     attr_reader :source
     # Date that the coupon was applied.
@@ -52,8 +54,6 @@ module Stripe
     attr_reader :subscription
     # The subscription item that this coupon is applied to, if it is applied to a particular subscription item.
     attr_reader :subscription_item
-    # The subscription schedule that this coupon is applied to, if it is applied to a particular subscription schedule.
-    attr_reader :schedule
     # Always true for a deleted object
     attr_reader :deleted
 

data/lib/stripe/resources/dispute.rb

@@ -6,7 +6,7 @@ module Stripe
   # When this happens, you have the opportunity to respond to the dispute with
   # evidence that shows that the charge is legitimate.
   #
-  # Related guide: [Disputes and fraud](https://stripe.com/docs/disputes)
+  # Related guide: [Disputes and fraud](https://docs.stripe.com/disputes)
   class Dispute < APIResource
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
@@ -31,7 +31,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
@@ -80,7 +80,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
@@ -412,7 +412,7 @@ module Stripe
     attr_reader :is_charge_refundable
     # 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
     # Network-dependent reason code for the dispute.
     attr_reader :network_reason_code
@@ -422,7 +422,7 @@ module Stripe
     attr_reader :payment_intent
     # Attribute for field payment_method_details
     attr_reader :payment_method_details
-    # Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://stripe.com/docs/disputes/categories).
+    # Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://docs.stripe.com/disputes/categories).
     attr_reader :reason
     # Attribute for field smart_disputes
     attr_reader :smart_disputes

data/lib/stripe/resources/entitlements/active_entitlement.rb

@@ -12,7 +12,7 @@ module Stripe
         "entitlements.active_entitlement"
       end
 
-      # The [Feature](https://stripe.com/docs/api/entitlements/feature) that the customer is entitled to.
+      # The [Feature](https://docs.stripe.com/api/entitlements/feature) that the customer is entitled to.
       attr_reader :feature
       # Unique identifier for the object.
       attr_reader :id

data/lib/stripe/resources/event.rb

@@ -29,7 +29,7 @@ module Stripe
     end
 
     class Data < ::Stripe::StripeObject
-      # Object containing the API resource relevant to the event. For example, an `invoice.created` event will have a full [invoice object](https://stripe.com/docs/api#invoice_object) as the value of the object key.
+      # Object containing the API resource relevant to the event. For example, an `invoice.created` event will have a full [invoice object](https://api.stripe.com#invoice_object) as the value of the object key.
       attr_reader :object
       # Object containing the names of the updated attributes and their values prior to the event (only included in events of type `*.updated`). If an array attribute has any updated elements, this object contains the entire array. In Stripe API versions 2017-04-06 or earlier, an updated array attribute in this object includes only the updated array elements.
       attr_reader :previous_attributes

data/lib/stripe/resources/exchange_rate.rb

@@ -10,13 +10,13 @@ module Stripe
   # rate (for example, to dynamically price an item for a user with a default
   # payment in a foreign currency).
   #
-  # Please refer to our [Exchange Rates API](https://stripe.com/docs/fx-rates) guide for more details.
+  # Please refer to our [Exchange Rates API](https://docs.stripe.com/fx-rates) guide for more details.
   #
   # *[Note: this integration path is supported but no longer recommended]* Additionally,
   # you can guarantee that a charge is made with an exchange rate that you expect is
   # current. To do so, you must pass in the exchange_rate to charges endpoints. If the
   # value is no longer up to date, the charge won't go through. Please refer to our
-  # [Using with charges](https://stripe.com/docs/exchange-rates) guide for more details.
+  # [Using with charges](https://docs.stripe.com/exchange-rates) guide for more details.
   #
   # -----
   #

data/lib/stripe/resources/file.rb

@@ -3,12 +3,12 @@
 
 module Stripe
   # This object represents files hosted on Stripe's servers. You can upload
-  # files with the [create file](https://stripe.com/docs/api#create_file) request
+  # files with the [create file](https://api.stripe.com#create_file) request
   # (for example, when uploading dispute evidence). Stripe also
   # creates files independently (for example, the results of a [Sigma scheduled
   # query](https://docs.stripe.com/api#scheduled_queries)).
   #
-  # Related guide: [File upload guide](https://stripe.com/docs/file-upload)
+  # Related guide: [File upload guide](https://docs.stripe.com/file-upload)
   class File < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -26,11 +26,11 @@ module Stripe
     attr_reader :filename
     # Unique identifier for the object.
     attr_reader :id
-    # A list of [file links](https://stripe.com/docs/api#file_links) that point at this file.
+    # A list of [file links](https://api.stripe.com#file_links) that point at this file.
     attr_reader :links
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
-    # 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_reader :purpose
     # The size of the file object in bytes.
     attr_reader :size

data/lib/stripe/resources/file_link.rb

@@ -27,7 +27,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
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/financial_connections/account.rb

@@ -16,9 +16,9 @@ module Stripe
       nested_resource_class_methods :inferred_balance, operations: %i[list]
 
       class AccountHolder < ::Stripe::StripeObject
-        # The ID of the Stripe account this account belongs to. Should only be present if `account_holder.type` is `account`.
+        # The ID of the Stripe account that this account belongs to. Only available when `account_holder.type` is `account`.
         attr_reader :account
-        # ID of the Stripe customer this account belongs to. Present if and only if `account_holder.type` is `customer`.
+        # The ID for an Account representing a customer that this account belongs to. Only available when `account_holder.type` is `customer`.
         attr_reader :customer
         # Attribute for field customer_account
         attr_reader :customer_account
@@ -233,7 +233,7 @@ module Stripe
       attr_reader :subcategory
       # The list of data refresh subscriptions requested on this account.
       attr_reader :subscriptions
-      # The [PaymentMethod type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account.
+      # The [PaymentMethod type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account.
       attr_reader :supported_payment_method_types
       # The state of the most recent attempt to refresh the account transactions.
       attr_reader :transaction_refresh

data/lib/stripe/resources/financial_connections/session.rb

@@ -13,9 +13,9 @@ module Stripe
       end
 
       class AccountHolder < ::Stripe::StripeObject
-        # The ID of the Stripe account this account belongs to. Should only be present if `account_holder.type` is `account`.
+        # The ID of the Stripe account that this account belongs to. Only available when `account_holder.type` is `account`.
         attr_reader :account
-        # ID of the Stripe customer this account belongs to. Present if and only if `account_holder.type` is `customer`.
+        # The ID for an Account representing a customer that this account belongs to. Only available when `account_holder.type` is `customer`.
         attr_reader :customer
         # Attribute for field customer_account
         attr_reader :customer_account

data/lib/stripe/resources/forwarding/request.rb

@@ -110,7 +110,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
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object

data/lib/stripe/resources/funding_instructions.rb

@@ -2,11 +2,11 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Each customer has a [`balance`](https://stripe.com/docs/api/customers/object#customer_object-balance) that is
+  # Each customer has a [`balance`](https://docs.stripe.com/api/customers/object#customer_object-balance) that is
   # automatically applied to future invoices and payments using the `customer_balance` payment method.
   # Customers can fund this balance by initiating a bank transfer to any account in the
   # `financial_addresses` field.
-  # Related guide: [Customer balance funding instructions](https://stripe.com/docs/payments/customer-balance/funding-instructions)
+  # Related guide: [Customer balance funding instructions](https://docs.stripe.com/payments/customer-balance/funding-instructions)
   class FundingInstructions < APIResource
     OBJECT_NAME = "funding_instructions"
     def self.object_name
@@ -27,7 +27,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
@@ -50,7 +50,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
@@ -100,7 +100,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
@@ -123,7 +123,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
@@ -171,7 +171,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
@@ -194,7 +194,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
@@ -240,7 +240,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
@@ -263,7 +263,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
@@ -311,7 +311,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
@@ -334,7 +334,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
@@ -384,7 +384,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
@@ -407,7 +407,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

data/lib/stripe/resources/identity/blocklist_entry.rb

@@ -10,7 +10,7 @@ module Stripe
     # This allows us to compare future verification attempts against these entries.
     # If a match is found, we categorize the new verification as unverified.
     #
-    # To learn more, see [Identity Verification Blocklist](https://stripe.com/docs/identity/review-tools#block-list)
+    # To learn more, see [Identity Verification Blocklist](https://docs.stripe.com/identity/review-tools#block-list)
     class BlocklistEntry < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List