stripe 10.1.0 → 12.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 161eba8138b975aa9911f0fb43639b9732d11368b870d56b2a40dc394d8ae23c
-  data.tar.gz: 49cda1fbae2fe6731646e00d795406d03bcf5cdc0f3973e700c12a3b048098db
+  metadata.gz: cec3b48108a6e34b1ebda0be0cfb3ed6eb9aa124d71577b99fdb4b6b2407e0ad
+  data.tar.gz: 11d1823bf601fd83aa44cd8262af329eb0ce1a52885c982f6a58466837a1d89a
 SHA512:
-  metadata.gz: d80cdfbfeb61f3012e1e94483adb2221a7921e12b1a3461681c592cebf95937898fd438458d1feaa351824820f4711a42ddd7d3ebc20ed02a59d9896085e0fe5
-  data.tar.gz: a8d56ab530687777b348080757e53f20dc83a0121ce5e3578e4ff7fee31ea024be48b68fef318a9d7433d1d246a84e6a97d461942986dee5d684eeb04558db2a
+  metadata.gz: 5b3931f9c3637f350e0590ad6fce034cb8449e20e5c37da258971b9e6577ea9be65cab45196798b6ae88ac04d4cf1ad99c85caa18c315c1be17ea3808133c57c
+  data.tar.gz: 94d11382678b989b6cd8dc9e81219e9a07338bc83ae704b8bcf7c1a410e7fa6e13d0aa4e22eb4256975218b20ed469ce1f28de7b1b910aa44f078b37240b9172

data/CHANGELOG.md

@@ -1,4 +1,198 @@
 # Changelog
