stripe 13.4.1 → 17.0.1

data/lib/stripe/services/payment_intent_service.rb

@@ -14,11 +14,11 @@ module Stripe
       )
     end
 
-    # You can cancel a PaymentIntent object when it's in one of these statuses: requires_payment_method, requires_capture, requires_confirmation, requires_action or, [in rare cases](https://stripe.com/docs/payments/intents), processing.
+    # You can cancel a PaymentIntent object when it's in one of these statuses: requires_payment_method, requires_capture, requires_confirmation, requires_action or, [in rare cases](https://docs.stripe.com/docs/payments/intents), processing.
     #
     # After it's canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a status of requires_capture, the remaining amount_capturable is automatically refunded.
     #
-    # You can't cancel the PaymentIntent for a Checkout Session. [Expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead.
+    # You can't cancel the PaymentIntent for a Checkout Session. [Expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire) instead.
     def cancel(intent, params = {}, opts = {})
       request(
         method: :post,
@@ -33,7 +33,7 @@ module Stripe
     #
     # Uncaptured PaymentIntents are cancelled a set number of days (7 by default) after their creation.
     #
-    # Learn more about [separate authorization and capture](https://stripe.com/docs/payments/capture-later).
+    # Learn more about [separate authorization and capture](https://docs.stripe.com/docs/payments/capture-later).
     def capture(intent, params = {}, opts = {})
       request(
         method: :post,
@@ -47,6 +47,7 @@ module Stripe
     # Confirm that your customer intends to pay with current or provided
     # payment method. Upon confirmation, the PaymentIntent will attempt to initiate
     # a payment.
+    #
     # If the selected payment method requires additional authentication steps, the
     # PaymentIntent will transition to the requires_action status and
     # suggest additional actions via next_action. If payment fails,
@@ -54,18 +55,22 @@ module Stripe
     # canceled status if the confirmation limit is reached. If
     # payment succeeds, the PaymentIntent will transition to the succeeded
     # status (or requires_capture, if capture_method is set to manual).
+    #
     # If the confirmation_method is automatic, payment may be attempted
-    # using our [client SDKs](https://stripe.com/docs/stripe-js/reference#stripe-handle-card-payment)
-    # and the PaymentIntent's [client_secret](https://stripe.com/docs/api#payment_intent_object-client_secret).
+    # using our [client SDKs](https://docs.stripe.com/docs/stripe-js/reference#stripe-handle-card-payment)
+    # and the PaymentIntent's [client_secret](https://docs.stripe.com/api#payment_intent_object-client_secret).
     # After next_actions are handled by the client, no additional
     # confirmation is required to complete the payment.
+    #
     # If the confirmation_method is manual, all payment attempts must be
     # initiated using a secret key.
+    #
     # If any actions are required for the payment, the PaymentIntent will
     # return to the requires_confirmation state
     # after those actions are completed. Your server needs to then
     # explicitly re-confirm the PaymentIntent to initiate the next payment
     # attempt.
+    #
     # There is a variable upper limit on how many times a PaymentIntent can be confirmed.
     # After this limit is reached, any further calls to this endpoint will
     # transition the PaymentIntent to the canceled state.
@@ -81,13 +86,13 @@ module Stripe
 
     # Creates a PaymentIntent object.
     #
-    # After the PaymentIntent is created, attach a payment method and [confirm](https://stripe.com/docs/api/payment_intents/confirm)
+    # After the PaymentIntent is created, attach a payment method and [confirm](https://docs.stripe.com/docs/api/payment_intents/confirm)
     # to continue the payment. Learn more about <a href="/docs/payments/payment-intents">the available payment flows
     # with the Payment Intents API.
     #
     # When you use confirm=true during creation, it's equivalent to creating
     # and confirming the PaymentIntent in the same call. You can use any parameters
-    # available in the [confirm API](https://stripe.com/docs/api/payment_intents/confirm) when you supply
+    # available in the [confirm API](https://docs.stripe.com/docs/api/payment_intents/confirm) when you supply
     # confirm=true.
     def create(params = {}, opts = {})
       request(
@@ -100,9 +105,9 @@ module Stripe
     end
 
     # Perform an incremental authorization on an eligible
-    # [PaymentIntent](https://stripe.com/docs/api/payment_intents/object). To be eligible, the
+    # [PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/object). To be eligible, the
     # PaymentIntent's status must be requires_capture and
-    # [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported)
+    # [incremental_authorization_supported](https://docs.stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported)
     # must be true.
     #
     # Incremental authorizations attempt to increase the authorized amount on
@@ -113,16 +118,16 @@ module Stripe
     #
     # If the incremental authorization succeeds, the PaymentIntent object
     # returns with the updated
-    # [amount](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-amount).
+    # [amount](https://docs.stripe.com/docs/api/payment_intents/object#payment_intent_object-amount).
     # If the incremental authorization fails, a
-    # [card_declined](https://stripe.com/docs/error-codes#card-declined) error returns, and no other
+    # [card_declined](https://docs.stripe.com/docs/error-codes#card-declined) error returns, and no other
     # fields on the PaymentIntent or Charge update. The PaymentIntent
     # object remains capturable for the previously authorized amount.
     #
     # Each PaymentIntent can have a maximum of 10 incremental authorization attempts, including declines.
     # After it's captured, a PaymentIntent can no longer be incremented.
     #
-    # Learn more about [incremental authorizations](https://stripe.com/docs/terminal/features/incremental-authorizations).
+    # Learn more about [incremental authorizations](https://docs.stripe.com/docs/terminal/features/incremental-authorizations).
     def increment_authorization(intent, params = {}, opts = {})
       request(
         method: :post,
@@ -148,7 +153,7 @@ module Stripe
     #
     # You can retrieve a PaymentIntent client-side using a publishable key when the client_secret is in the query string.
     #
-    # If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the [payment intent](https://stripe.com/docs/api#payment_intent_object) object reference for more details.
+    # If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the [payment intent](https://docs.stripe.com/api#payment_intent_object) object reference for more details.
     def retrieve(intent, params = {}, opts = {})
       request(
         method: :get,
@@ -159,7 +164,7 @@ module Stripe
       )
     end
 
-    # Search for PaymentIntents you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for PaymentIntents you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.
@@ -179,7 +184,7 @@ module Stripe
     # PaymentIntent again. For example, updating the payment_method
     # always requires you to confirm the PaymentIntent again. If you prefer to
     # update and confirm at the same time, we recommend updating properties through
-    # the [confirm API](https://stripe.com/docs/api/payment_intents/confirm) instead.
+    # the [confirm API](https://docs.stripe.com/docs/api/payment_intents/confirm) instead.
     def update(intent, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/payment_link_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :line_items
 
     def initialize(requestor)
-      super(requestor)
+      super
       @line_items = Stripe::PaymentLinkLineItemService.new(@requestor)
     end
 

data/lib/stripe/services/payment_method_domain_service.rb

@@ -47,12 +47,12 @@ module Stripe
       )
     end
 
-    # Some payment methods such as Apple Pay require additional steps to verify a domain. If the requirements weren't satisfied when the domain was created, the payment method will be inactive on the domain.
-    # The payment method doesn't appear in Elements for this domain until it is active.
+    # Some payment methods might require additional steps to register a domain. If the requirements weren't satisfied when the domain was created, the payment method will be inactive on the domain.
+    # The payment method doesn't appear in Elements or Embedded Checkout for this domain until it is active.
     #
-    # To activate a payment method on an existing payment method domain, complete the required validation steps specific to the payment method, and then validate the payment method domain with this endpoint.
+    # To activate a payment method on an existing payment method domain, complete the required registration steps specific to the payment method, and then validate the payment method domain with this endpoint.
     #
-    # Related guides: [Payment method domains](https://stripe.com/docs/payments/payment-methods/pmd-registration).
+    # Related guides: [Payment method domains](https://docs.stripe.com/docs/payments/payment-methods/pmd-registration).
     def validate(payment_method_domain, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/payment_method_service.rb

@@ -5,16 +5,16 @@ module Stripe
   class PaymentMethodService < StripeService
     # Attaches a PaymentMethod object to a Customer.
     #
-    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
-    # or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
+    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://docs.stripe.com/docs/api/setup_intents)
+    # or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
     # These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
     # endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
     # future use, which makes later declines and payment friction more likely.
-    # See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
+    # See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
     # future payments.
     #
     # To use this PaymentMethod as the default for invoice or subscription payments,
-    # set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
+    # set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
     # on the Customer to the PaymentMethod's ID.
     def attach(payment_method, params = {}, opts = {})
       request(
@@ -26,9 +26,9 @@ module Stripe
       )
     end
 
-    # Creates a PaymentMethod object. Read the [Stripe.js reference](https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
+    # Creates a PaymentMethod object. Read the [Stripe.js reference](https://docs.stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
     #
-    # Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
+    # Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://docs.stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
     def create(params = {}, opts = {})
       request(
         method: :post,
@@ -50,7 +50,7 @@ module Stripe
       )
     end
 
-    # Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer_list) API instead.
+    # Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead.
     def list(params = {}, opts = {})
       request(
         method: :get,
@@ -61,7 +61,7 @@ module Stripe
       )
     end
 
-    # Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer)
+    # Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer)
     def retrieve(payment_method, params = {}, opts = {})
       request(
         method: :get,
@@ -72,7 +72,7 @@ module Stripe
       )
     end
 
-    # Updates a PaymentMethod object. A PaymentMethod must be attached a customer to be updated.
+    # Updates a PaymentMethod object. A PaymentMethod must be attached to a customer to be updated.
     def update(payment_method, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/payout_service.rb

@@ -14,11 +14,11 @@ module Stripe
       )
     end
 
-    # To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://stripe.com/docs/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
+    # To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://docs.stripe.com/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
     #
     # If your API key is in test mode, money won't actually be sent, though every other action occurs as if you're in live mode.
     #
-    # If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://stripe.com/docs/api#balance_object) details available and pending amounts by source type.
+    # If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://docs.stripe.com/api#balance_object) details available and pending amounts by source type.
     def create(params = {}, opts = {})
       request(method: :post, path: "/v1/payouts", params: params, opts: opts, base_address: :api)
     end

data/lib/stripe/services/plan_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class PlanService < StripeService
-    # You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
+    # You can now model subscriptions more flexibly using the [Prices API](https://docs.stripe.com/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
     def create(params = {}, opts = {})
       request(method: :post, path: "/v1/plans", params: params, opts: opts, base_address: :api)
     end

data/lib/stripe/services/price_service.rb

@@ -3,12 +3,12 @@
 
 module Stripe
   class PriceService < StripeService
-    # Creates a new price for an existing product. The price can be recurring or one-time.
+    # Creates a new [Price for an existing <a href="https://docs.stripe.com/api/products">Product](https://docs.stripe.com/api/prices). The Price can be recurring or one-time.
     def create(params = {}, opts = {})
       request(method: :post, path: "/v1/prices", params: params, opts: opts, base_address: :api)
     end
 
-    # Returns a list of your active prices, excluding [inline prices](https://stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
+    # Returns a list of your active prices, excluding [inline prices](https://docs.stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
     def list(params = {}, opts = {})
       request(method: :get, path: "/v1/prices", params: params, opts: opts, base_address: :api)
     end
@@ -24,7 +24,7 @@ module Stripe
       )
     end
 
-    # Search for prices you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for prices you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.

data/lib/stripe/services/product_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :features
 
     def initialize(requestor)
-      super(requestor)
+      super
       @features = Stripe::ProductFeatureService.new(@requestor)
     end
 
@@ -42,7 +42,7 @@ module Stripe
       )
     end
 
-    # Search for products you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for products you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.

data/lib/stripe/services/promotion_code_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class PromotionCodeService < StripeService
-    # A promotion code points to a coupon. You can optionally restrict the code to a specific customer, redemption limit, and expiration date.
+    # A promotion code points to an underlying promotion. You can optionally restrict the code to a specific customer, redemption limit, and expiration date.
     def create(params = {}, opts = {})
       request(
         method: :post,
@@ -25,7 +25,7 @@ module Stripe
       )
     end
 
-    # Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://stripe.com/docs/api/promotion_codes/list) with the desired code.
+    # Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://docs.stripe.com/docs/api/promotion_codes/list) with the desired code.
     def retrieve(promotion_code, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/quote_service.rb

@@ -3,12 +3,12 @@
 
 module Stripe
   class QuoteService < StripeService
-    attr_reader :line_items, :computed_upfront_line_items
+    attr_reader :computed_upfront_line_items, :line_items
 
     def initialize(requestor)
-      super(requestor)
-      @line_items = Stripe::QuoteLineItemService.new(@requestor)
+      super
       @computed_upfront_line_items = Stripe::QuoteComputedUpfrontLineItemsService.new(@requestor)
+      @line_items = Stripe::QuoteLineItemService.new(@requestor)
     end
 
     # Accepts the specified quote.

data/lib/stripe/services/radar/early_fraud_warning_service.rb

@@ -17,7 +17,7 @@ module Stripe
 
       # Retrieves the details of an early fraud warning that has previously been created.
       #
-      # Please refer to the [early fraud warning](https://stripe.com/docs/api#early_fraud_warning_object) object reference for more details.
+      # Please refer to the [early fraud warning](https://docs.stripe.com/api#early_fraud_warning_object) object reference for more details.
       def retrieve(early_fraud_warning, params = {}, opts = {})
         request(
           method: :get,

data/lib/stripe/services/radar_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :early_fraud_warnings, :value_lists, :value_list_items
 
     def initialize(requestor)
-      super(requestor)
+      super
       @early_fraud_warnings = Stripe::Radar::EarlyFraudWarningService.new(@requestor)
       @value_lists = Stripe::Radar::ValueListService.new(@requestor)
       @value_list_items = Stripe::Radar::ValueListItemService.new(@requestor)

data/lib/stripe/services/reporting_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :report_runs, :report_types
 
     def initialize(requestor)
-      super(requestor)
+      super
       @report_runs = Stripe::Reporting::ReportRunService.new(@requestor)
       @report_types = Stripe::Reporting::ReportTypeService.new(@requestor)
     end

data/lib/stripe/services/setup_intent_service.rb

@@ -5,7 +5,7 @@ module Stripe
   class SetupIntentService < StripeService
     # You can cancel a SetupIntent object when it's in one of these statuses: requires_payment_method, requires_confirmation, or requires_action.
     #
-    # After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error. You can't cancel the SetupIntent for a Checkout Session. [Expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead.
+    # After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error. You can't cancel the SetupIntent for a Checkout Session. [Expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire) instead.
     def cancel(intent, params = {}, opts = {})
       request(
         method: :post,
@@ -42,7 +42,7 @@ module Stripe
 
     # Creates a SetupIntent object.
     #
-    # After you create the SetupIntent, attach a payment method and [confirm](https://stripe.com/docs/api/setup_intents/confirm)
+    # After you create the SetupIntent, attach a payment method and [confirm](https://docs.stripe.com/docs/api/setup_intents/confirm)
     # it to collect any required permissions to charge the payment method later.
     def create(params = {}, opts = {})
       request(
@@ -69,7 +69,7 @@ module Stripe
     #
     # Client-side retrieval using a publishable key is allowed when the client_secret is provided in the query string.
     #
-    # When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the [SetupIntent](https://stripe.com/docs/api#setup_intent_object) object reference for more details.
+    # When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the [SetupIntent](https://docs.stripe.com/api#setup_intent_object) object reference for more details.
     def retrieve(intent, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/sigma_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :scheduled_query_runs
 
     def initialize(requestor)
-      super(requestor)
+      super
       @scheduled_query_runs = Stripe::Sigma::ScheduledQueryRunService.new(@requestor)
     end
   end

data/lib/stripe/services/source_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :transactions
 
     def initialize(requestor)
-      super(requestor)
+      super
       @transactions = Stripe::SourceTransactionService.new(@requestor)
     end
 
@@ -39,7 +39,7 @@ module Stripe
 
     # Updates the specified source by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
     #
-    # This request accepts the metadata and owner as arguments. It is also possible to update type specific information for selected payment methods. Please refer to our [payment method guides](https://stripe.com/docs/sources) for more detail.
+    # This request accepts the metadata and owner as arguments. It is also possible to update type specific information for selected payment methods. Please refer to our [payment method guides](https://docs.stripe.com/docs/sources) for more detail.
     def update(source, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/subscription_item_service.rb

@@ -3,14 +3,6 @@
 
 module Stripe
   class SubscriptionItemService < StripeService
-    attr_reader :usage_records, :usage_record_summaries
-
-    def initialize(requestor)
-      super(requestor)
-      @usage_records = Stripe::SubscriptionItemUsageRecordService.new(@requestor)
-      @usage_record_summaries = Stripe::SubscriptionItemUsageRecordSummaryService.new(@requestor)
-    end
-
     # Adds a new item to an existing subscription. No existing items will be changed or replaced.
     def create(params = {}, opts = {})
       request(

data/lib/stripe/services/subscription_service.rb

@@ -3,9 +3,9 @@
 
 module Stripe
   class SubscriptionService < StripeService
-    # Cancels a customer's subscription immediately. The customer won't be charged again for the subscription. After it's canceled, you can no longer update the subscription or its [metadata](https://stripe.com/metadata).
+    # Cancels a customer's subscription immediately. The customer won't be charged again for the subscription. After it's canceled, you can no longer update the subscription or its [metadata](https://docs.stripe.com/metadata).
     #
-    # Any pending invoice items that you've created are still charged at the end of the period, unless manually [deleted](https://stripe.com/docs/api#delete_invoiceitem). If you've set the subscription to cancel at the end of the period, any pending prorations are also left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations are removed.
+    # Any pending invoice items that you've created are still charged at the end of the period, unless manually [deleted](https://docs.stripe.com/api#delete_invoiceitem). If you've set the subscription to cancel at the end of the period, any pending prorations are also left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations are removed if invoice_now and prorate are both set to true.
     #
     # By default, upon subscription cancellation, Stripe stops automatic collection of all finalized invoices for the customer. This is intended to prevent unexpected payment attempts after the customer has canceled a subscription. However, you can resume automatic collection of the invoices manually after subscription cancellation to have us proceed. Or, you could check for unpaid invoices before allowing the customer to cancel the subscription at all.
     def cancel(subscription_exposed_id, params = {}, opts = {})
@@ -23,7 +23,7 @@ module Stripe
     # When you create a subscription with collection_method=charge_automatically, the first invoice is finalized as part of the request.
     # The payment_behavior parameter determines the exact behavior of the initial payment.
     #
-    # To start subscriptions where the first invoice always begins in a draft status, use [subscription schedules](https://stripe.com/docs/billing/subscriptions/subscription-schedules#managing) instead.
+    # To start subscriptions where the first invoice always begins in a draft status, use [subscription schedules](https://docs.stripe.com/docs/billing/subscriptions/subscription-schedules#managing) instead.
     # Schedules provide the flexibility to model more complex billing configurations that change over time.
     def create(params = {}, opts = {})
       request(
@@ -57,6 +57,17 @@ module Stripe
       )
     end
 
+    # Upgrade the billing_mode of an existing subscription.
+    def migrate(subscription, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/subscriptions/%<subscription>s/migrate", { subscription: CGI.escape(subscription) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
     # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If a resumption invoice is generated, it must be paid or marked uncollectible before the subscription will be unpaused. If payment succeeds the subscription will become active, and if payment fails the subscription will be past_due. The resumption invoice will void automatically if not paid by the expiration date.
     def resume(subscription, params = {}, opts = {})
       request(
@@ -79,7 +90,7 @@ module Stripe
       )
     end
 
-    # Search for subscriptions you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for subscriptions you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.
@@ -95,7 +106,7 @@ module Stripe
 
     # Updates an existing subscription to match the specified parameters.
     # When changing prices or quantities, we optionally prorate the price we charge next month to make up for any price changes.
-    # To preview how the proration is calculated, use the [create preview](https://stripe.com/docs/api/invoices/create_preview) endpoint.
+    # To preview how the proration is calculated, use the [create preview](https://docs.stripe.com/docs/api/invoices/create_preview) endpoint.
     #
     # By default, we prorate subscription changes. For example, if a customer signs up on May 1 for a 100 price, they'll be billed 100 immediately. If on May 15 they switch to a 200 price, then on June 1 they'll be billed 250 (200 for a renewal of her subscription, plus a 50 prorating adjustment for half of the previous month's 100 difference). Similarly, a downgrade generates a credit that is applied to the next invoice. We also prorate when you make quantity changes.
     #
@@ -107,13 +118,13 @@ module Stripe
     # A trial starts or ends.
     #
     #
-    # In these cases, we apply a credit for the unused time on the previous price, immediately charge the customer using the new price, and reset the billing date. Learn about how [Stripe immediately attempts payment for subscription changes](https://stripe.com/docs/billing/subscriptions/upgrade-downgrade#immediate-payment).
+    # In these cases, we apply a credit for the unused time on the previous price, immediately charge the customer using the new price, and reset the billing date. Learn about how [Stripe immediately attempts payment for subscription changes](https://docs.stripe.com/docs/billing/subscriptions/upgrade-downgrade#immediate-payment).
     #
-    # If you want to charge for an upgrade immediately, pass proration_behavior as always_invoice to create prorations, automatically invoice the customer for those proration adjustments, and attempt to collect payment. If you pass create_prorations, the prorations are created but not automatically invoiced. If you want to bill the customer for the prorations before the subscription's renewal date, you need to manually [invoice the customer](https://stripe.com/docs/api/invoices/create).
+    # If you want to charge for an upgrade immediately, pass proration_behavior as always_invoice to create prorations, automatically invoice the customer for those proration adjustments, and attempt to collect payment. If you pass create_prorations, the prorations are created but not automatically invoiced. If you want to bill the customer for the prorations before the subscription's renewal date, you need to manually [invoice the customer](https://docs.stripe.com/docs/api/invoices/create).
     #
     # If you don't want to prorate, set the proration_behavior option to none. With this option, the customer is billed 100 on May 1 and 200 on June 1. Similarly, if you set proration_behavior to none when switching between different billing intervals (for example, from monthly to yearly), we don't generate any credits for the old subscription's unused time. We still reset the billing date and bill immediately for the new subscription.
     #
-    # Updating the quantity on a subscription many times in an hour may result in [rate limiting. If you need to bill for a frequently changing quantity, consider integrating <a href="/docs/billing/subscriptions/usage-based">usage-based billing](https://stripe.com/docs/rate-limits) instead.
+    # Updating the quantity on a subscription many times in an hour may result in [rate limiting. If you need to bill for a frequently changing quantity, consider integrating <a href="/docs/billing/subscriptions/usage-based">usage-based billing](https://docs.stripe.com/docs/rate-limits) instead.
     def update(subscription_exposed_id, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/tax/calculation_service.rb

@@ -7,7 +7,7 @@ module Stripe
       attr_reader :line_items
 
       def initialize(requestor)
-        super(requestor)
+        super
         @line_items = Stripe::Tax::CalculationLineItemService.new(@requestor)
       end
 

data/lib/stripe/services/tax/transaction_service.rb

@@ -7,7 +7,7 @@ module Stripe
       attr_reader :line_items
 
       def initialize(requestor)
-        super(requestor)
+        super
         @line_items = Stripe::Tax::TransactionLineItemService.new(@requestor)
       end
 

data/lib/stripe/services/tax_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :calculations, :registrations, :settings, :transactions
 
     def initialize(requestor)
-      super(requestor)
+      super
       @calculations = Stripe::Tax::CalculationService.new(@requestor)
       @registrations = Stripe::Tax::RegistrationService.new(@requestor)
       @settings = Stripe::Tax::SettingsService.new(@requestor)

data/lib/stripe/services/terminal/location_service.rb

@@ -5,7 +5,7 @@ module Stripe
   module Terminal
     class LocationService < StripeService
       # Creates a new Location object.
-      # For further details, including which address fields are required in each country, see the [Manage locations](https://stripe.com/docs/terminal/fleet/locations) guide.
+      # For further details, including which address fields are required in each country, see the [Manage locations](https://docs.stripe.com/docs/terminal/fleet/locations) guide.
       def create(params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/terminal/reader_service.rb

@@ -15,6 +15,39 @@ module Stripe
         )
       end
 
+      # Initiates an input collection flow on a Reader.
+      def collect_inputs(reader, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/collect_inputs", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Initiates a payment flow on a Reader and updates the PaymentIntent with card details before manual confirmation.
+      def collect_payment_method(reader, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/collect_payment_method", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Finalizes a payment on a Reader.
+      def confirm_payment_intent(reader, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/confirm_payment_intent", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
       # Creates a new Reader object.
       def create(params = {}, opts = {})
         request(

data/lib/stripe/services/terminal_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :configurations, :connection_tokens, :locations, :readers
 
     def initialize(requestor)
-      super(requestor)
+      super
       @configurations = Stripe::Terminal::ConfigurationService.new(@requestor)
       @connection_tokens = Stripe::Terminal::ConnectionTokenService.new(@requestor)
       @locations = Stripe::Terminal::LocationService.new(@requestor)

data/lib/stripe/services/test_helpers/issuing_service.rb

@@ -7,7 +7,7 @@ module Stripe
       attr_reader :authorizations, :cards, :personalization_designs, :transactions
 
       def initialize(requestor)
-        super(requestor)
+        super
         @authorizations = Stripe::TestHelpers::Issuing::AuthorizationService.new(@requestor)
         @cards = Stripe::TestHelpers::Issuing::CardService.new(@requestor)
         @personalization_designs = Stripe::TestHelpers::Issuing::PersonalizationDesignService