stripe 18.1.0.pre.beta.1 → 18.1.0

data/lib/stripe/resources/subscription_schedule.rb

@@ -4,7 +4,7 @@
 module Stripe
   # A subscription schedule allows you to create and manage the lifecycle of a subscription by predefining expected changes.
   #
-  # Related guide: [Subscription schedules](https://stripe.com/docs/billing/subscriptions/subscription-schedules)
+  # Related guide: [Subscription schedules](https://docs.stripe.com/billing/subscriptions/subscription-schedules)
   class SubscriptionSchedule < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -155,7 +155,7 @@ module Stripe
       attr_reader :application_fee_percent
       # Attribute for field automatic_tax
       attr_reader :automatic_tax
-      # Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle).
+      # Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
       attr_reader :billing_cycle_anchor
       # Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
       attr_reader :billing_thresholds
@@ -186,65 +186,18 @@ module Stripe
       end
     end
 
-    class LastPriceMigrationError < ::Stripe::StripeObject
-      class FailedTransition < ::Stripe::StripeObject
-        # The original price to be migrated.
-        attr_reader :source_price
-        # The intended resulting price of the migration.
-        attr_reader :target_price
-
-        def self.inner_class_types
-          @inner_class_types = {}
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
-      # The time at which the price migration encountered an error.
-      attr_reader :errored_at
-      # The involved price pairs in each failed transition.
-      attr_reader :failed_transitions
-      # The type of error encountered by the price migration.
-      attr_reader :type
-
-      def self.inner_class_types
-        @inner_class_types = { failed_transitions: FailedTransition }
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
-
     class Phase < ::Stripe::StripeObject
       class AddInvoiceItem < ::Stripe::StripeObject
         class Discount < ::Stripe::StripeObject
-          class DiscountEnd < ::Stripe::StripeObject
-            # The discount end timestamp.
-            attr_reader :timestamp
-            # The discount end type.
-            attr_reader :type
-
-            def self.inner_class_types
-              @inner_class_types = {}
-            end
-
-            def self.field_remappings
-              @field_remappings = {}
-            end
-          end
           # ID of the coupon to create a new discount for.
           attr_reader :coupon
           # ID of an existing discount on the object (or one of its ancestors) to reuse.
           attr_reader :discount
-          # Details to determine how long the discount should be applied for.
-          attr_reader :discount_end
           # ID of the promotion code to create a new discount for.
           attr_reader :promotion_code
 
           def self.inner_class_types
-            @inner_class_types = { discount_end: DiscountEnd }
+            @inner_class_types = {}
           end
 
           def self.field_remappings
@@ -297,7 +250,7 @@ module Stripe
         end
         # The stackable discounts that will be applied to the item.
         attr_reader :discounts
-        # 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
         # Attribute for field period
         attr_reader :period
@@ -364,31 +317,15 @@ module Stripe
       end
 
       class Discount < ::Stripe::StripeObject
-        class DiscountEnd < ::Stripe::StripeObject
-          # The discount end timestamp.
-          attr_reader :timestamp
-          # The discount end type.
-          attr_reader :type
-
-          def self.inner_class_types
-            @inner_class_types = {}
-          end
-
-          def self.field_remappings
-            @field_remappings = {}
-          end
-        end
         # ID of the coupon to create a new discount for.
         attr_reader :coupon
         # ID of an existing discount on the object (or one of its ancestors) to reuse.
         attr_reader :discount
-        # Details to determine how long the discount should be applied for.
-        attr_reader :discount_end
         # ID of the promotion code to create a new discount for.
         attr_reader :promotion_code
 
         def self.inner_class_types
-          @inner_class_types = { discount_end: DiscountEnd }
+          @inner_class_types = {}
         end
 
         def self.field_remappings
@@ -442,44 +379,13 @@ module Stripe
         end
 
         class Discount < ::Stripe::StripeObject
