stripe 13.4.1 → 17.0.1

data/lib/stripe/services/billing/meter_service.rb

@@ -7,7 +7,7 @@ module Stripe
       attr_reader :event_summaries
 
       def initialize(requestor)
-        super(requestor)
+        super
         @event_summaries = Stripe::Billing::MeterEventSummaryService.new(@requestor)
       end
 

data/lib/stripe/services/billing_portal_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :configurations, :sessions
 
     def initialize(requestor)
-      super(requestor)
+      super
       @configurations = Stripe::BillingPortal::ConfigurationService.new(@requestor)
       @sessions = Stripe::BillingPortal::SessionService.new(@requestor)
     end

data/lib/stripe/services/billing_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :alerts, :credit_balance_summary, :credit_balance_transactions, :credit_grants, :meters, :meter_events, :meter_event_adjustments
 
     def initialize(requestor)
-      super(requestor)
+      super
       @alerts = Stripe::Billing::AlertService.new(@requestor)
       @credit_balance_summary = Stripe::Billing::CreditBalanceSummaryService.new(@requestor)
       @credit_balance_transactions = Stripe::Billing::CreditBalanceTransactionService

data/lib/stripe/services/charge_service.rb

@@ -5,9 +5,9 @@ module Stripe
   class ChargeService < StripeService
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     def capture(charge, params = {}, opts = {})
       request(
         method: :post,
@@ -18,7 +18,7 @@ module Stripe
       )
     end
 
-    # This method is no longer recommended—use the [Payment Intents API](https://stripe.com/docs/api/payment_intents)
+    # This method is no longer recommended—use the [Payment Intents API](https://docs.stripe.com/docs/api/payment_intents)
     # to initiate a new payment instead. Confirmation of the PaymentIntent creates the Charge
     # object used to request payment.
     def create(params = {}, opts = {})
@@ -41,7 +41,7 @@ module Stripe
       )
     end
 
-    # Search for charges you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for charges 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/checkout/session_service.rb

@@ -7,11 +7,11 @@ module Stripe
       attr_reader :line_items
 
       def initialize(requestor)
-        super(requestor)
+        super
         @line_items = Stripe::Checkout::SessionLineItemService.new(@requestor)
       end
 
-      # Creates a Session object.
+      # Creates a Checkout Session object.
       def create(params = {}, opts = {})
         request(
           method: :post,
@@ -22,9 +22,9 @@ module Stripe
         )
       end
 
-      # A Session can be expired when it is in one of these statuses: open
+      # A Checkout Session can be expired when it is in one of these statuses: open
       #
-      # After it expires, a customer can't complete a Session and customers loading the Session see a message saying the Session is expired.
+      # After it expires, a customer can't complete a Checkout Session and customers loading the Checkout Session see a message saying the Checkout Session is expired.
       def expire(session, params = {}, opts = {})
         request(
           method: :post,
@@ -46,7 +46,7 @@ module Stripe
         )
       end
 
-      # Retrieves a Session object.
+      # Retrieves a Checkout Session object.
       def retrieve(session, params = {}, opts = {})
         request(
           method: :get,
@@ -57,7 +57,9 @@ module Stripe
         )
       end
 
