stripe 10.15.0 → 11.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c6299b4afca3ee89da389e6dc45eee600eba9f3dfa66fa7120826e4dc9ce006
-  data.tar.gz: 66073d85adc239428168012cc7585401347ea5ac4384ec910e13aa49c2d44dcb
+  metadata.gz: 10d590e76f5c8524bee12dc767dee9b845fa9732aa4eed9621d0c10d05dfef4c
+  data.tar.gz: 803b1a9728c6322b40cce127b3464e1abff35c2ad515a73ec2b11ae1fe5b0476
 SHA512:
-  metadata.gz: 8535cb9457a19a0acbf7d3faf0e77efc0b457f36c30adc80196b53d771db7f7170da9517f9f0cbb656ed6701411f34ba981f64e2f5f7256e67f66662d7e3f57a
-  data.tar.gz: 1a8732f5540d740710a136fbe0a3c29f56b6d4ed904411fcec573aa30901d38a84830795c0f03aee4dc6e670fa35ed189c230c361f3e9776b9912af9af7c7892
+  metadata.gz: 9f324debcf2d8d68f425a1fd934d981656f695d8440ca3c4cef5dab5b618d56407e324420b0ceee896f69c21281133d8fe4fb931b9bca34a9fece9fc281b6ef3
+  data.tar.gz: 6d17556b19ccac9ce7d9a102b6a3d7984b042f98fcaeb3014dd177a232fba50897bbba9b2ddf6addc76fad6a99b607e4f0069c994047e38217f53ee81b61ed7c

data/CHANGELOG.md

@@ -1,4 +1,47 @@
 # Changelog