-          class DiscountEnd < ::Stripe::StripeObject
-            # The discount end timestamp.
-            attr_reader :timestamp
-            # The discount end type.
-            attr_reader :type
-
-            def self.inner_class_types
-              @inner_class_types = {}
-            end
-
-            def self.field_remappings
-              @field_remappings = {}
-            end
-          end
           # ID of the coupon to create a new discount for.
           attr_reader :coupon
           # ID of an existing discount on the object (or one of its ancestors) to reuse.
           attr_reader :discount
-          # Details to determine how long the discount should be applied for.
-          attr_reader :discount_end
           # ID of the promotion code to create a new discount for.
           attr_reader :promotion_code
 
-          def self.inner_class_types
-            @inner_class_types = { discount_end: DiscountEnd }
-          end
-
-          def self.field_remappings
-            @field_remappings = {}
-          end
-        end
-
-        class Trial < ::Stripe::StripeObject
-          # List of price IDs which, if present on the subscription following a paid trial, constitute opting-in to the paid trial.
-          attr_reader :converts_to
-          # Determines the type of trial for this item.
-          attr_reader :type
-
           def self.inner_class_types
             @inner_class_types = {}
           end
@@ -492,7 +398,7 @@ module Stripe
         attr_reader :billing_thresholds
         # The discounts applied to the subscription item. Subscription item discounts are applied before subscription discounts. Use `expand[]=discounts` to expand each discount.
         attr_reader :discounts
-        # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered.
+        # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered.
         attr_reader :metadata
         # ID of the plan to which the customer should be subscribed.
         attr_reader :plan
@@ -502,28 +408,9 @@ module Stripe
         attr_reader :quantity
         # The tax rates which apply to this `phase_item`. When set, the `default_tax_rates` on the phase do not apply to this `phase_item`.
         attr_reader :tax_rates
-        # Options that configure the trial on the subscription item.
-        attr_reader :trial
 
         def self.inner_class_types
-          @inner_class_types = {
-            billing_thresholds: BillingThresholds,
-            discounts: Discount,
-            trial: Trial,
-          }
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
-
-      class PauseCollection < ::Stripe::StripeObject
-        # The payment collection behavior for this subscription while paused. One of `keep_as_draft`, `mark_uncollectible`, or `void`.
-        attr_reader :behavior
-
-        def self.inner_class_types
-          @inner_class_types = {}
+          @inner_class_types = { billing_thresholds: BillingThresholds, discounts: Discount }
         end
 
         def self.field_remappings
@@ -545,38 +432,13 @@ module Stripe
           @field_remappings = {}
         end
       end
-
-      class TrialSettings < ::Stripe::StripeObject
-        class EndBehavior < ::Stripe::StripeObject
-          # Configure how an opt-in following a paid trial is billed when using `billing_behavior: prorate_up_front`.
-          attr_reader :prorate_up_front
-
-          def self.inner_class_types
-            @inner_class_types = {}
-          end
-
-          def self.field_remappings
-            @field_remappings = {}
-          end
-        end
-        # Defines how the subscription should behave when a trial ends.
-        attr_reader :end_behavior
-
-        def self.inner_class_types
-          @inner_class_types = { end_behavior: EndBehavior }
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
       # A list of prices and quantities that will generate invoice items appended to the next invoice for this phase.
       attr_reader :add_invoice_items
       # A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account during this phase of the schedule.
       attr_reader :application_fee_percent
       # Attribute for field automatic_tax
       attr_reader :automatic_tax
-      # Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle).
+      # Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
       attr_reader :billing_cycle_anchor
       # Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
       attr_reader :billing_thresholds
@@ -598,24 +460,18 @@ module Stripe
       attr_reader :invoice_settings
       # Subscription items to configure the subscription to during this phase of the subscription schedule.
       attr_reader :items
-      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`.
+      # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`.
       attr_reader :metadata
       # The account (if any) the charge was made on behalf of for charges associated with the schedule's subscription. See the Connect documentation for details.
       attr_reader :on_behalf_of
-      # If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment).
-      attr_reader :pause_collection
       # When transitioning phases, controls how prorations are handled (if any). Possible values are `create_prorations`, `none`, and `always_invoice`.
       attr_reader :proration_behavior
       # The start of this phase of the subscription schedule.
       attr_reader :start_date
       # The account (if any) the associated subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
       attr_reader :transfer_data