+## 12.6.0 - 2024-09-12
+* [#1442](https://github.com/stripe/stripe-ruby/pull/1442) Update generated code
+  * Add support for new resource `InvoiceRenderingTemplate`
+  * Add support for `archive`, `list`, `retrieve`, and `unarchive` methods on resource `InvoiceRenderingTemplate`
+* [#1443](https://github.com/stripe/stripe-ruby/pull/1443) Removed v1/files override
+
+## 12.5.0 - 2024-08-08
+* [#1440](https://github.com/stripe/stripe-ruby/pull/1440) Update generated code
+  * Add support for new resources `Billing.AlertTriggered` and `Billing.Alert`
+  * Add support for `activate`, `archive`, `create`, `deactivate`, `list`, and `retrieve` methods on resource `Alert`
+  * Add support for `retrieve` method on resource `Tax.Calculation`
+
+## 12.4.0 - 2024-07-25
+* [#1437](https://github.com/stripe/stripe-ruby/pull/1437) Update generated code
+  * Add support for `update` method on resource `Checkout.Session`
+
+## 12.3.0 - 2024-07-18
+* [#1436](https://github.com/stripe/stripe-ruby/pull/1436) Fixed changelog for major release 12.0.0
+* [#1435](https://github.com/stripe/stripe-ruby/pull/1435) Add deprecation warning for `APIResource.request`
+
+## 12.2.0 - 2024-07-12
+* [#1430](https://github.com/stripe/stripe-ruby/pull/1430) Update generated code
+
+* [#1433](https://github.com/stripe/stripe-ruby/pull/1433) Add usage to raw_request call
+* [#1431](https://github.com/stripe/stripe-ruby/pull/1431) Add `raw_request`
+  
+  - Adds the ability to make raw requests to the Stripe API, by providing an HTTP method and url. This is an alternative to using `Stripe::APIResource.request(...)` to make custom requests, which is discouraged and will be broken in a future major version.
+
+## 12.1.0 - 2024-07-05
+* [#1425](https://github.com/stripe/stripe-ruby/pull/1425) Update generated code
+  * Add support for `add_lines`, `remove_lines`, and `update_lines` methods on resource `Invoice`
+* [#1420](https://github.com/stripe/stripe-ruby/pull/1420) Update static methods for delete/list on BankAccount/Card to throw NotImplementedError
+  * The below methods have been throwing `InvalidRequestError` because the urls used to make the requests have been buggy. Updating them to throw `NotImplementedError` instead just like their counterparts for update & retrieve because they cannot be implemented without the parent id. 
+  
+  Methods affected | Use these instead in the context of payment method | Use these in the context of external accounts
+  ------ | ------ | ----
+  Stripe:: BankAccount.delete | Stripe::Customer.delete_source | Stripe::Account.delete_external_account
+  Stripe:: BankAccount.list | Stripe::Customer.list_sources | Stripe::Customer.list_external_accounts
+  Stripe:: Card.delete | Stripe::Customer.delete_source | Stripe::Account.delete_external_account
+  Stripe:: Card.list | Stripe::Customer.list_sources | Stripe::Customer.list_external_accounts
+* [#1427](https://github.com/stripe/stripe-ruby/pull/1427) Regenerate rbis
+* [#1426](https://github.com/stripe/stripe-ruby/pull/1426) Remove coveralls and re-added JRuby
+
+## 12.0.0 - 2024-06-24
+* [#1418](https://github.com/stripe/stripe-ruby/pull/1418) Add missing static method for verify on BankAccount
+* [#1419](https://github.com/stripe/stripe-ruby/pull/1419) 
+  
+  This release changes the pinned API version to 2024-06-20. Please read the [API Upgrade Guide](https://stripe.com/docs/upgrades#2024-06-20) and carefully review the API changes before upgrading.
+
+  ### Additions
+  
+  * Add support for `finalize_amount` test helper method on resource `Issuing.Authorization`
+
+## 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.
+* [#1372](https://github.com/stripe/stripe-ruby/pull/1372) Update generated code
+  * Add support for new resources `Entitlements.ActiveEntitlement` and `Entitlements.Feature`
+  * Add support for `list` and `retrieve` methods on resource `ActiveEntitlement`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `Feature`
+* [#1366](https://github.com/stripe/stripe-ruby/pull/1366) Move executables to `exe` folder
+
+## 10.14.0 - 2024-03-28
+* [#1369](https://github.com/stripe/stripe-ruby/pull/1369) Update generated code
+  * Add support for new resources `Billing.MeterEventAdjustment`, `Billing.MeterEvent`, and `Billing.Meter`
+  * Add support for `create`, `deactivate`, `list`, `reactivate`, `retrieve`, and `update` methods on resource `Meter`
+  * Add support for `create` method on resources `MeterEventAdjustment` and `MeterEvent`
+
+## 10.13.0 - 2024-03-21
+* [#1367](https://github.com/stripe/stripe-ruby/pull/1367) Update generated code
+  * Add support for new resources `ConfirmationToken` and `Forwarding.Request`
+  * Add support for `retrieve` method on resource `ConfirmationToken`
+  * Add support for `create`, `list`, and `retrieve` methods on resource `Request`
+* [#1362](https://github.com/stripe/stripe-ruby/pull/1362) Exclude sorbet directory and tapioca script when packing gem
+
+## 10.12.0 - 2024-03-14
+* [#1359](https://github.com/stripe/stripe-ruby/pull/1359) Update generated code
+  * Add support for new resources `Issuing.PersonalizationDesign` and `Issuing.PhysicalBundle`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PersonalizationDesign`
+  * Add support for `list` and `retrieve` methods on resource `PhysicalBundle`
+* [#1354](https://github.com/stripe/stripe-ruby/pull/1354) Refactor after SDK based generation pattern
+* [#1347](https://github.com/stripe/stripe-ruby/pull/1347) Reorder methods with lexographical sort
+* [#1355](https://github.com/stripe/stripe-ruby/pull/1355) Disable Metrics/ClassLength
+* [#1351](https://github.com/stripe/stripe-ruby/pull/1351) Update CHANGELOG.md
+
+## 10.11.0 - 2024-02-29
+* [#1348](https://github.com/stripe/stripe-ruby/pull/1348) Use sorbet gem instead of sorbet-static
+* [#1342](https://github.com/stripe/stripe-ruby/pull/1342) Update generated code
+  * Add `list_refunds` and `retrieve_refund` methods on resource `Charge`.
+* [#1345](https://github.com/stripe/stripe-ruby/pull/1345) Update README to use add_beta_version
+
+## 10.10.0 - 2024-02-22
+* [#1336](https://github.com/stripe/stripe-ruby/pull/1336) Update generated code
+  - Add `InvoiceLineItem.update` method.
+* [#1334](https://github.com/stripe/stripe-ruby/pull/1334) Add TaxIds API
+  * Add support for `all`, `create`, and `retrieve` methods on resource `TaxId`
+  * The `delete` method now sends a DELETE request to `/v1/tax_ids/{id}` instead of `/v1/customers/{customer}/tax_ids/{id}`. The endpoints are functionally the same when operating on a Customer Tax ID.
+  * The `resource_url` method on `TaxId` now returns the top-level `/v1/tax_ids/{id}` path instead of the `/v1/customers/{customer}/tax_ids/{id}` path.
+
+## 10.9.0 - 2024-02-15
+* [#1329](https://github.com/stripe/stripe-ruby/pull/1329) Update generated code
+  * Fixed bug where `TaxId` resource `delete` method sent request to wrong URL (https://github.com/stripe/stripe-ruby/issues/1333)
+* [#1324](https://github.com/stripe/stripe-ruby/pull/1324) Start running Sorbet in CI
+* [#1327](https://github.com/stripe/stripe-ruby/pull/1327) Add methods for dynamically referenced constants
+
+## 10.8.0 - 2024-02-08
+* [#1322](https://github.com/stripe/stripe-ruby/pull/1322) Update generated code
+* [#1323](https://github.com/stripe/stripe-ruby/pull/1323) Extract other CRUDL api operations from mixins
+  * Extract more CRUDL operations, namely `create`, `delete`, `update`, and `list` into the resources. These methods will no longer rely on the APIOperation mixins.
+* [#1314](https://github.com/stripe/stripe-ruby/pull/1314) Update mocha gem to 1.16
+
+## 10.7.1 - 2024-02-05
+* [#1320](https://github.com/stripe/stripe-ruby/pull/1320) Remove spurious _search deprecation messages (https://github.com/stripe/stripe-ruby/issues/1319)
+
+## 10.7.0 - 2024-02-01
+* [#1317](https://github.com/stripe/stripe-ruby/pull/1317) Remove list method in child resources
+  * Removes list method mixin from child resources, as these methods always return `InvalidRequestError` and never succeed
+* [#1311](https://github.com/stripe/stripe-ruby/pull/1311) Use the deprecation gem in search and clean up usage of the gem
+
+## 10.6.0 - 2024-01-12
+* [#1310](https://github.com/stripe/stripe-ruby/pull/1310) Update generated code
+  * Add support for new resource `CustomerSession`
+  * Add support for `create` method on resource `CustomerSession`
+
+## 10.5.0 - 2024-01-04
+* [#1306](https://github.com/stripe/stripe-ruby/pull/1306) Update generated code
+  * Add support for `retrieve` method on resource `Tax.Registration`
+
+## 10.4.0 - 2023-12-22
+* [#1303](https://github.com/stripe/stripe-ruby/pull/1303) Update generated code
+  * Add support for new resource `FinancialConnections.Transaction`
+  * Add support for `list` and `retrieve` methods on resource `Transaction`
+  * Add support for `subscribe` and `unsubscribe` methods on resource `FinancialConnections.Account`
+* [#1304](https://github.com/stripe/stripe-ruby/pull/1304) Add support for updatable singleton resources
+
+## 10.3.0 - 2023-12-14
+* [#1294](https://github.com/stripe/stripe-ruby/pull/1294) Support sending parameters inside singleton retrieve
+
+## 10.2.0 - 2023-11-30
+* [#1292](https://github.com/stripe/stripe-ruby/pull/1292) Update generated code
+  * Add support for new resources `Climate.Order`, `Climate.Product`, and `Climate.Supplier`
+  * Add support for `cancel`, `create`, `list`, `retrieve`, and `update` methods on resource `Order`
+  * Add support for `list` and `retrieve` methods on resources `Product` and `Supplier`
+* [#1295](https://github.com/stripe/stripe-ruby/pull/1295) Upgrade rubocop
+* [#1291](https://github.com/stripe/stripe-ruby/pull/1291) Update generated code
+
+* [#1290](https://github.com/stripe/stripe-ruby/pull/1290) Update generated code
+
+* [#1288](https://github.com/stripe/stripe-ruby/pull/1288) Update generated code
+
+
 ## 10.1.0 - 2023-11-02
 * [#1286](https://github.com/stripe/stripe-ruby/pull/1286) Update generated code
   * Add support for new resource `Tax.Registration`
@@ -40,32 +234,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
@@ -92,7 +286,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
 
@@ -140,7 +334,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")
   ```
@@ -204,7 +398,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.
 
@@ -220,15 +414,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`
@@ -237,7 +431,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
@@ -248,7 +442,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
@@ -270,7 +464,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

@@ -5,8 +5,7 @@ source "https://rubygems.org"
 gemspec
 
 group :development do
-  gem "coveralls_reborn", "~> 0.25.0" if RUBY_VERSION >= "3.1"
-  gem "mocha", "~> 0.13.2"
+  gem "mocha", "~> 1.16.0"
   gem "rack", ">= 2.0.6"
   gem "rake"
 
@@ -23,10 +22,12 @@ group :development do
   # `Gemfile.lock` checked in, so to prevent good builds from suddenly going
   # bad, pin to a specific version number here. Try to keep this relatively
   # up-to-date, but it's not the end of the world if it's not.
-  gem "rubocop", "0.80"
+  #
+  # 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
-  gem "jaro_winkler", "1.5.4"
+  gem "sorbet"
+  gem "tapioca"
 
   platforms :mri do
     gem "byebug"

data/Makefile

@@ -5,9 +5,16 @@ update-version:
 
 codegen-format:
 	bundle install --quiet
-	bundle exec rubocop -o /dev/null --auto-correct
+	bundle exec rubocop -o /dev/null --autocorrect
 
 ci-test:
 	bundle install && bundle exec rake test
+	@version=$$(ruby -e "puts RUBY_VERSION.split('.')[0..1].join.to_i"); \
+	if [ $$version -ge 27 ]; then \
+		echo "Ruby version >= 2.7, continue with srb tc"; \
+		bundle exec srb tc; \
+	else \
+		echo "Ruby version < 2.7, skipping srb tc"; \
+	fi
 
 test: ci-test

data/OPENAPI_VERSION

@@ -1 +1 @@
-v640
+v1255

data/README.md

@@ -2,7 +2,6 @@
 
 [![Gem Version](https://badge.fury.io/rb/stripe.svg)](https://badge.fury.io/rb/stripe)
 [![Build Status](https://github.com/stripe/stripe-ruby/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/stripe/stripe-ruby/actions?query=branch%3Amaster)
-[![Coverage Status](https://coveralls.io/repos/github/stripe/stripe-ruby/badge.svg?branch=master)](https://coveralls.io/github/stripe/stripe-ruby?branch=master)
 
 The Stripe Ruby library provides convenient access to the Stripe API from
 applications written in the Ruby language. It includes a pre-defined set of
@@ -23,7 +22,6 @@ See the [Ruby API docs](https://stripe.com/docs/api?lang=ruby).
 
 See [video demonstrations][youtube-playlist] covering how to use the library.
 
-
 ## Installation
 
 You don't need this source code unless you want to modify the gem. If you just
@@ -131,17 +129,33 @@ Keep in mind that there are different method signatures depending on the action:
   `retrieve(id, opts)`. In addition, it will accept a Hash for the `id` param but will extract the
   `id` key out and use the others as options.
 
+### Accessing resource properties
+
+Both indexer and accessors can be used to retrieve values of resource properties.
+
+```ruby
+customer = Stripe::Customer.retrieve('cus_123456789')
+puts customer['id']
+puts customer.id
+```
+
+NOTE: If the resource property is not defined, the accessors will raise an exception, while the indexer will return `nil`.
+
+```ruby
+customer = Stripe::Customer.retrieve('cus_123456789')
+puts customer['unknown'] # nil
+puts customer.unknown # raises NoMethodError
+```
+
 ### Accessing a response object
 
-Get access to response objects by initializing a client and using its `request`
-method:
+Get access to response objects by using the `last_response` property of the returned resource:
 
 ```ruby
-client = Stripe::StripeClient.new
-customer, resp = client.request do
-  Stripe::Customer.retrieve('cus_123456789',)
-end
-puts resp.request_id
+customer = Stripe::Customer.retrieve('cus_123456789')
+
+print(customer.last_response.http_status) # to retrieve status code
+print(customer.last_response.http_headers) # to retrieve headers
 ```
 
 ### Configuring a proxy
@@ -291,10 +305,11 @@ Stripe.set_app_info('MyAwesomePlugin', version: '1.2.34', url: 'https://myawesom
 This information is passed along when the library makes calls to the Stripe
 API.
 
-### Request latency telemetry
+### Telemetry
 
-By default, the library sends request latency telemetry to Stripe. These
-numbers help Stripe improve the overall latency of its API for all users.
+By default, the library sends telemetry to Stripe regarding request latency and feature usage. These
+numbers help Stripe improve the overall latency of its API for all users, and
+improve popular features.
 
 You can disable this behavior if you prefer:
 
@@ -317,10 +332,27 @@ gem install stripe -v 7.1.0.pre.beta.2
 
 We highly recommend keeping an eye on when the beta feature you are interested in goes from beta to stable so that you can move from using a beta version of the SDK to the stable version.
 
-If your beta feature requires a `Stripe-Version` header to be sent, use the `Stripe.api_version` field to set it:
+If your beta feature requires a `Stripe-Version` header to be sent, set the `Stripe.api_version` field using `Stripe.add_beta_version`:
 
 ```python
-Stripe.api_version += "; feature_beta=v3"
+Stripe.add_beta_version("feature_beta", "v3")
+```
+
+### Custom requests
+
+If you:
+
+- would like to send a request to an undocumented API (for example you are in a private beta)
+- prefer to bypass the method definitions in the library and specify your request details directly,
+- used the method `Stripe::APIResource.request(...)` to specify your own requests, which will soon be broken
+
+you can now use the `raw_request` method on `Stripe`.
+
+```ruby
+resp = Stripe.raw_request(:post, "/v1/beta_endpoint", {param: 123}, {stripe_version: "2022-11-15; feature_beta=v3"})
+
+# (Optional) resp is a StripeResponse. You can use `Stripe.deserialize` to get a StripeObject.
+deserialized_resp = Stripe.deserialize(resp.http_body)
 ```
 
 ## Support

data/Rakefile

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "rake/testtask"
-require "rubocop/rake_task"
 
 task default: %i[test rubocop]
 
@@ -9,7 +8,10 @@ Rake::TestTask.new do |t|
   t.pattern = "./test/**/*_test.rb"
 end
 
-RuboCop::RakeTask.new
+if RUBY_VERSION >= "2.7.0"
+  require "rubocop/rake_task"
+  RuboCop::RakeTask.new
+end
 
 desc "Update bundled certs"
 task :update_certs do
@@ -17,7 +19,7 @@ task :update_certs do
   require "uri"
 
   fetch_file "https://curl.haxx.se/ca/cacert.pem",
-             ::File.expand_path("../lib/data/ca-certificates.crt", __FILE__)
+             File.expand_path("lib/data/ca-certificates.crt", __dir__)
 end
 
 #
@@ -25,11 +27,11 @@ end
 #
 
 def fetch_file(uri, dest)
-  ::File.open(dest, "w") do |file|
+  File.open(dest, "w") do |file|
     resp = Net::HTTP.get_response(URI.parse(uri))
     unless resp.code.to_i == 200
       abort("bad response when fetching: #{uri}\n" \
-        "Status #{resp.code}: #{resp.body}")
+            "Status #{resp.code}: #{resp.body}")
     end
     file.write(resp.body)
     puts "Successfully fetched: #{uri}"

data/VERSION

@@ -1 +1 @@
-10.1.0
+12.6.0

data/{bin → exe}/stripe-console

@@ -5,7 +5,7 @@
 require "irb"
 require "irb/completion"
 
-require "#{::File.dirname(__FILE__)}/../lib/stripe"
+require "#{File.dirname(__FILE__)}/../lib/stripe"
 
 # Config IRB to enable --simple-prompt and auto indent
 IRB.conf[:PROMPT_MODE] = :SIMPLE

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