+## 11.7.0 - 2024-06-13
+* [#1415](https://github.com/stripe/stripe-ruby/pull/1415) Deprecate StripeClient#request
+  * Add deprecation warning for `StripeClient#request`. This helper method will be removed in a future major version. To access response objects, use the `last_response` property on the returned resource instead. Refer to [Accessing a response object](https://github.com/stripe/stripe-ruby?tab=readme-ov-file#accessing-a-response-object) in the README for usage details.
+
+## 11.6.0 - 2024-05-30
+* [#1404](https://github.com/stripe/stripe-ruby/pull/1404) Add method to list invoice line items
+  * Add methods `list_lines()` on the class `Invoice` to list the invoice line items
+
+## 11.5.0 - 2024-05-23
+* This release has no changes.
+
+## 11.4.0 - 2024-05-09
+* [#1397](https://github.com/stripe/stripe-ruby/pull/1397) Update generated code
+  * Add support for `update` test helper method on resources `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
+* [#1399](https://github.com/stripe/stripe-ruby/pull/1399) Pass params to transfer reversal
+  * Allow `Stripe::Transfer.retrieve_reversal()` to accept a params hash as the third argument, followed by opts. No changes to existing calls are necessary, but in a future major version this method will be updated to only accept params as the first argument. Fixes [#1393](https://github.com/stripe/stripe-ruby/issues/1393)
+* [#1389](https://github.com/stripe/stripe-ruby/pull/1389) Removed jaro_winkler as a dependency
+* [#1396](https://github.com/stripe/stripe-ruby/pull/1396) Start tracking `StripeClient#request` usage
+
+## 11.3.0 - 2024-05-02
+* [#1387](https://github.com/stripe/stripe-ruby/pull/1387) Update generated code
+
+* [#1392](https://github.com/stripe/stripe-ruby/pull/1392) Deprecate Ruby methods based on OpenAPI spec
+  - Mark as deprecated the `approve` and `decline` methods in `lib/stripe/resources/issuing/authorization.rb`. Instead, [respond directly to the webhook request to approve an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
+* [#1391](https://github.com/stripe/stripe-ruby/pull/1391) Add Ruby 3.3 to CI test matrix
+
+## 11.2.0 - 2024-04-18
+* [#1385](https://github.com/stripe/stripe-ruby/pull/1385) Update generated code
+  * Add support for `create_preview` method on resource `Invoice`
+
+## 11.1.0 - 2024-04-16
+* [#1379](https://github.com/stripe/stripe-ruby/pull/1379) Update generated code
+  * Add support for new resource `Entitlements.ActiveEntitlementSummary`
+
+## 11.0.0 - 2024-04-10
+* [#1374](https://github.com/stripe/stripe-ruby/pull/1374)
+
+  * This release changes the pinned API version to `2024-04-10`. Please read the [API Upgrade Guide](https://stripe.com/docs/upgrades#2024-04-10) and carefully review the API changes before upgrading.
+
+  ### ⚠️ Breaking changes
+
+  * When no `x-stripe-should-retry` header is set in the response, the library now retries all requests with `status >= 500`, not just non-POST methods.
+
 ## 10.15.0 - 2024-04-09
 * [#1377](https://github.com/stripe/stripe-ruby/pull/1377) Add last_response to StripeObject
   * Users can now retrieve raw response from the returned resource, using the `last_response` property. See [README](https://github.com/stripe/stripe-ruby/blob/master/README.md) for an example.
@@ -138,32 +181,32 @@
 **⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️**
 
 * [#1253](https://github.com/stripe/stripe-ruby/pull/1253) [#1260](https://github.com/stripe/stripe-ruby/pull/1260) Pin latest API version as the default
-  
+
   In this release, Stripe API Version `2023-08-16` (the latest at time of release) will be sent by default on all requests. This is a significant change with wide ramifications. The API version affects the properties you see on responses, the parameters you are allowed to send on requests, and so on. The previous default was to use your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version).
-  
+
   To successfully upgrade to stripe-ruby v9, you must either
-  
+
   1. **(Recommended) Upgrade your integration to be compatible with API Version `2023-08-16`.**
-  
+
      Please read the API Changelog carefully for each API Version from `2023-08-16` back to your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version). Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe [Test Mode](https://stripe.com/docs/keys#test-live-modes) before deploying them to production.
-  
+
      You can read the [v9 migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v9) for more detailed instructions.
   2. **(Alternative option) Specify a version other than `2023-08-16` when initializing `stripe-ruby`.**
-  
+
      If you were previously initializing stripe-ruby without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version). For example:
-  
+
      ```diff
        require 'stripe'
        Stripe.api_key = "sk_test_..."
      + Stripe.api_version = '2020-08-27'
      ```
-  
+
      If you were already initializing stripe-ruby with an explicit API Version, upgrading to v9 will not affect your integration.
-  
+
      Read the [v9 migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v9) for more details.
-  
+
   Going forward, each major release of this library will be *pinned* by default to the latest Stripe API Version at the time of release.
-  
+
   That is, instead of upgrading stripe-ruby and separately upgrading your Stripe API Version through the Stripe Dashboard. whenever you upgrade major versions of stripe-ruby, you should also upgrade your integration to be compatible with the latest Stripe API version.
 
 ## 8.7.0 - 2023-08-10
@@ -190,7 +233,7 @@
 
 * [#1225](https://github.com/stripe/stripe-ruby/pull/1225) Downgrade jaro_winkler
 * [#1219](https://github.com/stripe/stripe-ruby/pull/1219) Update generated code
-  
+
   Documentation updates.
 * [#1215](https://github.com/stripe/stripe-ruby/pull/1215) Update generated code
 
@@ -238,7 +281,7 @@ Breaking changes that arose during code generation of the library that we postpo
   refund = Stripe::Refund.retrieve("re_123")
   refund.description = "Refund description"
   refund.save
-  
+
   # after
   Stripe::Refund.update("re_123", description: "Refund description")
   ```
@@ -302,7 +345,7 @@ Breaking changes that arose during code generation of the library that we postpo
 * [#1072](https://github.com/stripe/stripe-ruby/pull/1072) Trigger workflows on beta branches
 * [#1071](https://github.com/stripe/stripe-ruby/pull/1071) Use request_stripe_object for all requests
 * [#1070](https://github.com/stripe/stripe-ruby/pull/1070) API Updates
-  
+
   Switch from using meta-programing to generating explicit methods for custom methods.
 * [#1069](https://github.com/stripe/stripe-ruby/pull/1069) chore: Stop special implementation of Account.persons method.
 
@@ -318,15 +361,15 @@ Breaking changes that arose during code generation of the library that we postpo
   * Add support for new resources `Treasury.CreditReversal`, `Treasury.DebitReversal`, `Treasury.FinancialAccountFeatures`, `Treasury.FinancialAccount`, `Treasury.FlowDetails`, `Treasury.InboundTransfer`, `Treasury.OutboundPayment`, `Treasury.OutboundTransfer`, `Treasury.ReceivedCredit`, `Treasury.ReceivedDebit`, `Treasury.TransactionEntry`, and `Treasury.Transaction`
   * Add support for `retrieve_payment_method` method on resource `Customer`
   * Add support for `list_owners` and `list` methods on resource `FinancialConnections.Account`
-  
-  
+
+
 
 ## 6.0.0 - 2022-05-09
 * [#1056](https://github.com/stripe/stripe-ruby/pull/1056) API Updates
   Major version release. The [migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-Guide-for-v6) contains more information.
-  
+
   (⚠️ = breaking changes):
-  * ⚠️ Replace the legacy `Order` API with the new `Order` API. 
+  * ⚠️ Replace the legacy `Order` API with the new `Order` API.
     * New methods: `cancel`, `list_line_items`, `reopen`, and `submit`
     * Removed methods: `pay` and `return_order`
     * Removed resources: `OrderItem` and `OrderReturn`
@@ -335,7 +378,7 @@ Breaking changes that arose during code generation of the library that we postpo
 ## 5.55.0 - 2022-05-05
 * [#1055](https://github.com/stripe/stripe-ruby/pull/1055) API Updates
   * Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
-  
+
 
 ## 5.54.0 - 2022-05-03
 * [#1053](https://github.com/stripe/stripe-ruby/pull/1053) API Updates
@@ -346,7 +389,7 @@ Breaking changes that arose during code generation of the library that we postpo
   * Add support for `expire` test helper method on resource `Refund`
 
 ## 5.52.0 - 2022-04-18
-* [#1046](https://github.com/stripe/stripe-ruby/pull/1046) [#1047](https://github.com/stripe/stripe-ruby/pull/1047) API Updates 
+* [#1046](https://github.com/stripe/stripe-ruby/pull/1046) [#1047](https://github.com/stripe/stripe-ruby/pull/1047) API Updates
   * Add support for new resources `FundingInstructions` and `Terminal.Configuration`
 
 ## 5.51.0 - 2022-04-15
@@ -368,7 +411,7 @@ Breaking changes that arose during code generation of the library that we postpo
 * [#1040](https://github.com/stripe/stripe-ruby/pull/1040) API Updates
   * Add support for Search API
     * Add support for `search` method on resources `Charge`, `Customer`, `Invoice`, `PaymentIntent`, `Price`, `Product`, and `Subscription`
-  
+
 * [#1034](https://github.com/stripe/stripe-ruby/pull/1034) Add supporting classes for test helper generation
 
 ## 5.46.0 - 2022-03-23

data/Gemfile

@@ -27,10 +27,6 @@ group :development do
   # The latest version of rubocop is only compatible with Ruby 2.7+
   gem "rubocop", "1.57.2" if RUBY_VERSION >= "2.7"
 
-  # jaro_winkler 1.5.5 installation fails for jruby
-  # don't install on truffleruby
-  gem "jaro_winkler", "1.5.4" unless RUBY_ENGINE == "truffleruby"
-
   gem "sorbet"
   gem "tapioca"
 

data/OPENAPI_VERSION

@@ -1 +1 @@
-v938
+v1011

data/VERSION

@@ -1 +1 @@
-10.15.0
+11.7.0

data/lib/stripe/api_operations/nested_resource.rb

@@ -35,6 +35,7 @@ module Stripe
         end
       end
 
+      # rubocop:disable Metrics/MethodLength
       private def define_operation(
         resource,
         operation,
@@ -53,12 +54,30 @@ module Stripe
             )
           end
         when :retrieve
+          # TODO: (Major) Split params_or_opts to params and opts and get rid of the complicated way to add params
           define_singleton_method(:"retrieve_#{resource}") \
-              do |id, nested_id, opts = {}|
+              do |id, nested_id, params_or_opts = {}, definitely_opts = nil|
+            opts = nil
+            params = nil
+            if definitely_opts.nil?
+              unrecognized_key = params_or_opts.keys.find { |k| !Util::OPTS_USER_SPECIFIED.include?(k) }
+              if unrecognized_key
+                raise ArgumentError,
+                      "Unrecognized request option: #{unrecognized_key}. Did you mean to specify this as " \
+                      "retrieve params? " \
+                      "If so, you must explicitly pass an opts hash as a fourth argument. " \
+                      "For example: .retrieve(#{id}, #{nested_id}, {#{unrecognized_key}: 'foo'}, {})"
+              end
+
+              opts = params_or_opts
+            else
+              opts = definitely_opts
+              params = params_or_opts
+            end
             request_stripe_object(
               method: :get,
               path: send(resource_url_method, id, nested_id),
-              params: {},
+              params: params,
               opts: opts
             )
           end
@@ -96,6 +115,7 @@ module Stripe
           raise ArgumentError, "Unknown operation: #{operation.inspect}"
         end
       end
+      # rubocop:enable Metrics/MethodLength
     end
   end
 end

data/lib/stripe/api_version.rb

@@ -3,6 +3,6 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2023-10-16"
+    CURRENT = "2024-04-10"
   end
 end

data/lib/stripe/object_types.rb

@@ -12,7 +12,7 @@ module Stripe
         SearchResultObject.object_name => SearchResultObject,
         File.object_name_alt => File,
 
-        # The beginning of the section generated from our OpenAPI spec
+        # object classes: The beginning of the section generated from our OpenAPI spec
         Account.object_name => Account,
         AccountLink.object_name => AccountLink,
         AccountSession.object_name => AccountSession,
@@ -139,7 +139,7 @@ module Stripe
         UsageRecord.object_name => UsageRecord,
         UsageRecordSummary.object_name => UsageRecordSummary,
         WebhookEndpoint.object_name => WebhookEndpoint,
-        # The end of the section generated from our OpenAPI spec
+        # object classes: The end of the section generated from our OpenAPI spec
       }
     end
   end

data/lib/stripe/resources/account.rb

@@ -6,9 +6,14 @@ module Stripe
   # properties on the account like its current requirements or if the account is
   # enabled to make live charges or receive payouts.
   #
-  # For Custom accounts, the properties below are always returned. For other accounts, some properties are returned until that
-  # account has started to go through Connect Onboarding. Once you create an [Account Link](https://stripe.com/docs/api/account_links) or [Account Session](https://stripe.com/docs/api/account_sessions),
-  # some properties are only returned for Custom accounts. Learn about the differences [between accounts](https://stripe.com/docs/connect/accounts).
+  # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection)
+  # is `application`, which includes Custom accounts, the properties below are always
+  # returned.
+  #
+  # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection)
+  # is `stripe`, which includes Standard and Express accounts, some properties are only returned
+  # until you create an [Account Link](https://stripe.com/api/account_links) or [Account Session](https://stripe.com/api/account_sessions)
+  # to start Connect Onboarding. Learn about the [differences between accounts](https://stripe.com/connect/accounts).
   class Account < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
@@ -39,9 +44,11 @@ module Stripe
       request_stripe_object(method: :post, path: "/v1/accounts", params: params, opts: opts)
     end
 
-    # With [Connect](https://stripe.com/docs/connect), you can delete accounts you manage.
+    # With [Connect](https://stripe.com/connect), you can delete accounts you manage.
+    #
+    # Test-mode accounts can be deleted at any time.
     #
-    # Accounts created using test-mode keys can be deleted at any time. Standard accounts created using live-mode keys cannot be deleted. Custom or Express accounts created using live-mode keys can only be deleted once all balances are zero.
+    # Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://stripe.com/api/balance/balanace_object) are zero.
     #
     # If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
     def self.delete(id, params = {}, opts = {})
@@ -53,9 +60,11 @@ module Stripe
       )
     end
 
-    # With [Connect](https://stripe.com/docs/connect), you can delete accounts you manage.
+    # With [Connect](https://stripe.com/connect), you can delete accounts you manage.
     #
-    # Accounts created using test-mode keys can be deleted at any time. Standard accounts created using live-mode keys cannot be deleted. Custom or Express accounts created using live-mode keys can only be deleted once all balances are zero.
+    # Test-mode accounts can be deleted at any time.
+    #
+    # Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://stripe.com/api/balance/balanace_object) are zero.
     #
     # If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
     def delete(params = {}, opts = {})
@@ -92,9 +101,9 @@ module Stripe
       )
     end
 
-    # With [Connect](https://stripe.com/docs/connect), you may flag accounts as suspicious.
+    # With [Connect](https://stripe.com/connect), you can reject accounts that you have flagged as suspicious.
     #
-    # Test-mode Custom and Express accounts can be rejected at any time. Accounts created using live-mode keys may only be rejected once all balances are zero.
+    # Only accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be rejected. Test-mode accounts can be rejected at any time. Live-mode accounts can only be rejected after all balances are zero.
     def reject(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -104,9 +113,9 @@ module Stripe
       )
     end
 
-    # With [Connect](https://stripe.com/docs/connect), you may flag accounts as suspicious.
+    # With [Connect](https://stripe.com/connect), you can reject accounts that you have flagged as suspicious.
     #
-    # Test-mode Custom and Express accounts can be rejected at any time. Accounts created using live-mode keys may only be rejected once all balances are zero.
+    # Only accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be rejected. Test-mode accounts can be rejected at any time. Live-mode accounts can only be rejected after all balances are zero.
     def self.reject(account, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -116,12 +125,16 @@ module Stripe
       )
     end
 
-    # Updates a [connected account](https://stripe.com/docs/connect/accounts) by setting the values of the parameters passed. Any parameters not provided are
+    # Updates a [connected account](https://stripe.com/connect/accounts) by setting the values of the parameters passed. Any parameters not provided are
     # left unchanged.
     #
-    # For Custom accounts, you can update any information on the account. For other accounts, you can update all information until that
-    # account has started to go through Connect Onboarding. Once you create an [Account Link or <a href="/docs/api/account_sessions">Account Session](https://stripe.com/docs/api/account_links),
-    # some properties can only be changed or updated for Custom accounts.
+    # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection)
+    # is application, which includes Custom accounts, you can update any information on the account.
+    #
+    # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection)
+    # is stripe, which includes Standard and Express accounts, you can update all information until you create
+    # an [Account Link or <a href="/api/account_sessions">Account Session](https://stripe.com/api/account_links) to start Connect onboarding,
+    # after which some properties can no longer be updated.
     #
     # To update your own account, use the [Dashboard](https://dashboard.stripe.com/settings/account). Refer to our
     # [Connect](https://stripe.com/docs/connect/updating-accounts) documentation to learn more about updating accounts.

data/lib/stripe/resources/bank_account.rb

@@ -4,11 +4,12 @@
 module Stripe
   # These bank accounts are payment methods on `Customer` objects.
   #
-  # On the other hand [External Accounts](https://stripe.com/docs/api#external_accounts) are transfer
-  # destinations on `Account` objects for [Custom accounts](https://stripe.com/docs/connect/custom-accounts).
+  # On the other hand [External Accounts](https://stripe.com/api#external_accounts) are transfer
+  # destinations on `Account` objects for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection)
+  # is `application`, which includes [Custom accounts](https://stripe.com/connect/custom-accounts).
   # They can be bank accounts or debit cards as well, and are documented in the links above.
   #
-  # Related guide: [Bank debits and transfers](https://stripe.com/docs/payments/bank-debits-transfers)
+  # Related guide: [Bank debits and transfers](https://stripe.com/payments/bank-debits-transfers)
   class BankAccount < APIResource
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List

data/lib/stripe/resources/billing/meter.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module Billing
-    # A billing meter is a resource that allows you to track usage of a particular event. For example, you might create a billing meter to track the number of API calls made by a particular user. You can then use the billing meter to charge the user for the number of API calls they make.
+    # A billing meter is a resource that allows you to track usage of a particular event. For example, you might create a billing meter to track the number of API calls made by a particular user. You can then attach the billing meter to a price and attach the price to a subscription to charge the user for the number of API calls they make.
     class Meter < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List

data/lib/stripe/resources/billing/meter_event_adjustment.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module Billing
-    # A billing meter event adjustment represents the status of a meter event adjustment.
+    # A billing meter event adjustment is a resource that allows you to cancel a meter event. For example, you might create a billing meter event adjustment to cancel a meter event that was created in error or attached to the wrong customer.
     class MeterEventAdjustment < APIResource
       extend Stripe::APIOperations::Create
 

data/lib/stripe/resources/event.rb

@@ -23,10 +23,10 @@ module Stripe
   # `Event` objects directly to an endpoint on your server. You can manage
   # webhooks in your
   # [account settings](https://dashboard.stripe.com/account/webhooks). Learn how
-  # to [listen for events](https://stripe.com/docs/webhooks)
+  # to [listen for events](https://docs.stripe.com/webhooks)
   # so that your integration can automatically trigger reactions.
   #
-  # When using [Connect](https://stripe.com/docs/connect), you can also receive event notifications
+  # When using [Connect](https://docs.stripe.com/connect), you can also receive event notifications
   # that occur in connected accounts. For these events, there's an
   # additional `account` attribute in the received `Event` object.
   #
@@ -40,7 +40,7 @@ module Stripe
       "event"
     end
 
-    # List events, going back up to 30 days. Each event data is rendered according to Stripe API version at its creation time, specified in [event object](https://stripe.com/docs/api/events/object) api_version attribute (not according to your current Stripe API version or Stripe-Version header).
+    # List events, going back up to 30 days. Each event data is rendered according to Stripe API version at its creation time, specified in [event object](https://docs.stripe.com/api/events/object) api_version attribute (not according to your current Stripe API version or Stripe-Version header).
     def self.list(filters = {}, opts = {})
       request_stripe_object(method: :get, path: "/v1/events", params: filters, opts: opts)
     end

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

@@ -3,9 +3,9 @@
 
 module Stripe
   module Forwarding
-    # Instructs Stripe to make a request on your behalf using the destination URL and HTTP method in the config.
-    # A config is set up for each destination URL by Stripe at the time of onboarding. Stripe verifies requests with
-    # your credentials in the config, and injects card details from the payment_method into the request.
+    # Instructs Stripe to make a request on your behalf using the destination URL. The destination URL
+    # is activated by Stripe at the time of onboarding. Stripe verifies requests with your credentials
+    # provided during onboarding, and injects card details from the payment_method into the request.
     #
     # Stripe redacts all sensitive fields and headers, including authentication credentials and card numbers,
     # before storing the request and response data in the forwarding Request object, which are subject to a

data/lib/stripe/resources/invoice.rb

@@ -38,6 +38,7 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    extend Stripe::APIOperations::NestedResource
     extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
 
@@ -46,11 +47,29 @@ module Stripe
       "invoice"
     end
 
+    nested_resource_class_methods :line, operations: %i[list]
+
     # 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.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/invoices", params: params, opts: opts)
     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 self.create_preview(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: "/v1/invoices/create_preview",
+        params: params,
+        opts: opts
+      )
+    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).
     def self.delete(id, params = {}, opts = {})
       request_stripe_object(
@@ -182,7 +201,9 @@ module Stripe
     #
     # 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_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_proration_date value passed in the request.
+    # 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 self.upcoming(params = {}, opts = {})
       request_stripe_object(method: :get, path: "/v1/invoices/upcoming", params: params, opts: opts)
     end

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

@@ -9,6 +9,7 @@ module Stripe
     #
     # Related guide: [Issued card authorizations](https://stripe.com/docs/issuing/purchases/authorizations)
     class Authorization < APIResource
+      extend Gem::Deprecate
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 
@@ -27,6 +28,7 @@ module Stripe
           opts: opts
         )
       end
+      deprecate :approve, :none, 2024, 3
 
       # [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).
@@ -38,6 +40,10 @@ module Stripe
           opts: opts
         )
       end
+      class << self
+        extend Gem::Deprecate
+        deprecate :approve, :none, 2024, 3
+      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).
@@ -49,6 +55,7 @@ module Stripe
           opts: opts
         )
       end
+      deprecate :decline, :none, 2024, 3
 
       # [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).
@@ -60,6 +67,10 @@ module Stripe
           opts: opts
         )
       end
+      class << self
+        extend Gem::Deprecate
+        deprecate :decline, :none, 2024, 3
+      end
 
       # Returns a list of Issuing Authorization objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
       def self.list(filters = {}, opts = {})

data/lib/stripe/resources/login_link.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Login Links are single-use login link for an Express account to access their Stripe dashboard.
+  # Login Links are single-use URLs for a connected account to access the Express Dashboard. The connected account's [account.controller.stripe_dashboard.type](https://stripe.com/api/accounts/object#account_object-controller-stripe_dashboard-type) must be `express` to have access to the Express Dashboard.
   class LoginLink < APIResource
     OBJECT_NAME = "login_link"
     def self.object_name

data/lib/stripe/resources/person.rb

@@ -4,10 +4,9 @@
 module Stripe
   # This is an object representing a person associated with a Stripe account.
   #
-  # A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account.
-  # See the [Standard onboarding](https://stripe.com/docs/connect/standard-accounts) or [Express onboarding documentation](https://stripe.com/docs/connect/express-accounts) for information about platform prefilling and account onboarding steps.
+  # A platform cannot access a person for an account where [account.controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
   #
-  # Related guide: [Handling identity verification with the API](https://stripe.com/docs/connect/handling-api-verification#person-information)
+  # See the [Standard onboarding](https://stripe.com/connect/standard-accounts) or [Express onboarding](https://stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://stripe.com/connect/handling-api-verification#person-information).
   class Person < APIResource
     include Stripe::APIOperations::Save
 

data/lib/stripe/resources/reversal.rb

@@ -14,7 +14,7 @@ module Stripe
   # transfer only if the destination account has enough balance to cover the
   # reversal.
   #
-  # Related guide: [Reversing transfers](https://stripe.com/docs/connect/separate-charges-and-transfers#reversing-transfers)
+  # Related guide: [Reverse transfers](https://stripe.com/docs/connect/separate-charges-and-transfers#reverse-transfers)
   class Reversal < APIResource
     include Stripe::APIOperations::Save
 

data/lib/stripe/resources/setup_intent.rb

@@ -8,13 +8,13 @@ module Stripe
   #
   # Create a SetupIntent when you're ready to collect your customer's payment credentials.
   # Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid.
-  # The SetupIntent transitions through multiple [statuses](https://stripe.com/docs/payments/intents#intent-statuses) as it guides
+  # The SetupIntent transitions through multiple [statuses](https://docs.stripe.com/payments/intents#intent-statuses) as it guides
   # you through the setup process.
   #
   # Successful SetupIntents result in payment credentials that are optimized for future payments.
   # For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through
-  # [Strong Customer Authentication](https://stripe.com/docs/strong-customer-authentication) during payment method collection
-  # to streamline later [off-session payments](https://stripe.com/docs/payments/setup-intents).
+  # [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection
+  # to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents).
   # If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer),
   # it automatically attaches the resulting payment method to that Customer after successful setup.
   # We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on
@@ -22,7 +22,7 @@ module Stripe
   #
   # By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
   #
-  # Related guide: [Setup Intents API](https://stripe.com/docs/payments/setup-intents)
+  # Related guide: [Setup Intents API](https://docs.stripe.com/payments/setup-intents)
   class SetupIntent < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List

data/lib/stripe/resources/token.rb

@@ -19,7 +19,7 @@ module Stripe
   #
   # You can't store or use tokens more than once. To store card or bank account
   # information for later use, create [Customer](https://stripe.com/docs/api#customers)
-  # objects or [Custom accounts](https://stripe.com/docs/api#external_accounts).
+  # objects or [External accounts](https://stripe.com/api#external_accounts).
   # [Radar](https://stripe.com/docs/radar), our integrated solution for automatic fraud protection,
   # performs best with integrations that use client-side tokenization.
   class Token < APIResource
@@ -31,7 +31,7 @@ module Stripe
     end
 
     # Creates a single-use token that represents a bank account's details.
-    # You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [Custom account](https://stripe.com/docs/api#accounts).
+    # You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/tokens", params: params, opts: opts)
     end

data/lib/stripe/resources/treasury/outbound_payment.rb

@@ -124,6 +124,26 @@ module Stripe
             opts: opts
           )
         end
+
+        # Updates a test mode created OutboundPayment with tracking details. The OutboundPayment must not be cancelable, and cannot be in the canceled or failed states.
+        def self.update(id, params = {}, opts = {})
+          request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/treasury/outbound_payments/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts
+          )
+        end
+
+        # Updates a test mode created OutboundPayment with tracking details. The OutboundPayment must not be cancelable, and cannot be in the canceled or failed states.
+        def update(params = {}, opts = {})
+          @resource.request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/treasury/outbound_payments/%<id>s", { id: CGI.escape(@resource["id"]) }),
+            params: params,
+            opts: opts
+          )
+        end
       end
     end
   end

data/lib/stripe/resources/treasury/outbound_transfer.rb

@@ -124,6 +124,26 @@ module Stripe
             opts: opts
           )
         end
+
+        # Updates a test mode created OutboundTransfer with tracking details. The OutboundTransfer must not be cancelable, and cannot be in the canceled or failed states.
+        def self.update(outbound_transfer, params = {}, opts = {})
+          request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/treasury/outbound_transfers/%<outbound_transfer>s", { outbound_transfer: CGI.escape(outbound_transfer) }),
+            params: params,
+            opts: opts
+          )
+        end
+
+        # Updates a test mode created OutboundTransfer with tracking details. The OutboundTransfer must not be cancelable, and cannot be in the canceled or failed states.
+        def update(params = {}, opts = {})
+          @resource.request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/treasury/outbound_transfers/%<outbound_transfer>s", { outbound_transfer: CGI.escape(@resource["id"]) }),
+            params: params,
+            opts: opts
+          )
+        end
       end
     end
   end

data/lib/stripe/resources/usage_record.rb

@@ -6,6 +6,8 @@ module Stripe
   # metered billing of subscription prices.
   #
   # Related guide: [Metered billing](https://stripe.com/docs/billing/subscriptions/metered-billing)
+  #
+  # This is our legacy usage-based billing API. See the [updated usage-based billing docs](https://docs.stripe.com/billing/subscriptions/usage-based).
   class UsageRecord < APIResource
     OBJECT_NAME = "usage_record"
     def self.object_name

data/lib/stripe/resources/webhook_endpoint.rb

@@ -2,13 +2,13 @@
 # frozen_string_literal: true
 
 module Stripe
-  # You can configure [webhook endpoints](https://stripe.com/docs/webhooks/) via the API to be
+  # You can configure [webhook endpoints](https://docs.stripe.com/webhooks/) via the API to be
   # notified about events that happen in your Stripe account or connected
   # accounts.
   #
   # Most users configure webhooks from [the dashboard](https://dashboard.stripe.com/webhooks), which provides a user interface for registering and testing your webhook endpoints.
   #
-  # Related guide: [Setting up webhooks](https://stripe.com/docs/webhooks/configure)
+  # Related guide: [Setting up webhooks](https://docs.stripe.com/webhooks/configure)
   class WebhookEndpoint < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete

data/lib/stripe/stripe_client.rb

@@ -18,6 +18,11 @@ module Stripe
       @system_profiler = SystemProfiler.new
       @last_request_metrics = nil
 
+      # The following attribute is only used to log whether or not
+      # StripeClient#request has been called. To be removed in a
+      # future major version.
+      @usage = []
+
       @config = case config_arg
                 when Hash
                   Stripe.config.reverse_duplicate_merge(config_arg)
@@ -110,7 +115,7 @@ module Stripe
     # both socket errors that may represent an intermittent problem and some
     # special HTTP statuses.
     def self.should_retry?(error,
-                           method:, num_retries:, config: Stripe.config)
+                           num_retries:, config: Stripe.config)
       return false if num_retries >= config.max_network_retries
 
       case error
@@ -143,15 +148,12 @@ module Stripe
         # These 429s are safe to retry.
         return true if error.http_status == 429 && error.code == "lock_timeout"
 
-        # 500 Internal Server Error
+        # Retry on 500, 503, and other internal errors.
         #
-        # We only bother retrying these for non-POST requests. POSTs end up
-        # being cached by the idempotency layer so there's no purpose in
-        # retrying them.
-        return true if error.http_status == 500 && method != :post
-
-        # 503 Service Unavailable
-        error.http_status == 503
+        # Note that we expect the stripe-should-retry header to be false
+        # in most cases when a 500 is returned, since our idempotency framework
+        # would typically replay it anyway.
+        true if error.http_status >= 500
       else
         false
       end
@@ -188,7 +190,9 @@ module Stripe
     #     client = StripeClient.new
     #     charge, resp = client.request { Charge.create }
     #
+
     def request
+      @usage = ["stripe_client_request"]
       old_stripe_client = self.class.current_thread_context.active_client
       self.class.current_thread_context.active_client = self
 
@@ -203,10 +207,14 @@ module Stripe
         res = yield
         [res, self.class.current_thread_context.last_responses[object_id]]
       ensure
+        @usage = []
         self.class.current_thread_context.active_client = old_stripe_client
         self.class.current_thread_context.last_responses.delete(object_id)
       end
     end
+    deprecate :request, "the `last_response` property on the returned resource (see " \
+                        "https://github.com/stripe/stripe-ruby?tab=readme-ov-file#accessing-a-response-object " \
+                        "for usage examples)", 2024, 6
 
     def execute_request(method, path,
                         api_base: nil, api_key: nil, headers: {}, params: {}, usage: [])
@@ -490,7 +498,7 @@ module Stripe
         end
 
       http_resp =
-        execute_request_with_rescues(method, api_base, headers, usage, context) do
+        execute_request_with_rescues(api_base, headers, usage, context) do
           self.class
               .default_connection_manager(config)
               .execute_request(method, url,
@@ -560,7 +568,7 @@ module Stripe
       http_status >= 400
     end
 
-    private def execute_request_with_rescues(method, api_base, headers, usage, context)
+    private def execute_request_with_rescues(api_base, headers, usage, context)
       num_retries = 0
 
       begin
@@ -586,7 +594,7 @@ module Stripe
         if config.enable_telemetry? && context.request_id
           request_duration_ms = (request_duration * 1000).to_i
           @last_request_metrics =
-            StripeRequestMetrics.new(context.request_id, request_duration_ms, usage: usage)
+            StripeRequestMetrics.new(context.request_id, request_duration_ms, usage: usage + @usage)
         end
 
       # We rescue all exceptions from a request so that we have an easy spot to
@@ -611,7 +619,6 @@ module Stripe
                            user_data, resp, headers)
 
         if self.class.should_retry?(e,
-                                    method: method,
                                     num_retries: num_retries,
                                     config: config)
           num_retries += 1

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "10.15.0"
+  VERSION = "11.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 10.15.0
+  version: 11.7.0
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-04-09 00:00:00.000000000 Z
+date: 2024-06-14 00:00:00.000000000 Z
 dependencies: []
 description: Stripe is the easiest way to accept payments online.  See https://stripe.com
   for details.
@@ -216,7 +216,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.3.27
 signing_key: 
 specification_version: 4
 summary: Ruby bindings for the Stripe API