-      # Specify behavior of the trial when crossing schedule phase boundaries
-      attr_reader :trial_continuation
       # When the trial ends within the phase.
       attr_reader :trial_end
-      # Settings related to any trials on the subscription during this phase.
-      attr_reader :trial_settings
 
       def self.inner_class_types
         @inner_class_types = {
@@ -625,9 +481,7 @@ module Stripe
           discounts: Discount,
           invoice_settings: InvoiceSettings,
           items: Item,
-          pause_collection: PauseCollection,
           transfer_data: TransferData,
-          trial_settings: TrialSettings,
         }
       end
 
@@ -635,29 +489,8 @@ module Stripe
         @field_remappings = {}
       end
     end
-
-    class Prebilling < ::Stripe::StripeObject
-      # ID of the prebilling invoice.
-      attr_reader :invoice
-      # The end of the last period for which the invoice pre-bills.
-      attr_reader :period_end
-      # The start of the first period for which the invoice pre-bills.
-      attr_reader :period_start
-      # Whether to cancel or preserve `prebilling` if the subscription is updated during the prebilled period.
-      attr_reader :update_behavior
-
-      def self.inner_class_types
-        @inner_class_types = {}
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
     # ID of the Connect Application that created the schedule.
     attr_reader :application
-    # Configures when the subscription schedule generates prorations for phase transitions. Possible values are `prorate_on_next_phase` or `prorate_up_front` with the default being `prorate_on_next_phase`. `prorate_on_next_phase` will apply phase changes and generate prorations at transition time. `prorate_up_front` will bill for all phases within the current billing cycle up front.
-    attr_reader :billing_behavior
     # The billing mode of the subscription.
     attr_reader :billing_mode
     # Time at which the subscription schedule was canceled. Measured in seconds since the Unix epoch.
@@ -678,49 +511,25 @@ module Stripe
     attr_reader :end_behavior
     # Unique identifier for the object.
     attr_reader :id
-    # Details of the most recent price migration that failed for the subscription schedule.
-    attr_reader :last_price_migration_error
     # 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
     # Configuration for the subscription schedule's phases.
     attr_reader :phases
-    # Time period and invoice for a Subscription billed in advance.
-    attr_reader :prebilling
     # Time at which the subscription schedule was released. Measured in seconds since the Unix epoch.
     attr_reader :released_at
     # ID of the subscription once managed by the subscription schedule (if it is released).
     attr_reader :released_subscription
-    # The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://stripe.com/docs/billing/subscriptions/subscription-schedules).
+    # The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://docs.stripe.com/billing/subscriptions/subscription-schedules).
     attr_reader :status
     # ID of the subscription managed by the subscription schedule.
     attr_reader :subscription
     # ID of the test clock this subscription schedule belongs to.
     attr_reader :test_clock
 
-    # Amends an existing subscription schedule.
-    def amend(params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/subscription_schedules/%<schedule>s/amend", { schedule: CGI.escape(self["id"]) }),
-        params: params,
-        opts: opts
-      )
-    end
-
-    # Amends an existing subscription schedule.
-    def self.amend(schedule, params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/subscription_schedules/%<schedule>s/amend", { schedule: CGI.escape(schedule) }),
-        params: params,
-        opts: opts
-      )
-    end
-
     # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
     def cancel(params = {}, opts = {})
       request_stripe_object(
@@ -796,9 +605,7 @@ module Stripe
         billing_mode: BillingMode,
         current_phase: CurrentPhase,
         default_settings: DefaultSettings,
-        last_price_migration_error: LastPriceMigrationError,
         phases: Phase,
-        prebilling: Prebilling,
       }
     end
 

data/lib/stripe/resources/tax/association.rb

@@ -12,7 +12,7 @@ module Stripe
 
       class TaxTransactionAttempt < ::Stripe::StripeObject
         class Committed < ::Stripe::StripeObject