-      # Updates a Session object.
+      # Updates a Checkout Session object.
+      #
+      # Related guide: [Dynamically update Checkout](https://docs.stripe.com/payments/checkout/dynamic-updates)
       def update(session, params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/checkout_service.rb

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

data/lib/stripe/services/climate_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :orders, :products, :suppliers
 
     def initialize(requestor)
-      super(requestor)
+      super
       @orders = Stripe::Climate::OrderService.new(@requestor)
       @products = Stripe::Climate::ProductService.new(@requestor)
       @suppliers = Stripe::Climate::SupplierService.new(@requestor)

data/lib/stripe/services/credit_note_service.rb

@@ -6,25 +6,24 @@ module Stripe
     attr_reader :line_items, :preview_lines
 
     def initialize(requestor)
-      super(requestor)
+      super
       @line_items = Stripe::CreditNoteLineItemService.new(@requestor)
       @preview_lines = Stripe::CreditNotePreviewLinesService.new(@requestor)
     end
 
-    # Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces
-    # its amount_due. For a status=paid invoice, a credit note does not affect its amount_due. Instead, it can result
-    # in any combination of the following:
+    # Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice's amount_remaining (and amount_due), but not below zero.
+    # This amount is indicated by the credit note's pre_payment_amount. The excess amount is indicated by post_payment_amount, and it can result in any combination of the following:
     #
     #
-    # Refund: create a new refund (using refund_amount) or link an existing refund (using refund).
+    # Refunds: create a new refund (using refund_amount) or link existing refunds (using refunds).
     # Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized.
     # Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount).
     #
     #
-    # For post-payment credit notes the sum of the refund, credit and outside of Stripe amounts must equal the credit note total.
+    # The sum of refunds, customer balance credits, and outside of Stripe credits must equal the post_payment_amount.
     #
-    # You may issue multiple credit notes for an invoice. Each credit note will increment the invoice's pre_payment_credit_notes_amount
-    # or post_payment_credit_notes_amount depending on its status at the time of credit note creation.
+    # You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
+    # post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.
     def create(params = {}, opts = {})
       request(
         method: :post,
@@ -79,7 +78,7 @@ module Stripe
       )
     end
 
-    # Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+    # Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
     def void_credit_note(id, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/customer_balance_transaction_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class CustomerBalanceTransactionService < StripeService
-    # Creates an immutable transaction that updates the customer's credit [balance](https://stripe.com/docs/billing/customer/balance).
+    # Creates an immutable transaction that updates the customer's credit [balance](https://docs.stripe.com/docs/billing/customer/balance).
     def create(customer, params = {}, opts = {})
       request(
         method: :post,
@@ -14,7 +14,7 @@ module Stripe
       )
     end
 
-    # Returns a list of transactions that updated the customer's [balances](https://stripe.com/docs/billing/customer/balance).
+    # Returns a list of transactions that updated the customer's [balances](https://docs.stripe.com/docs/billing/customer/balance).
     def list(customer, params = {}, opts = {})
       request(
         method: :get,
@@ -25,7 +25,7 @@ module Stripe
       )
     end
 
-    # Retrieves a specific customer balance transaction that updated the customer's [balances](https://stripe.com/docs/billing/customer/balance).
+    # Retrieves a specific customer balance transaction that updated the customer's [balances](https://docs.stripe.com/docs/billing/customer/balance).
     def retrieve(customer, transaction, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/customer_cash_balance_transaction_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class CustomerCashBalanceTransactionService < StripeService
-    # Returns a list of transactions that modified the customer's [cash balance](https://stripe.com/docs/payments/customer-balance).
+    # Returns a list of transactions that modified the customer's [cash balance](https://docs.stripe.com/docs/payments/customer-balance).
     def list(customer, params = {}, opts = {})
       request(
         method: :get,
@@ -14,7 +14,7 @@ module Stripe
       )
     end
 
-    # Retrieves a specific cash balance transaction, which updated the customer's [cash balance](https://stripe.com/docs/payments/customer-balance).
+    # Retrieves a specific cash balance transaction, which updated the customer's [cash balance](https://docs.stripe.com/docs/payments/customer-balance).
     def retrieve(customer, transaction, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/customer_payment_source_service.rb

@@ -7,7 +7,7 @@ module Stripe
     #
     # If the card's owner has no default card, then the new card will become the default.
     # However, if the owner already has a default, then it will not change.
-    # To change the default, you should [update the customer](https://stripe.com/docs/api#update_customer) to have a new default_source.
+    # To change the default, you should [update the customer](https://docs.stripe.com/docs/api#update_customer) to have a new default_source.
     def create(customer, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/customer_service.rb

@@ -3,17 +3,17 @@
 
 module Stripe
   class CustomerService < StripeService
-    attr_reader :cash_balance, :balance_transactions, :cash_balance_transactions, :payment_sources, :tax_ids, :payment_methods, :funding_instructions
+    attr_reader :balance_transactions, :cash_balance, :cash_balance_transactions, :funding_instructions, :payment_methods, :payment_sources, :tax_ids
 
     def initialize(requestor)
-      super(requestor)
-      @cash_balance = Stripe::CustomerCashBalanceService.new(@requestor)
+      super
       @balance_transactions = Stripe::CustomerBalanceTransactionService.new(@requestor)
+      @cash_balance = Stripe::CustomerCashBalanceService.new(@requestor)
       @cash_balance_transactions = Stripe::CustomerCashBalanceTransactionService.new(@requestor)
+      @funding_instructions = Stripe::CustomerFundingInstructionsService.new(@requestor)
+      @payment_methods = Stripe::CustomerPaymentMethodService.new(@requestor)
       @payment_sources = Stripe::CustomerPaymentSourceService.new(@requestor)
       @tax_ids = Stripe::CustomerTaxIdService.new(@requestor)
-      @payment_methods = Stripe::CustomerPaymentMethodService.new(@requestor)
-      @funding_instructions = Stripe::CustomerFundingInstructionsService.new(@requestor)
     end
 
     # Creates a new customer object.
@@ -59,7 +59,7 @@ module Stripe
       )
     end
 
-    # Search for customers you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for customers 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/dispute_service.rb

@@ -34,7 +34,7 @@ module Stripe
 
     # When you get a dispute, contacting your customer is always the best first step. If that doesn't work, you can submit evidence to help us resolve the dispute in your favor. You can do this in your [dashboard](https://dashboard.stripe.com/disputes), but if you prefer, you can use the API to submit evidence programmatically.
     #
-    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://stripe.com/docs/disputes/categories).
+    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://docs.stripe.com/docs/disputes/categories).
     def update(dispute, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/entitlements_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :active_entitlements, :features
 
     def initialize(requestor)
-      super(requestor)
+      super
       @active_entitlements = Stripe::Entitlements::ActiveEntitlementService.new(@requestor)
       @features = Stripe::Entitlements::FeatureService.new(@requestor)
     end

data/lib/stripe/services/exchange_rate_service.rb

@@ -3,6 +3,8 @@
 
 module Stripe
   class ExchangeRateService < StripeService
+    # [Deprecated] The ExchangeRate APIs are deprecated. Please use the [FX Quotes API](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api) instead.
+    #
     # Returns a list of objects that contain the rates at which foreign currencies are converted to one another. Only shows the currencies for which Stripe supports.
     def list(params = {}, opts = {})
       request(
@@ -14,6 +16,8 @@ module Stripe
       )
     end
 
+    # [Deprecated] The ExchangeRate APIs are deprecated. Please use the [FX Quotes API](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api) instead.
+    #
     # Retrieves the exchange rates from the given currency to every supported currency.
     def retrieve(rate_id, params = {}, opts = {})
       request(

data/lib/stripe/services/file_service.rb

@@ -21,7 +21,7 @@ module Stripe
       request(method: :get, path: "/v1/files", params: params, opts: opts, base_address: :api)
     end
 
-    # Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to [access file contents](https://stripe.com/docs/file-upload#download-file-contents).
+    # Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to [access file contents](https://docs.stripe.com/docs/file-upload#download-file-contents).
     def retrieve(file, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/financial_connections/account_service.rb

@@ -7,7 +7,7 @@ module Stripe
       attr_reader :owners
 
       def initialize(requestor)
-        super(requestor)
+        super
         @owners = Stripe::FinancialConnections::AccountOwnerService.new(@requestor)
       end
 

data/lib/stripe/services/financial_connections_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :accounts, :sessions, :transactions
 
     def initialize(requestor)
-      super(requestor)
+      super
       @accounts = Stripe::FinancialConnections::AccountService.new(@requestor)
       @sessions = Stripe::FinancialConnections::SessionService.new(@requestor)
       @transactions = Stripe::FinancialConnections::TransactionService.new(@requestor)

data/lib/stripe/services/forwarding_service.rb

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

data/lib/stripe/services/identity/verification_session_service.rb

@@ -4,9 +4,9 @@
 module Stripe
   module Identity
     class VerificationSessionService < StripeService
-      # A VerificationSession object can be canceled when it is in requires_input [status](https://stripe.com/docs/identity/how-sessions-work).
+      # A VerificationSession object can be canceled when it is in requires_input [status](https://docs.stripe.com/docs/identity/how-sessions-work).
       #
-      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://stripe.com/docs/identity/verification-sessions#cancel).
+      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#cancel).
       def cancel(session, params = {}, opts = {})
         request(
           method: :post,
@@ -23,7 +23,7 @@ module Stripe
       #
       # If your API key is in test mode, verification checks won't actually process, though everything else will occur as if in live mode.
       #
-      # Related guide: [Verify your users' identity documents](https://stripe.com/docs/identity/verify-identity-documents)
+      # Related guide: [Verify your users' identity documents](https://docs.stripe.com/docs/identity/verify-identity-documents)
       def create(params = {}, opts = {})
         request(
           method: :post,
@@ -50,7 +50,7 @@ module Stripe
       # request logs, etc.
       #
       # A VerificationSession object can be redacted when it is in requires_input or verified
-      # [status](https://stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
+      # [status](https://docs.stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
       # state will automatically cancel it.
       #
       # The redaction process may take up to four days. When the redaction process is in progress, the
@@ -63,7 +63,7 @@ module Stripe
       # placeholder. The metadata field will also be erased. Redacted objects cannot be updated or
       # used for any purpose.
       #
-      # [Learn more](https://stripe.com/docs/identity/verification-sessions#redact).
+      # [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#redact).
       def redact(session, params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/identity_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :verification_reports, :verification_sessions
 
     def initialize(requestor)
-      super(requestor)
+      super
       @verification_reports = Stripe::Identity::VerificationReportService.new(@requestor)
       @verification_sessions = Stripe::Identity::VerificationSessionService.new(@requestor)
     end

data/lib/stripe/services/invoice_payment_service.rb

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class InvoicePaymentService < StripeService
+    # When retrieving an invoice, there is an includable payments property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of payments.
+    def list(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/invoice_payments",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves the invoice payment with the given ID.
+    def retrieve(invoice_payment, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/invoice_payments/%<invoice_payment>s", { invoice_payment: CGI.escape(invoice_payment) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/invoice_service.rb

@@ -3,12 +3,11 @@
 
 module Stripe
   class InvoiceService < StripeService
-    attr_reader :line_items, :upcoming_lines
+    attr_reader :line_items
 
     def initialize(requestor)
-      super(requestor)
+      super
       @line_items = Stripe::InvoiceLineItemService.new(@requestor)
-      @upcoming_lines = Stripe::InvoiceUpcomingLinesService.new(@requestor)
     end
 
     # Adds multiple line items to an invoice. This is only possible when an invoice is still a draft.
@@ -22,16 +21,38 @@ module Stripe
       )
     end
 
-    # This endpoint creates a draft invoice for a given customer. The invoice remains a draft until you [finalize the invoice, which allows you to [pay](#pay_invoice) or <a href="#send_invoice">send](https://stripe.com/docs/api#finalize_invoice) the invoice to your customers.
+    # Attaches a PaymentIntent or an Out of Band Payment to the invoice, adding it to the list of payments.
+    #
+    # For the PaymentIntent, when the PaymentIntent's status changes to succeeded, the payment is credited
+    # to the invoice, increasing its amount_paid. When the invoice is fully paid, the
+    # invoice's status becomes paid.
+    #
+    # If the PaymentIntent's status is already succeeded when it's attached, it's
+    # credited to the invoice immediately.
+    #
+    # See: [Partial payments](https://docs.stripe.com/docs/invoicing/partial-payments) to learn more.
+    def attach_payment(invoice, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/invoices/%<invoice>s/attach_payment", { invoice: CGI.escape(invoice) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # This endpoint creates a draft invoice for a given customer. The invoice remains a draft until you [finalize the invoice, which allows you to [pay](#pay_invoice) or <a href="#send_invoice">send](https://docs.stripe.com/api#finalize_invoice) the invoice to your customers.
     def create(params = {}, opts = {})
       request(method: :post, path: "/v1/invoices", params: params, opts: opts, base_address: :api)
     end
 
-    # At any time, you can preview the upcoming invoice for a customer. This will show you all the charges that are pending, including subscription renewal charges, invoice item charges, etc. It will also show you any discounts that are applicable to the invoice.
+    # At any time, you can preview the upcoming invoice for a subscription or subscription schedule. This will show you all the charges that are pending, including subscription renewal charges, invoice item charges, etc. It will also show you any discounts that are applicable to the invoice.
     #
-    # Note that when you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. If you want to change the amount that your customer will be billed, you can add, remove, or update pending invoice items, or update the customer's discount.
+    # You can also preview the effects of creating or updating a subscription or subscription schedule, including a preview of any prorations that will take place. To ensure that the actual proration is calculated exactly the same as the previewed proration, you should pass the subscription_details.proration_date parameter when doing the actual subscription update.
+    #
+    # The recommended way to get only the prorations being previewed on the invoice is to consider line items where parent.subscription_item_details.proration is true.
     #
-    # You can preview the effects of updating a subscription, including a preview of what proration will take place. To ensure that the actual proration is calculated exactly the same as the previewed proration, you should pass the subscription_details.proration_date parameter when doing the actual subscription update. The recommended way to get only the prorations being previewed is to consider only proration line items where period[start] is equal to the subscription_details.proration_date value passed in the request.
+    # Note that when you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. If you want to change the amount that your customer will be billed, you can add, remove, or update pending invoice items, or update the customer's discount.
     #
     # Note: Currency conversion calculations use the latest exchange rates. Exchange rates may vary between the time of the preview and the time of the actual invoice creation. [Learn more](https://docs.stripe.com/currencies/conversions)
     def create_preview(params = {}, opts = {})
@@ -44,7 +65,7 @@ module Stripe
       )
     end
 
-    # Permanently deletes a one-off invoice draft. This cannot be undone. Attempts to delete invoices that are no longer in a draft state will fail; once an invoice has been finalized or if an invoice is for a subscription, it must be [voided](https://stripe.com/docs/api#void_invoice).
+    # Permanently deletes a one-off invoice draft. This cannot be undone. Attempts to delete invoices that are no longer in a draft state will fail; once an invoice has been finalized or if an invoice is for a subscription, it must be [voided](https://docs.stripe.com/api#void_invoice).
     def delete(invoice, params = {}, opts = {})
       request(
         method: :delete,
@@ -115,7 +136,7 @@ module Stripe
       )
     end
 
-    # Search for invoices you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for invoices 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.
@@ -142,28 +163,11 @@ module Stripe
       )
     end
 
-    # At any time, you can preview the upcoming invoice for a customer. This will show you all the charges that are pending, including subscription renewal charges, invoice item charges, etc. It will also show you any discounts that are applicable to the invoice.
-    #
-    # Note that when you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. If you want to change the amount that your customer will be billed, you can add, remove, or update pending invoice items, or update the customer's discount.
-    #
-    # You can preview the effects of updating a subscription, including a preview of what proration will take place. To ensure that the actual proration is calculated exactly the same as the previewed proration, you should pass the subscription_details.proration_date parameter when doing the actual subscription update. The recommended way to get only the prorations being previewed is to consider only proration line items where period[start] is equal to the subscription_details.proration_date value passed in the request.
-    #
-    # Note: Currency conversion calculations use the latest exchange rates. Exchange rates may vary between the time of the preview and the time of the actual invoice creation. [Learn more](https://docs.stripe.com/currencies/conversions)
-    def upcoming(params = {}, opts = {})
-      request(
-        method: :get,
-        path: "/v1/invoices/upcoming",
-        params: params,
-        opts: opts,
-        base_address: :api
-      )
-    end
-
-    # Draft invoices are fully editable. Once an invoice is [finalized](https://stripe.com/docs/billing/invoices/workflow#finalized),
+    # Draft invoices are fully editable. Once an invoice is [finalized](https://docs.stripe.com/docs/billing/invoices/workflow#finalized),
     # monetary values, as well as collection_method, become uneditable.
     #
     # If you would like to stop the Stripe Billing engine from automatically finalizing, reattempting payments on,
-    # sending reminders for, or [automatically reconciling](https://stripe.com/docs/billing/invoices/reconciliation) invoices, pass
+    # sending reminders for, or [automatically reconciling](https://docs.stripe.com/docs/billing/invoices/reconciliation) invoices, pass
     # auto_advance=false.
     def update(invoice, params = {}, opts = {})
       request(
@@ -186,9 +190,9 @@ module Stripe
       )
     end
 
-    # Mark a finalized invoice as void. This cannot be undone. Voiding an invoice is similar to [deletion](https://stripe.com/docs/api#delete_invoice), however it only applies to finalized invoices and maintains a papertrail where the invoice can still be found.
+    # Mark a finalized invoice as void. This cannot be undone. Voiding an invoice is similar to [deletion](https://docs.stripe.com/api#delete_invoice), however it only applies to finalized invoices and maintains a papertrail where the invoice can still be found.
     #
-    # Consult with local regulations to determine whether and how an invoice might be amended, canceled, or voided in the jurisdiction you're doing business in. You might need to [issue another invoice or <a href="#create_credit_note">credit note](https://stripe.com/docs/api#create_invoice) instead. Stripe recommends that you consult with your legal counsel for advice specific to your business.
+    # Consult with local regulations to determine whether and how an invoice might be amended, canceled, or voided in the jurisdiction you're doing business in. You might need to [issue another invoice or <a href="#create_credit_note">credit note](https://docs.stripe.com/api#create_invoice) instead. Stripe recommends that you consult with your legal counsel for advice specific to your business.
     def void_invoice(invoice, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/issuing/authorization_service.rb

@@ -4,8 +4,8 @@
 module Stripe
   module Issuing
     class AuthorizationService < StripeService
-      # [Deprecated] Approves a pending Issuing Authorization object. This request should be made within the timeout window of the [real-time authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations) flow.
-      # This method is deprecated. Instead, [respond directly to the webhook request to approve an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
+      # [Deprecated] Approves a pending Issuing Authorization object. This request should be made within the timeout window of the [real-time authorization](https://docs.stripe.com/docs/issuing/controls/real-time-authorizations) flow.
+      # This method is deprecated. Instead, [respond directly to the webhook request to approve an authorization](https://docs.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
       def approve(authorization, params = {}, opts = {})
         request(
           method: :post,
@@ -16,8 +16,8 @@ module Stripe
         )
       end
 
-      # [Deprecated] Declines a pending Issuing Authorization object. This request should be made within the timeout window of the [real time authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations) flow.
-      # This method is deprecated. Instead, [respond directly to the webhook request to decline an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
+      # [Deprecated] Declines a pending Issuing Authorization object. This request should be made within the timeout window of the [real time authorization](https://docs.stripe.com/docs/issuing/controls/real-time-authorizations) flow.
+      # This method is deprecated. Instead, [respond directly to the webhook request to decline an authorization](https://docs.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
       def decline(authorization, params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/issuing/dispute_service.rb

@@ -4,7 +4,7 @@
 module Stripe
   module Issuing
     class DisputeService < StripeService
-      # Creates an Issuing Dispute object. Individual pieces of evidence within the evidence object are optional at this point. Stripe only validates that required evidence is present during submission. Refer to [Dispute reasons and evidence](https://stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence) for more details about evidence requirements.
+      # Creates an Issuing Dispute object. Individual pieces of evidence within the evidence object are optional at this point. Stripe only validates that required evidence is present during submission. Refer to [Dispute reasons and evidence](https://docs.stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence) for more details about evidence requirements.
       def create(params = {}, opts = {})
         request(
           method: :post,
@@ -37,7 +37,7 @@ module Stripe
         )
       end
 
-      # Submits an Issuing Dispute to the card network. Stripe validates that all evidence fields required for the dispute's reason are present. For more details, see [Dispute reasons and evidence](https://stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence).
+      # Submits an Issuing Dispute to the card network. Stripe validates that all evidence fields required for the dispute's reason are present. For more details, see [Dispute reasons and evidence](https://docs.stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence).
       def submit(dispute, params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/issuing_service.rb

@@ -6,7 +6,7 @@ module Stripe
     attr_reader :authorizations, :cards, :cardholders, :disputes, :personalization_designs, :physical_bundles, :tokens, :transactions
 
     def initialize(requestor)
-      super(requestor)
+      super
       @authorizations = Stripe::Issuing::AuthorizationService.new(@requestor)
       @cards = Stripe::Issuing::CardService.new(@requestor)
       @cardholders = Stripe::Issuing::CardholderService.new(@requestor)