-          # The [Tax Transaction](https://stripe.com/docs/api/tax/transaction/object)
+          # The [Tax Transaction](https://docs.stripe.com/api/tax/transaction/object)
           attr_reader :transaction
 
           def self.inner_class_types
@@ -53,13 +53,13 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # The [Tax Calculation](https://stripe.com/docs/api/tax/calculations/object) that was included in PaymentIntent.
+      # The [Tax Calculation](https://docs.stripe.com/api/tax/calculations/object) that was included in PaymentIntent.
       attr_reader :calculation
       # Unique identifier for the object.
       attr_reader :id
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
-      # The [PaymentIntent](https://stripe.com/docs/api/payment_intents/object) that this Tax Association is tracking.
+      # The [PaymentIntent](https://docs.stripe.com/api/payment_intents/object) that this Tax Association is tracking.
       attr_reader :payment_intent
       # Information about the tax transactions linked to this payment intent
       attr_reader :tax_transaction_attempts

data/lib/stripe/resources/tax/calculation.rb

@@ -5,7 +5,7 @@ module Stripe
   module Tax
     # A Tax Calculation allows you to calculate the tax to collect from your customer.
     #
-    # Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom)
+    # Related guide: [Calculate tax in your custom payment flow](https://docs.stripe.com/tax/custom)
     class Calculation < APIResource
       extend Stripe::APIOperations::Create
 
@@ -144,7 +144,7 @@ module Stripe
               @field_remappings = {}
             end
           end
-          # The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
           attr_reader :amount
           # Attribute for field jurisdiction
           attr_reader :jurisdiction
@@ -154,7 +154,7 @@ module Stripe
           attr_reader :tax_rate_details
           # The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
           attr_reader :taxability_reason
-          # The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
           attr_reader :taxable_amount
 
           def self.inner_class_types
@@ -165,17 +165,17 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The shipping amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+        # The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
         attr_reader :amount
-        # The amount of tax calculated for shipping, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :amount_tax
-        # The ID of an existing [ShippingRate](https://stripe.com/docs/api/shipping_rates/object).
+        # The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object).
         attr_reader :shipping_rate
         # Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes.
         attr_reader :tax_behavior
         # Detailed account of taxes relevant to shipping cost.
         attr_reader :tax_breakdown
-        # The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for shipping.
+        # The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping.
         attr_reader :tax_code
 
         def self.inner_class_types
@@ -211,7 +211,7 @@ module Stripe
           attr_reader :percentage_decimal
           # Indicates the type of tax rate applied to the taxable amount. This value can be `null` when no tax applies to the location. This field is only present for TaxRates created by Stripe Tax.
           attr_reader :rate_type
-          # State, county, province, or region.
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
           attr_reader :state
           # The tax type, such as `vat` or `sales_tax`.
           attr_reader :tax_type
@@ -224,7 +224,7 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :amount
         # Specifies whether the tax amount is included in the line item amount.
         attr_reader :inclusive
@@ -232,7 +232,7 @@ module Stripe
         attr_reader :tax_rate_details
         # The reasoning behind this tax, for example, if the product is tax exempt. We might extend the possible values for this field to support new tax rules.
         attr_reader :taxability_reason
-        # The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :taxable_amount
 
         def self.inner_class_types
@@ -243,11 +243,11 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # Total amount after taxes in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # Total amount after taxes in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_reader :amount_total
       # 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 ID of an existing [Customer](https://stripe.com/docs/api/customers/object) used for the resource.
+      # The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource.
       attr_reader :customer
       # Attribute for field customer_details
       attr_reader :customer_details

data/lib/stripe/resources/tax/calculation_line_item.rb

@@ -45,7 +45,7 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :amount
         # Attribute for field jurisdiction
         attr_reader :jurisdiction
@@ -55,7 +55,7 @@ module Stripe
         attr_reader :tax_rate_details
         # The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
         attr_reader :taxability_reason
-        # The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :taxable_amount
 
         def self.inner_class_types
@@ -66,19 +66,19 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # The line item amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+      # The line item amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
       attr_reader :amount
-      # The amount of tax calculated for this line item, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The amount of tax calculated for this line item, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
       attr_reader :amount_tax
       # Unique identifier for the object.
       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
-      # The ID of an existing [Product](https://stripe.com/docs/api/products/object).
+      # The ID of an existing [Product](https://docs.stripe.com/api/products/object).
       attr_reader :product
       # The number of units of the item being purchased. For reversals, this is the quantity reversed.
       attr_reader :quantity
@@ -88,7 +88,7 @@ module Stripe
       attr_reader :tax_behavior
       # Detailed account of taxes relevant to this line item.
       attr_reader :tax_breakdown
-      # The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for this resource.
+      # The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource.
       attr_reader :tax_code
 
       def self.inner_class_types

data/lib/stripe/resources/tax/registration.rb

@@ -3,11 +3,11 @@
 
 module Stripe
   module Tax
-    # A Tax `Registration` lets us know that your business is registered to collect tax on payments within a region, enabling you to [automatically collect tax](https://stripe.com/docs/tax).
+    # A Tax `Registration` lets us know that your business is registered to collect tax on payments within a region, enabling you to [automatically collect tax](https://docs.stripe.com/tax).
     #
-    # Stripe doesn't register on your behalf with the relevant authorities when you create a Tax `Registration` object. For more information on how to register to collect tax, see [our guide](https://stripe.com/docs/tax/registering).
+    # Stripe doesn't register on your behalf with the relevant authorities when you create a Tax `Registration` object. For more information on how to register to collect tax, see [our guide](https://docs.stripe.com/tax/registering).
     #
-    # Related guide: [Using the Registrations API](https://stripe.com/docs/tax/registrations-api)
+    # Related guide: [Using the Registrations API](https://docs.stripe.com/tax/registrations-api)
     class Registration < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List

data/lib/stripe/resources/tax/settings.rb

@@ -5,7 +5,7 @@ module Stripe
   module Tax
     # You can use Tax `Settings` to manage configurations used by Stripe Tax calculations.
     #
-    # Related guide: [Using the Settings API](https://stripe.com/docs/tax/settings-api)
+    # Related guide: [Using the Settings API](https://docs.stripe.com/tax/settings-api)
     class Settings < SingletonAPIResource
       include Stripe::APIOperations::SingletonSave
 
@@ -43,7 +43,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/tax/transaction.rb

@@ -5,7 +5,7 @@ module Stripe
   module Tax
     # A Tax Transaction records the tax collected from or refunded to your customer.
     #
-    # Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom#tax-transaction)
+    # Related guide: [Calculate tax in your custom payment flow](https://docs.stripe.com/tax/custom#tax-transaction)
     class Transaction < APIResource
       OBJECT_NAME = "tax.transaction"
       def self.object_name
@@ -155,7 +155,7 @@ module Stripe
               @field_remappings = {}
             end
           end
-          # The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
           attr_reader :amount
           # Attribute for field jurisdiction
           attr_reader :jurisdiction
@@ -165,7 +165,7 @@ module Stripe
           attr_reader :tax_rate_details
           # The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
           attr_reader :taxability_reason
-          # The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
           attr_reader :taxable_amount
 
           def self.inner_class_types
@@ -176,17 +176,17 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The shipping amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+        # The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
         attr_reader :amount
-        # The amount of tax calculated for shipping, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_reader :amount_tax
-        # The ID of an existing [ShippingRate](https://stripe.com/docs/api/shipping_rates/object).
+        # The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object).
         attr_reader :shipping_rate
         # Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes.
         attr_reader :tax_behavior
         # Detailed account of taxes relevant to shipping cost. (It is not populated for the transaction resource object and will be removed in the next API version.)
         attr_reader :tax_breakdown
-        # The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for shipping.
+        # The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping.
         attr_reader :tax_code
 
         def self.inner_class_types
@@ -201,7 +201,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 ID of an existing [Customer](https://stripe.com/docs/api/customers/object) used for the resource.
+      # The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource.
       attr_reader :customer
       # Attribute for field customer_details
       attr_reader :customer_details
@@ -211,7 +211,7 @@ module Stripe
       attr_reader :line_items
       # 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