Bump version to 10.6.0-beta.1

Update generated code for beta

.rubocop.yml

@@ -41,6 +41,10 @@ Metrics/MethodLength:
 Metrics/ModuleLength:
   Enabled: false
 
+Metrics/ParameterLists:
+  # There's 2 methods in `StripeClient` that have long parameter lists.
+  Max: 8
+
 Style/AccessModifierDeclarations:
   EnforcedStyle: inline
 

.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2023-11-28 01:02:03 UTC using RuboCop version 1.57.2.
+# on 2023-11-29 18:39:02 UTC using RuboCop version 1.57.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -11,15 +11,15 @@ Lint/HashCompareByIdentity:
   Exclude:
     - 'lib/stripe/stripe_client.rb'
 
-# Offense count: 26
+# Offense count: 27
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 50
+  Max: 55
 
-# Offense count: 9
+# Offense count: 10
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 592
+  Max: 618
 
 # Offense count: 12
 # Configuration parameters: AllowedMethods, AllowedPatterns.
@@ -27,14 +27,9 @@ Metrics/CyclomaticComplexity:
   Max: 12
 
 # Offense count: 9
-# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
-Metrics/ParameterLists:
-  Max: 7
-
-# Offense count: 8
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
-  Max: 12
+  Max: 13
 
 # Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
@@ -49,7 +44,7 @@ Style/CombinableLoops:
   Exclude:
     - 'lib/stripe/stripe_client.rb'
 
-# Offense count: 39
+# Offense count: 44
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Enabled: false

CHANGELOG.md

@@ -1,8 +1,17 @@
 # Changelog
+
+## 10.6.0-beta.1 - 2024-01-04
+* [#1302](https://github.com/stripe/stripe-ruby/pull/1302) Update generated code for beta
+  * Updated stable APIs to the latest version
+
+
 ## 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.5.0-beta.1 - 2023-12-22
+* [#1302](https://github.com/stripe/stripe-ruby/pull/1302) Update generated code for beta
+
 ## 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`
@@ -10,9 +19,16 @@
   * 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.4.0-beta.1 - 2023-12-14
+ Updated stable APIs to the latest version
+
 ## 10.3.0 - 2023-12-14
 * [#1294](https://github.com/stripe/stripe-ruby/pull/1294) Support sending parameters inside singleton retrieve
 
+## 10.3.0-beta.1 - 2023-11-30
+* [#1298](https://github.com/stripe/stripe-ruby/pull/1298) Update generated code for beta
+* [#1296](https://github.com/stripe/stripe-ruby/pull/1296) Merge master into beta
+
 ## 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`
@@ -25,12 +41,26 @@
 
 * [#1288](https://github.com/stripe/stripe-ruby/pull/1288) Update generated code
 
+## 10.2.0-beta.1 - 2023-11-02
+* [#1287](https://github.com/stripe/stripe-ruby/pull/1287) Update generated code for beta
+  * Add support for `attach_payment_intent` method on resource `Invoice`
+* [#1285](https://github.com/stripe/stripe-ruby/pull/1285) Update generated code for beta
 
 ## 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`
   * Add support for `create`, `list`, and `update` methods on resource `Registration`
 
+## 10.1.0-beta.2 - 2023-10-26
+* [#1285](https://github.com/stripe/stripe-ruby/pull/1285) Update generated code for beta
+  * Add support for new resource `Margin`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `Margin`
+
+## 10.1.0-beta.1 - 2023-10-17
+* [#1284](https://github.com/stripe/stripe-ruby/pull/1284) Update generated code for beta
+  - Update pinned API version to `2023-10-16`
+* [#1282](https://github.com/stripe/stripe-ruby/pull/1282) Update generated code for beta
+
 ## 10.0.0 - 2023-10-16
 * This release changes the pinned API version to `2023-10-16`. Please read the [API Upgrade Guide](https://stripe.com/docs/upgrades#2023-10-16) and carefully review the API changes before upgrading `stripe-ruby`.
 * [#1283](https://github.com/stripe/stripe-ruby/pull/1283) Update generated code
@@ -38,11 +68,33 @@
 * [#1281](https://github.com/stripe/stripe-ruby/pull/1281) Update generated code
   * Documentation only changes
 
+## 9.5.0-beta.2 - 2023-10-12
+* [#1280](https://github.com/stripe/stripe-ruby/pull/1280) Update generated code for beta
+  * Add support for new resources `AccountNotice` and `Issuing.CreditUnderwritingRecord`
+  * Add support for `list`, `retrieve`, and `update` methods on resource `AccountNotice`
+  * Add support for `correct`, `create_from_application`, `create_from_proactive_review`, `list`, `report_decision`, and `retrieve` methods on resource `CreditUnderwritingRecord`
+
+## 9.5.0-beta.1 - 2023-10-05
+* [#1278](https://github.com/stripe/stripe-ruby/pull/1278) Update generated code for beta
+  * Add support for `mark_draft` and `mark_stale` methods on resource `Quote`
+  * Remove support for `draft_quote` and `mark_stale_quote` methods on resource `Quote`
+  * Rename `preview_invoice_lines` to `list_preview_invoice_lines` on resource  `Quote`
+
 ## 9.4.0 - 2023-10-05
 * [#1277](https://github.com/stripe/stripe-ruby/pull/1277) Update generated code
   * Add support for new resources `Issuing.Token`
   * Add support for `list`, `retrieve`, and `update` methods on resource `Token`
 
+## 9.4.0-beta.3 - 2023-09-28
+* [#1276](https://github.com/stripe/stripe-ruby/pull/1276) Update generated code for beta
+  * Rename resources `Issuing.CardDesign` and `Issuing.CardBundle` to `Issuing.PersonalizationDesign` and `Issuing.PhysicalBundle`
+
+## 9.4.0-beta.2 - 2023-09-21
+* [#1273](https://github.com/stripe/stripe-ruby/pull/1273) Update generated code for beta
+
+## 9.4.0-beta.1 - 2023-09-14
+ * Updated stable APIs to the latest version
+
 ## 9.3.0 - 2023-09-14
 * [#1272](https://github.com/stripe/stripe-ruby/pull/1272) Update generated code
   * Add support for new resource `PaymentMethodConfiguration`
@@ -51,18 +103,38 @@
   * Add support for `capture`, `create`, `expire`, `increment`, and `reverse` test helper methods on resource `Issuing.Authorization`
   * Add support for `create_force_capture`, `create_unlinked_refund`, and `refund` test helper methods on resource `Issuing.Transaction`
 
+## 9.3.0-beta.1 - 2023-09-07
+* [#1269](https://github.com/stripe/stripe-ruby/pull/1269) Update generated code for beta
+  * Release specs are identical.
+* [#1268](https://github.com/stripe/stripe-ruby/pull/1268) Update generated code for beta
+  * Remove support for `submit_card` test helper method on resource `Issuing.Card`
+* [#1265](https://github.com/stripe/stripe-ruby/pull/1265) Update generated code for beta
+  * Rename `Quote.preview_invoices` to `QuotePreviewInvoice.list` and `Quote.preview_schedules` to `QuotePreviewSchedules.list`
+* [#1264](https://github.com/stripe/stripe-ruby/pull/1264) Update generated code for beta
+  * Add support for new resources `QuotePreviewInvoice` and `QuotePreviewSchedule`
+* [#1259](https://github.com/stripe/stripe-ruby/pull/1259) Update generated code for beta
+
+* [#1257](https://github.com/stripe/stripe-ruby/pull/1257) Update generated code for beta
+
+* [#1254](https://github.com/stripe/stripe-ruby/pull/1254) Update generated code for beta
+  * Add support for `submit_card` test helper method on resource `Issuing.Card`
+* [#1252](https://github.com/stripe/stripe-ruby/pull/1252) Remove developer_message support
+
 ## 9.2.0 - 2023-09-07
 * [#1267](https://github.com/stripe/stripe-ruby/pull/1267) Update generated code
   * Add support for new resource `PaymentMethodDomain`
   * Add support for `create`, `list`, `retrieve`, `update`, and `validate` methods on resource `PaymentMethodDomain`
 
+## 9.2.0-beta.1 - 2023-08-31
+* [#1265](https://github.com/stripe/stripe-ruby/pull/1265) Update generated code for beta
+  * Rename `Quote.preview_invoices` to `QuotePreviewInvoice.list` and `Quote.preview_schedules` to `QuotePreviewSchedules.list`
+
 ## 9.1.0 - 2023-08-31
 * [#1266](https://github.com/stripe/stripe-ruby/pull/1266) Update generated code
   * Add support for new resource `AccountSession`
   * Add support for `create` method on resource `AccountSession`
 * [#1262](https://github.com/stripe/stripe-ruby/pull/1262) Explicitly format timestamp in SignatureVerificationError message
 
-
 ## 9.0.0 - 2023-08-16
 **⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️**
 
@@ -95,10 +167,39 @@
   
   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.
 
+## 9.0.0-beta.1 - 2023-08-24
+* [#1264](https://github.com/stripe/stripe-ruby/pull/1264) Update generated code for beta
+  * Add support for new resources `QuotePreviewInvoice` and `QuotePreviewSchedule`
+* [#1259](https://github.com/stripe/stripe-ruby/pull/1259) Update generated code for beta
+
+## 8.8.0-beta.1 - 2023-08-10
+* [#1257](https://github.com/stripe/stripe-ruby/pull/1257) Update generated code for beta
+  * Updated stable APIs to the latest version
+
 ## 8.7.0 - 2023-08-10
 * [#1256](https://github.com/stripe/stripe-ruby/pull/1256) Update generated code
   Add resources `Tax::CalculationLineItem`, `Tax::TransactionLineItem`, and `Treasury::FinancialAccountFeatures`. These resources have no methods on them, but do represent the return type of methods elsewhere.
 
+## 8.7.0-beta.3 - 2023-08-03
+* [#1254](https://github.com/stripe/stripe-ruby/pull/1254) Update generated code for beta
+  * Add support for `submit_card` test helper method on resource `Issuing.Card`
+* [#1252](https://github.com/stripe/stripe-ruby/pull/1252) Remove developer_message support
+
+## 8.7.0-beta.2 - 2023-07-28
+* [#1251](https://github.com/stripe/stripe-ruby/pull/1251) Update generated code for beta
+  * Add support for new resource `Tax.Form`
+  * Add support for `list`, `pdf`, and `retrieve` methods on resource `Form`
+* [#1249](https://github.com/stripe/stripe-ruby/pull/1249) Update generated code for beta
+* [#1246](https://github.com/stripe/stripe-ruby/pull/1246) Update generated code for beta
+
+## 8.7.0-beta.1 - 2023-07-13
+* [#1245](https://github.com/stripe/stripe-ruby/pull/1245) Update generated code for beta
+  Release specs are identical.
+* [#1243](https://github.com/stripe/stripe-ruby/pull/1243) Update generated code for beta
+  * Add support for new resource `PaymentMethodConfiguration`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PaymentMethodConfiguration`
+* [#1239](https://github.com/stripe/stripe-ruby/pull/1239) Update generated code for beta
+
 ## 8.6.0 - 2023-07-13
 * [#1244](https://github.com/stripe/stripe-ruby/pull/1244) Update generated code
   * Add support for new resource `Tax.Settings`
@@ -127,6 +228,37 @@
 
 * [#1204](https://github.com/stripe/stripe-ruby/pull/1204) Update generated code
 
+## 8.6.0-beta.6 - 2023-06-22
+* [#1237](https://github.com/stripe/stripe-ruby/pull/1237) Update generated code for beta
+  * Add support for new resource `CustomerSession`
+  * Add support for `create` method on resource `CustomerSession`
+* [#1233](https://github.com/stripe/stripe-ruby/pull/1233) Update generated code for beta
+* [#1229](https://github.com/stripe/stripe-ruby/pull/1229) Update generated code for beta
+
+## 8.6.0-beta.5 - 2023-06-01
+* [#1227](https://github.com/stripe/stripe-ruby/pull/1227) Update generated code for beta
+* [#1228](https://github.com/stripe/stripe-ruby/pull/1228) Document raw_request
+* [#1222](https://github.com/stripe/stripe-ruby/pull/1222) Update generated code for beta
+* [#1224](https://github.com/stripe/stripe-ruby/pull/1224) Handle developer message in preview error responses
+
+## 8.6.0-beta.4 - 2023-05-19
+* [#1220](https://github.com/stripe/stripe-ruby/pull/1220) Update generated code for beta
+  * Add support for `subscribe` and `unsubscribe` methods on resource `FinancialConnections.Account`
+* [#1217](https://github.com/stripe/stripe-ruby/pull/1217) Add raw_request
+* [#1216](https://github.com/stripe/stripe-ruby/pull/1216) Update generated code for beta
+* [#1214](https://github.com/stripe/stripe-ruby/pull/1214) Update generated code for beta
+
+## 8.6.0-beta.3 - 2023-04-17
+* [#1211](https://github.com/stripe/stripe-ruby/pull/1211) Update generated code for beta
+* [#1210](https://github.com/stripe/stripe-ruby/pull/1210), [#1212](https://github.com/stripe/stripe-ruby/pull/1212), [#1213](https://github.com/stripe/stripe-ruby/pull/1213) Add support for request signing
+
+## 8.6.0-beta.2 - 2023-04-13
+* [#1206](https://github.com/stripe/stripe-ruby/pull/1206) Update generated code for beta
+  * Add support for `collect_payment_method` and `confirm_payment_intent` methods on resource `Terminal.Reader`
+* [#1205](https://github.com/stripe/stripe-ruby/pull/1205) Update generated code for beta
+
+## 8.6.0-beta.1 - 2023-03-30
+* [#1202](https://github.com/stripe/stripe-ruby/pull/1202) Update generated code for beta
 
 ## 8.5.0 - 2023-03-30
 * [#1203](https://github.com/stripe/stripe-ruby/pull/1203) Update generated code
@@ -134,6 +266,11 @@
     * This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the `create_from_calculation` method.
 * [#1201](https://github.com/stripe/stripe-ruby/pull/1201) Update save deprecation message
 
+## 8.5.0-beta.1 - 2023-03-23
+* [#1194](https://github.com/stripe/stripe-ruby/pull/1194) Update generated code for beta (new)
+  * Add support for new resources `Tax.CalculationLineItem` and `Tax.TransactionLineItem`
+  * Add support for `collect_inputs` method on resource `Terminal.Reader`
+
 ## 8.4.0 - 2023-03-23
 * [#1197](https://github.com/stripe/stripe-ruby/pull/1197) Update generated code (new)
   * Add support for new resources `Tax.CalculationLineItem`, `Tax.Calculation`, `Tax.TransactionLineItem`, and `Tax.Transaction`
@@ -141,18 +278,91 @@
   * Add support for `create_from_calculation`, `create_reversal`, `create`, `list_line_items`, and `retrieve` methods on resource `Transaction`
 * [#1152](https://github.com/stripe/stripe-ruby/pull/1152) Symbolize hash keys inside `convert_to_stripe_object_with_params`
 
+## 8.4.0-beta.4 - 2023-03-16
+* [#1189](https://github.com/stripe/stripe-ruby/pull/1189) Update generated code for beta (new)
+  * Add support for `create_from_calculation` method on resource `Tax.Transaction`
+* [#1188](https://github.com/stripe/stripe-ruby/pull/1188) Update generated code for beta (new)
+  * Remove support for resources `Capital.FinancingOffer` and `Capital.FinancingSummary`
+  * Remove support for `list`, `mark_delivered`, and `retrieve` methods on resource `FinancingOffer`
+  * Remove support for `retrieve` method on resource `FinancingSummary`
+* [#1187](https://github.com/stripe/stripe-ruby/pull/1187) Merge upstream master
+
+## 8.4.0-beta.3 - 2023-03-09
+* [#1184](https://github.com/stripe/stripe-ruby/pull/1184) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Remove support for `list_transactions` method on resource `Tax.Transaction`
+
+## 8.4.0-beta.2 - 2023-03-03
+* [#1183](https://github.com/stripe/stripe-ruby/pull/1183) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for new resources `Issuing.CardBundle` and `Issuing.CardDesign`
+  * Add support for `list` and `retrieve` methods on resource `CardBundle`
+  * Add support for `list`, `retrieve`, and `update` methods on resource `CardDesign`
+
+## 8.4.0-beta.1 - 2023-02-23
+* [#1182](https://github.com/stripe/stripe-ruby/pull/1182) API Updates for beta branch
+  * Updated stable APIs to the latest version
+
 ## 8.3.0 - 2023-02-16
 * [#1175](https://github.com/stripe/stripe-ruby/pull/1175) API Updates
   * Add support for `refund_payment` method on resource `Terminal.Reader`
 
+## 8.3.0-beta.1 - 2023-02-02
+* [#1174](https://github.com/stripe/stripe-ruby/pull/1174) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for new resource `FinancialConnections.Transaction`
+  * Add support for `list` method on resource `Transaction`
+
 ## 8.2.0 - 2023-02-02
 * [#1173](https://github.com/stripe/stripe-ruby/pull/1173) API Updates
   * Add support for `resume` method on resource `Subscription`
 * [#1171](https://github.com/stripe/stripe-ruby/pull/1171) Remove unused `partial` param from `initialize_from`
 
+## 8.2.0-beta.3 - 2023-01-26
+* [#1172](https://github.com/stripe/stripe-ruby/pull/1172) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for `list_transactions` method on resource `Tax.Transaction`
+
+## 8.2.0-beta.2 - 2023-01-19
+* [#1170](https://github.com/stripe/stripe-ruby/pull/1170) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for `Tax.Settings` resource.
+
+## 8.2.0-beta.1 - 2023-01-12
+* [#1167](https://github.com/stripe/stripe-ruby/pull/1167) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Change `quote.draft_quote` implementation to from calling `POST /v1/quotes/{quote}/draft` to `POST /v1/quotes/{quote}/mark_draft`
+  * Add support for `Tax::Register` resource
+
 ## 8.1.0 - 2023-01-12
 * [#1162](https://github.com/stripe/stripe-ruby/pull/1162) Improve request events instrumentation
 
+## 8.1.0-beta.4 - 2023-01-05
+* [#1164](https://github.com/stripe/stripe-ruby/pull/1164) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for `mark_stale_quote` method on resource `Quote`
+
+## 8.1.0-beta.3 - 2022-12-22
+* [#1158](https://github.com/stripe/stripe-ruby/pull/1158) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Move `TaxCalculation` and `TaxTransaction` to `Tax::Calculation` and `Tax::Transaction`.
+
+## 8.1.0-beta.2 - 2022-12-15
+* [#1156](https://github.com/stripe/stripe-ruby/pull/1156) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for new resources `TaxCalculation`, and `TaxTransaction`
+  * Add support for `create` and `list_line_items` methods on resource `TaxCalculation`
+  * Add support for `create_reversal`, `create`, and `retrieve` methods on resource `TaxTransaction`
+* [#1155](https://github.com/stripe/stripe-ruby/pull/1155) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for new resource `QuoteLine`.
+
+## 8.1.0-beta.1 - 2022-12-08
+* [#1153](https://github.com/stripe/stripe-ruby/pull/1153) API Updates for beta branch
+  * Updated stable APIs to the latest version
+* [#1146](https://github.com/stripe/stripe-ruby/pull/1146) API Updates for beta branch
+  * Updated stable APIs to the latest version
+
 ## 8.0.0 - 2022-11-16
 * [#1144](https://github.com/stripe/stripe-ruby/pull/1144) Next major release changes
 
@@ -160,30 +370,29 @@ Breaking changes that arose during code generation of the library that we postpo
 
 "⚠️" symbol highlights breaking changes.
 
-### Deprecated
+## 7.2.0-beta.5 - 2022-11-02
-- The `save` method is deprecated. Prefer the static `update` method that doesn't require retrieval of the resource to update it.
+* [#1139](https://github.com/stripe/stripe-ruby/pull/1139) API Updates for beta branch
-  ``` ruby
+  * Updated beta APIs to the latest stable version
-  # before
+* [#1135](https://github.com/stripe/stripe-ruby/pull/1135) API Updates for beta branch
-  refund = Stripe::Refund.retrieve("re_123")
+  * Updated stable APIs to the latest version
-  refund.description = "Refund description"
-  refund.save
-  
-  # after
-  Stripe::Refund.update("re_123", description: "Refund description")
-  ```
 
-### ⚠️ Removed
+## 7.2.0-beta.4 - 2022-10-07
-- Removed deprecated `Sku` resource.
+* [#999](https://github.com/stripe/stripe-ruby/pull/999) DESCRIBE CHANGES HERE (try to use the same style, tense, etc. as the other entries)
-- Removed deprecated `Orders` resource.
-- Removed deprecated `delete` method on `Subscription` resource. Please use `cancel` method instead.
-  ```ruby
-  # before
-  Stripe::Subscription::delete("sub_12345")
 
-  # after
+## 7.2.0-beta.3 - 2022-09-26
-  Stripe::Subscription::cancel("sub_12345")
+* [#1129](https://github.com/stripe/stripe-ruby/pull/1129) API Updates for beta branch
-  ```
+  * Updated stable APIs to the latest version
+  * Add `FinancingOffer`, `FinancingSummary` and `FinancingTransaction` resources.
 
+## 7.2.0-beta.2 - 2022-08-26
+* [#1127](https://github.com/stripe/stripe-ruby/pull/1127) API Updates for beta branch
+  * Updated stable APIs to the latest version
+  * Add support for the beta [Gift Card API](https://stripe.com/docs/gift-cards).
+
+## 7.2.0-beta.1 - 2022-08-23
+* [#1122](https://github.com/stripe/stripe-ruby/pull/1122) API Updates for beta branch
+  - Updated stable APIs to the latest version
+  - `Stripe-Version` beta headers are not pinned by-default and need to be manually specified, please refer to [beta SDKs README section](https://github.com/stripe/stripe-ruby/blob/master/README.md#beta-sdks)
 
 ## 7.1.0 - 2022-08-19
 * [#1116](https://github.com/stripe/stripe-ruby/pull/1116) API Updates
@@ -192,6 +401,16 @@ Breaking changes that arose during code generation of the library that we postpo
 * [#1117](https://github.com/stripe/stripe-ruby/pull/1117) Refresh rubocop config.
 * [#1115](https://github.com/stripe/stripe-ruby/pull/1115) Add a support section to the readme
 
+## 7.1.0-beta.2 - 2022-08-11
+* [#1113](https://github.com/stripe/stripe-ruby/pull/1113) API Updates for beta branch
+  - Updated stable APIs to the latest version
+  - Add `refund_payment` method to Terminal resource
+
+## 7.1.0-beta.1 - 2022-08-03
+* [#1107](https://github.com/stripe/stripe-ruby/pull/1107) API Updates for beta branch
+  - Updated stable APIs to the latest version
+  - Added the `Order` resource support
+
 ## 7.0.0 - 2022-08-02
 
 Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v7. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-08-01.
@@ -203,21 +422,19 @@ Breaking changes that arose during code generation of the library that we postpo
 * [#1090](https://github.com/stripe/stripe-ruby/pull/1090) Use auto-generation for `Invoice` methods
 * [#1103](https://github.com/stripe/stripe-ruby/pull/1103) Next major release changes
 
-### ⚠️ Changed
+## 6.6.0-beta.1 - 2022-07-22
-* `retrieve_cash_balance` and `update_cash_balance` methods on `Customer` resource no longer requires the second argument to always be `nil`. The methods now now take in `customer_id`, `params`, and `opts` parameters.
+* [#1100](https://github.com/stripe/stripe-ruby/pull/1100) API Updates for beta branch
-* Update default bundle of CA certificates to April 26, 2022.
+  - Updated stable APIs to the latest version
-
+  - Add `QuotePhase` resource
-### Deprecated
+* [#1097](https://github.com/stripe/stripe-ruby/pull/1097) API Updates for beta branch
-* Deprecate `delete` method on `Subscription` resource. Please use `cancel` method instead.
+  - Updated stable APIs to the latest version
-
+  - Add `SubscriptionSchedule.amend` method.
-### ⚠️ Removed
+* [#1093](https://github.com/stripe/stripe-ruby/pull/1093) API Updates for beta branch
-* Remove `details` method from `Issuing.Card` resource. The method was not supported.
+  - Include `server_side_confirmation_beta=v1` beta
-* Remove `Issuing.CardDetails` resource. Read more at https://stripe.com/docs/issuing/cards/virtual.
+  - Add `secretKeyConfirmation` to `PaymentIntent`
-* Remove `create` method from `ReportType` resource. The method was not supported.
+* [#1085](https://github.com/stripe/stripe-ruby/pull/1085) API Updates for beta branch
-* Remove `usage_record_summaries` method from `SubscriptionItem` resource. Please use `list_usage_record_summaries` method instead.
+  - Updated stable APIs to the latest version
-* Remove `AlipayAccount`, `BitcoinReceiver`, `BitcoinTransaction`, `Issuing::CardDetails`, `Recipient`, ` RecipientTransfer`, and `ThreeDSecure` resources. The resources were deprecated or no longer in use.
+* [#1075](https://github.com/stripe/stripe-ruby/pull/1075) Use the generated API version
-* Remove ability to list `Card` resource for a `Recipient`.
-* Remove `cancel` method from `Transfer` resource. The method was deprecated.
 
 ## 6.5.0 - 2022-06-29
 * [#1084](https://github.com/stripe/stripe-ruby/pull/1084) API Updates
@@ -247,8 +464,6 @@ 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
@@ -264,7 +479,6 @@ 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
@@ -1295,3 +1509,4 @@ Identical to 1.56.0 above. I incorrectly cut a patch-level release.
 <!--
 # vim: set tw=0:
 -->
+

README.md

@@ -324,6 +324,17 @@ If your beta feature requires a `Stripe-Version` header to be sent, use the `Str
 Stripe.api_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), or if you prefer to bypass the method definitions in the library and specify your request details directly, you can 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
 
 New features and bug fixes are released on the latest major version of the Stripe Ruby library. If you are on an older major version, we recommend that you upgrade to the latest in order to use the new features and bug fixes including those for security vulnerabilities. Older major versions of the package will continue to be available for use, but will not be receiving any updates.

VERSION

@@ -1 +1 @@
-10.5.0
+10.6.0-beta.1

lib/stripe.rb

@@ -13,6 +13,7 @@ require "set"
 require "socket"
 require "uri"
 require "forwardable"
+require "base64"
 
 # Version
 require "stripe/api_version"
@@ -45,6 +46,7 @@ require "stripe/api_resource_test_helpers"
 require "stripe/singleton_api_resource"
 require "stripe/webhook"
 require "stripe/stripe_configuration"
+require "stripe/request_signing_authenticator"
 
 # Named API resources
 require "stripe/resources"
@@ -71,6 +73,7 @@ module Stripe
 
     # User configurable options
     def_delegators :@config, :api_key, :api_key=
+    def_delegators :@config, :authenticator, :authenticator=
     def_delegators :@config, :api_version, :api_version=
     def_delegators :@config, :stripe_account, :stripe_account=
     def_delegators :@config, :api_base, :api_base=
@@ -117,6 +120,49 @@ module Stripe
       version: version,
     }
   end
+
+  class Preview
+    def self._get_default_opts(opts)
+      { api_mode: :preview }.merge(opts)
+    end
+
+    def self.get(url, opts = {})
+      Stripe.raw_request(:get, url, {}, _get_default_opts(opts))
+    end
+
+    def self.post(url, params = {}, opts = {})
+      Stripe.raw_request(:post, url, params, _get_default_opts(opts))
+    end
+
+    def self.delete(url, opts = {})
+      Stripe.raw_request(:delete, url, {}, _get_default_opts(opts))
+    end
+  end
+
+  class RawRequest
+    include Stripe::APIOperations::Request
+
+    def initialize
+      @opts = {}
+    end
+
+    def execute(method, url, params = {}, opts = {})
+      resp, = execute_resource_request(method, url, params, opts)
+
+      resp
+    end
+  end
+
+  # Sends a request to Stripe REST API
+  def self.raw_request(method, url, params = {}, opts = {})
+    req = RawRequest.new
+    req.execute(method, url, params, opts)
+  end
+
+  def self.deserialize(data)
+    data = JSON.parse(data) if data.is_a?(String)
+    Util.convert_to_stripe_object(data, {})
+  end
 end
 
 Stripe.log_level = ENV["STRIPE_LOG"] unless ENV["STRIPE_LOG"].nil?

lib/stripe/api_operations/request.rb

@@ -48,13 +48,14 @@ module Stripe
           api_key = headers.delete(:api_key)
           api_base = headers.delete(:api_base)
           client = headers.delete(:client)
+          api_mode = headers.delete(:api_mode)
           # Assume all remaining opts must be headers
 
           resp, opts[:api_key] = client.send(
             client_request_method_sym,
             method, url,
             api_base: api_base, api_key: api_key,
-            headers: headers, params: params, usage: usage,
+            headers: headers, params: params, usage: usage, api_mode: api_mode,
             &read_body_chunk_block
           )
 

lib/stripe/api_version.rb

@@ -4,5 +4,6 @@
 module Stripe
   module ApiVersion
     CURRENT = "2023-10-16"
+    PREVIEW = "2023-12-11.preview-v2"
   end
 end

lib/stripe/object_types.rb

@@ -14,6 +14,7 @@ module Stripe
         # business objects
         Account::OBJECT_NAME => Account,
         AccountLink::OBJECT_NAME => AccountLink,
+        AccountNotice::OBJECT_NAME => AccountNotice,
         AccountSession::OBJECT_NAME => AccountSession,
         ApplePayDomain::OBJECT_NAME => ApplePayDomain,
         ApplicationFee::OBJECT_NAME => ApplicationFee,
@@ -25,6 +26,9 @@ module Stripe
         BillingPortal::Configuration::OBJECT_NAME => BillingPortal::Configuration,
         BillingPortal::Session::OBJECT_NAME => BillingPortal::Session,
         Capability::OBJECT_NAME => Capability,
+        Capital::FinancingOffer::OBJECT_NAME => Capital::FinancingOffer,
+        Capital::FinancingSummary::OBJECT_NAME => Capital::FinancingSummary,
+        Capital::FinancingTransaction::OBJECT_NAME => Capital::FinancingTransaction,
         Card::OBJECT_NAME => Card,
         CashBalance::OBJECT_NAME => CashBalance,
         Charge::OBJECT_NAME => Charge,
@@ -32,6 +36,7 @@ module Stripe
         Climate::Order::OBJECT_NAME => Climate::Order,
         Climate::Product::OBJECT_NAME => Climate::Product,
         Climate::Supplier::OBJECT_NAME => Climate::Supplier,
+        ConfirmationToken::OBJECT_NAME => ConfirmationToken,
         CountrySpec::OBJECT_NAME => CountrySpec,
         Coupon::OBJECT_NAME => Coupon,
         CreditNote::OBJECT_NAME => CreditNote,
@@ -39,6 +44,7 @@ module Stripe
         Customer::OBJECT_NAME => Customer,
         CustomerBalanceTransaction::OBJECT_NAME => CustomerBalanceTransaction,
         CustomerCashBalanceTransaction::OBJECT_NAME => CustomerCashBalanceTransaction,
+        CustomerSession::OBJECT_NAME => CustomerSession,
         Discount::OBJECT_NAME => Discount,
         Dispute::OBJECT_NAME => Dispute,
         EphemeralKey::OBJECT_NAME => EphemeralKey,
@@ -48,26 +54,36 @@ module Stripe
         File::OBJECT_NAME_ALT => File,
         FileLink::OBJECT_NAME => FileLink,
         FinancialConnections::Account::OBJECT_NAME => FinancialConnections::Account,
+        FinancialConnections::AccountInferredBalance::OBJECT_NAME =>
+        FinancialConnections::AccountInferredBalance,
         FinancialConnections::AccountOwner::OBJECT_NAME => FinancialConnections::AccountOwner,
         FinancialConnections::AccountOwnership::OBJECT_NAME =>
         FinancialConnections::AccountOwnership,
         FinancialConnections::Session::OBJECT_NAME => FinancialConnections::Session,
         FinancialConnections::Transaction::OBJECT_NAME => FinancialConnections::Transaction,
         FundingInstructions::OBJECT_NAME => FundingInstructions,
+        GiftCards::Card::OBJECT_NAME => GiftCards::Card,
+        GiftCards::Transaction::OBJECT_NAME => GiftCards::Transaction,
         Identity::VerificationReport::OBJECT_NAME => Identity::VerificationReport,
         Identity::VerificationSession::OBJECT_NAME => Identity::VerificationSession,
         Invoice::OBJECT_NAME => Invoice,
         InvoiceItem::OBJECT_NAME => InvoiceItem,
         InvoiceLineItem::OBJECT_NAME => InvoiceLineItem,
+        InvoicePayment::OBJECT_NAME => InvoicePayment,
         Issuing::Authorization::OBJECT_NAME => Issuing::Authorization,
         Issuing::Card::OBJECT_NAME => Issuing::Card,
         Issuing::Cardholder::OBJECT_NAME => Issuing::Cardholder,
+        Issuing::CreditUnderwritingRecord::OBJECT_NAME => Issuing::CreditUnderwritingRecord,
         Issuing::Dispute::OBJECT_NAME => Issuing::Dispute,
+        Issuing::PersonalizationDesign::OBJECT_NAME => Issuing::PersonalizationDesign,
+        Issuing::PhysicalBundle::OBJECT_NAME => Issuing::PhysicalBundle,
         Issuing::Token::OBJECT_NAME => Issuing::Token,
         Issuing::Transaction::OBJECT_NAME => Issuing::Transaction,
         LineItem::OBJECT_NAME => LineItem,
         LoginLink::OBJECT_NAME => LoginLink,
         Mandate::OBJECT_NAME => Mandate,
+        Margin::OBJECT_NAME => Margin,
+        Order::OBJECT_NAME => Order,
         PaymentIntent::OBJECT_NAME => PaymentIntent,
         PaymentLink::OBJECT_NAME => PaymentLink,
         PaymentMethod::OBJECT_NAME => PaymentMethod,
@@ -80,6 +96,9 @@ module Stripe
         Product::OBJECT_NAME => Product,
         PromotionCode::OBJECT_NAME => PromotionCode,
         Quote::OBJECT_NAME => Quote,
+        QuotePhase::OBJECT_NAME => QuotePhase,
+        QuotePreviewInvoice::OBJECT_NAME => QuotePreviewInvoice,
+        QuotePreviewSubscriptionSchedule::OBJECT_NAME => QuotePreviewSubscriptionSchedule,
         Radar::EarlyFraudWarning::OBJECT_NAME => Radar::EarlyFraudWarning,
         Radar::ValueList::OBJECT_NAME => Radar::ValueList,
         Radar::ValueListItem::OBJECT_NAME => Radar::ValueListItem,
@@ -99,6 +118,7 @@ module Stripe
         SubscriptionSchedule::OBJECT_NAME => SubscriptionSchedule,
         Tax::Calculation::OBJECT_NAME => Tax::Calculation,
         Tax::CalculationLineItem::OBJECT_NAME => Tax::CalculationLineItem,
+        Tax::Form::OBJECT_NAME => Tax::Form,
         Tax::Registration::OBJECT_NAME => Tax::Registration,
         Tax::Settings::OBJECT_NAME => Tax::Settings,
         Tax::Transaction::OBJECT_NAME => Tax::Transaction,

lib/stripe/request_signing_authenticator.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Stripe
+  class RequestSigningAuthenticator
+    AUTHORIZATION_HEADER_NAME = "Authorization"
+    CONTENT_TYPE_HEADER_NAME = "Content-Type"
+    STRIPE_CONTEXT_HEADER_NAME = "Stripe-Context"
+    STRIPE_ACCOUNT_HEADER_NAME = "Stripe-Account"
+    CONTENT_DIGEST_HEADER_NAME = "Content-Digest"
+    SIGNATURE_INPUT_HEADER_NAME = "Signature-Input"
+    SIGNATURE_HEADER_NAME = "Signature"
+
+    attr_reader :auth_token, :sign_lambda
+
+    def initialize(auth_token, sign_lambda)
+      raise ArgumentError, "auth_token must be a string" unless auth_token.is_a?(String)
+      raise ArgumentError, "sign_lambda must be a lambda" unless sign_lambda.is_a?(Proc)
+
+      @auth_token = auth_token
+      @sign_lambda = sign_lambda
+    end
+
+    def authenticate(method, headers, body)
+      covered_headers = [CONTENT_TYPE_HEADER_NAME,
+                         CONTENT_DIGEST_HEADER_NAME,
+                         STRIPE_CONTEXT_HEADER_NAME,
+                         STRIPE_ACCOUNT_HEADER_NAME,
+                         AUTHORIZATION_HEADER_NAME,]
+
+      headers[AUTHORIZATION_HEADER_NAME] = "STRIPE-V2-SIG #{auth_token}"
+
+      if method == :get
+        covered_headers -= [CONTENT_TYPE_HEADER_NAME,
+                            CONTENT_DIGEST_HEADER_NAME,]
+      else
+        content = body || ""
+        headers[CONTENT_DIGEST_HEADER_NAME] =
+          %(sha-256=:#{content_digest(content)}:)
+      end
+
+      covered_headers_formatted = covered_headers
+                                  .map { |string| %("#{string.downcase}") }
+                                  .join(" ")
+
+      signature_input = "(#{covered_headers_formatted});created=#{created_time}"
+
+      inputs = covered_headers
+               .map { |header| %("#{header.downcase}": #{headers[header]}) }
+               .join("\n")
+
+      signature_base = %(#{inputs}\n"@signature-params": #{signature_input})
+                       .encode(Encoding::UTF_8)
+
+      headers[SIGNATURE_INPUT_HEADER_NAME] = "sig1=#{signature_input}"
+
+      headers[SIGNATURE_HEADER_NAME] =
+        "sig1=:#{encoded_signature(signature_base)}:"
+    end
+
+    private def sign(signature_base)
+      @sign_lambda.call(signature_base)
+    end
+
+    private def encoded_signature(signature_base)
+      Base64.strict_encode64(sign(signature_base))
+    rescue StandardError
+      raise AuthenticationError, "Encountered '#{e.message} (#{e.class})' " \
+                                 "when calculating request signature."
+    end
+
+    private def content_digest(content)
+      Base64.strict_encode64(OpenSSL::Digest.new("SHA256").digest(content))
+    end
+
+    private def created_time
+      Time.now.to_i
+    end
+  end
+end

lib/stripe/resources.rb

@@ -3,6 +3,7 @@
 
 require "stripe/resources/account"
 require "stripe/resources/account_link"
+require "stripe/resources/account_notice"
 require "stripe/resources/account_session"
 require "stripe/resources/apple_pay_domain"
 require "stripe/resources/application_fee"
@@ -14,6 +15,9 @@ require "stripe/resources/bank_account"
 require "stripe/resources/billing_portal/configuration"
 require "stripe/resources/billing_portal/session"
 require "stripe/resources/capability"
+require "stripe/resources/capital/financing_offer"
+require "stripe/resources/capital/financing_summary"
+require "stripe/resources/capital/financing_transaction"
 require "stripe/resources/card"
 require "stripe/resources/cash_balance"
 require "stripe/resources/charge"
@@ -21,6 +25,7 @@ require "stripe/resources/checkout/session"
 require "stripe/resources/climate/order"
 require "stripe/resources/climate/product"
 require "stripe/resources/climate/supplier"
+require "stripe/resources/confirmation_token"
 require "stripe/resources/country_spec"
 require "stripe/resources/coupon"
 require "stripe/resources/credit_note"
@@ -28,6 +33,7 @@ require "stripe/resources/credit_note_line_item"
 require "stripe/resources/customer"
 require "stripe/resources/customer_balance_transaction"
 require "stripe/resources/customer_cash_balance_transaction"
+require "stripe/resources/customer_session"
 require "stripe/resources/discount"
 require "stripe/resources/dispute"
 require "stripe/resources/ephemeral_key"
@@ -36,25 +42,34 @@ require "stripe/resources/exchange_rate"
 require "stripe/resources/file"
 require "stripe/resources/file_link"
 require "stripe/resources/financial_connections/account"
+require "stripe/resources/financial_connections/account_inferred_balance"
 require "stripe/resources/financial_connections/account_owner"
 require "stripe/resources/financial_connections/account_ownership"
 require "stripe/resources/financial_connections/session"
 require "stripe/resources/financial_connections/transaction"
 require "stripe/resources/funding_instructions"
+require "stripe/resources/gift_cards/card"
+require "stripe/resources/gift_cards/transaction"
 require "stripe/resources/identity/verification_report"
 require "stripe/resources/identity/verification_session"
 require "stripe/resources/invoice"
 require "stripe/resources/invoice_item"
 require "stripe/resources/invoice_line_item"
+require "stripe/resources/invoice_payment"
 require "stripe/resources/issuing/authorization"
 require "stripe/resources/issuing/card"
 require "stripe/resources/issuing/cardholder"
+require "stripe/resources/issuing/credit_underwriting_record"
 require "stripe/resources/issuing/dispute"
+require "stripe/resources/issuing/personalization_design"
+require "stripe/resources/issuing/physical_bundle"
 require "stripe/resources/issuing/token"
 require "stripe/resources/issuing/transaction"
 require "stripe/resources/line_item"
 require "stripe/resources/login_link"
 require "stripe/resources/mandate"
+require "stripe/resources/margin"
+require "stripe/resources/order"
 require "stripe/resources/payment_intent"
 require "stripe/resources/payment_link"
 require "stripe/resources/payment_method"
@@ -67,6 +82,9 @@ require "stripe/resources/price"
 require "stripe/resources/product"
 require "stripe/resources/promotion_code"
 require "stripe/resources/quote"
+require "stripe/resources/quote_phase"
+require "stripe/resources/quote_preview_invoice"
+require "stripe/resources/quote_preview_subscription_schedule"
 require "stripe/resources/radar/early_fraud_warning"
 require "stripe/resources/radar/value_list"
 require "stripe/resources/radar/value_list_item"
@@ -86,6 +104,7 @@ require "stripe/resources/subscription_item"
 require "stripe/resources/subscription_schedule"
 require "stripe/resources/tax/calculation"
 require "stripe/resources/tax/calculation_line_item"
+require "stripe/resources/tax/form"
 require "stripe/resources/tax/registration"
 require "stripe/resources/tax/settings"
 require "stripe/resources/tax/transaction"

lib/stripe/resources/account_notice.rb

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A notice to a Connected account. Notice can be sent by Stripe on your behalf or you can opt to send the notices yourself.
+  #
+  # See the [guide to send notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) to your connected accounts.
+  class AccountNotice < APIResource
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "account_notice"
+  end
+end

lib/stripe/resources/capital/financing_offer.rb

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Capital
+    # This is an object representing an offer of financing from
+    # Stripe Capital to a Connect subaccount.
+    class FinancingOffer < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "capital.financing_offer"
+
+      # Acknowledges that platform has received and delivered the financing_offer to
+      # the intended merchant recipient.
+      def mark_delivered(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/capital/financing_offers/%<financing_offer>s/mark_delivered", { financing_offer: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Acknowledges that platform has received and delivered the financing_offer to
+      # the intended merchant recipient.
+      def self.mark_delivered(financing_offer, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/capital/financing_offers/%<financing_offer>s/mark_delivered", { financing_offer: CGI.escape(financing_offer) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

lib/stripe/resources/capital/financing_summary.rb

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Capital
+    # A financing object describes an account's current financing state. Used by Connect
+    # platforms to read the state of Capital offered to their connected accounts.
+    class FinancingSummary < SingletonAPIResource
+      OBJECT_NAME = "capital.financing_summary"
+    end
+  end
+end

lib/stripe/resources/capital/financing_transaction.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Capital
+    # This is an object representing the details of a transaction on a Capital financing object.
+    class FinancingTransaction < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "capital.financing_transaction"
+    end
+  end
+end

lib/stripe/resources/confirmation_token.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # ConfirmationTokens help transport client side data collected by Stripe JS over
+  # to your server for confirming a PaymentIntent or SetupIntent. If the confirmation
+  # is successful, values present on the ConfirmationToken are written onto the Intent.
+  #
+  # To learn more or request access, visit the related guided: [Finalize payments on the server using Confirmation Tokens](https://stripe.com/docs/payments/finalize-payments-on-the-server-confirmation-tokens).
+  class ConfirmationToken < APIResource
+    OBJECT_NAME = "confirmation_token"
+  end
+end

lib/stripe/resources/customer_session.rb

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A customer session allows you to grant client access to Stripe's frontend SDKs (like StripeJs)
+  # control over a customer.
+  class CustomerSession < APIResource
+    extend Stripe::APIOperations::Create
+
+    OBJECT_NAME = "customer_session"
+  end
+end

lib/stripe/resources/financial_connections/account.rb

@@ -6,9 +6,12 @@ module Stripe
     # A Financial Connections Account represents an account that exists outside of Stripe, to which you have been granted some degree of access.
     class Account < APIResource
       extend Stripe::APIOperations::List
+      extend Stripe::APIOperations::NestedResource
 
       OBJECT_NAME = "financial_connections.account"
 
+      nested_resource_class_methods :inferred_balance, operations: %i[list]
+
       # Disables your access to a Financial Connections Account. You will no longer be able to access data associated with the account (e.g. balances, transactions).
       def disconnect(params = {}, opts = {})
         request_stripe_object(

lib/stripe/resources/financial_connections/account_inferred_balance.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module FinancialConnections
+    # A historical balance for the account on a particular day. It may be sourced from a balance snapshot provided by a financial institution, or inferred using transactions data.
+    class AccountInferredBalance < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "financial_connections.account_inferred_balance"
+    end
+  end
+end

lib/stripe/resources/gift_cards/card.rb

@@ -0,0 +1,26 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module GiftCards
+    # A gift card represents a single gift card owned by a customer, including the
+    # remaining balance, gift card code, and whether or not it is active.
+    class Card < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "gift_cards.card"
+
+      # Validates a gift card code, returning the matching gift card object if it exists.
+      def self.validate(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/gift_cards/cards/validate",
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

lib/stripe/resources/gift_cards/transaction.rb

@@ -0,0 +1,60 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module GiftCards
+    # A gift card transaction represents a single transaction on a referenced gift card.
+    # A transaction is in one of three states, `confirmed`, `held` or `canceled`. A `confirmed`
+    # transaction is one that has added/deducted funds. A `held` transaction has created a
+    # temporary hold on funds, which can then be cancelled or confirmed. A `held` transaction
+    # can be confirmed into a `confirmed` transaction, or canceled into a `canceled` transaction.
+    # A `canceled` transaction has no effect on a gift card's balance.
+    class Transaction < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "gift_cards.transaction"
+
+      # Cancel a gift card transaction
+      def cancel(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/gift_cards/transactions/%<id>s/cancel", { id: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Confirm a gift card transaction
+      def confirm(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/gift_cards/transactions/%<id>s/confirm", { id: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Cancel a gift card transaction
+      def self.cancel(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/gift_cards/transactions/%<id>s/cancel", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Confirm a gift card transaction
+      def self.confirm(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/gift_cards/transactions/%<id>s/confirm", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

lib/stripe/resources/invoice.rb

@@ -40,9 +40,30 @@ module Stripe
     extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
+    extend Stripe::APIOperations::NestedResource
 
     OBJECT_NAME = "invoice"
 
+    nested_resource_class_methods :payment, operations: %i[retrieve list]
+
+    # Attaches a PaymentIntent to the invoice, adding it to the list of payments.
+    # 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 is attached, it is
+    # credited to the invoice immediately.
+    #
+    # Related guide: [Create an invoice payment](https://stripe.com/docs/invoicing/payments/create)
+    def attach_payment_intent(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/invoices/%<invoice>s/attach_payment_intent", { invoice: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Stripe automatically finalizes drafts before sending and attempting payment on invoices. However, if you'd like to finalize a draft invoice manually, you can do so using this method.
     def finalize_invoice(params = {}, opts = {})
       request_stripe_object(
@@ -95,6 +116,24 @@ module Stripe
       )
     end
 
+    # Attaches a PaymentIntent to the invoice, adding it to the list of payments.
+    # 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 is attached, it is
+    # credited to the invoice immediately.
+    #
+    # Related guide: [Create an invoice payment](https://stripe.com/docs/invoicing/payments/create)
+    def self.attach_payment_intent(invoice, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/invoices/%<invoice>s/attach_payment_intent", { invoice: CGI.escape(invoice) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Stripe automatically finalizes drafts before sending and attempting payment on invoices. However, if you'd like to finalize a draft invoice manually, you can do so using this method.
     def self.finalize_invoice(invoice, params = {}, opts = {})
       request_stripe_object(

lib/stripe/resources/invoice_payment.rb

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # The invoice payment object
+  class InvoicePayment < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "invoice_payment"
+  end
+end

lib/stripe/resources/issuing/credit_underwriting_record.rb

@@ -0,0 +1,75 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # Every time an applicant submits an application for a Charge Card product your platform offers, or every time your platform takes a proactive credit decision on an existing account, you must record the decision by creating a new `CreditUnderwritingRecord` object on a connected account.
+    #
+    # [Follow the guide](https://stripe.com/docs/issuing/credit/report-credit-decisions-and-manage-aans) to learn about your requirements as a platform.
+    class CreditUnderwritingRecord < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "issuing.credit_underwriting_record"
+
+      # Update a CreditUnderwritingRecord object to correct mistakes.
+      def correct(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/correct", { credit_underwriting_record: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Update a CreditUnderwritingRecord object from a decision made on a credit application.
+      def report_decision(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/report_decision", { credit_underwriting_record: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Update a CreditUnderwritingRecord object to correct mistakes.
+      def self.correct(credit_underwriting_record, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/correct", { credit_underwriting_record: CGI.escape(credit_underwriting_record) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Creates a CreditUnderwritingRecord object with information about a credit application submission.
+      def self.create_from_application(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/issuing/credit_underwriting_records/create_from_application",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Creates a CreditUnderwritingRecord object from an underwriting decision coming from a proactive review of an existing accountholder.
+      def self.create_from_proactive_review(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/issuing/credit_underwriting_records/create_from_proactive_review",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Update a CreditUnderwritingRecord object from a decision made on a credit application.
+      def self.report_decision(credit_underwriting_record, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/report_decision", { credit_underwriting_record: CGI.escape(credit_underwriting_record) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

lib/stripe/resources/issuing/personalization_design.rb

@@ -0,0 +1,83 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # A Personalization Design is a logical grouping of a Physical Bundle, card logo, and carrier text that represents a product line.
+    class PersonalizationDesign < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "issuing.personalization_design"
+
+      def test_helpers
+        TestHelpers.new(self)
+      end
+
+      class TestHelpers < APIResourceTestHelpers
+        RESOURCE_CLASS = PersonalizationDesign
+
+        # Updates the status of the specified testmode personalization design object to active.
+        def self.activate(personalization_design, params = {}, opts = {})
+          request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/issuing/personalization_designs/%<personalization_design>s/activate", { personalization_design: CGI.escape(personalization_design) }),
+            params: params,
+            opts: opts
+          )
+        end
+
+        # Updates the status of the specified testmode personalization design object to inactive.
+        def self.deactivate(personalization_design, params = {}, opts = {})
+          request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/issuing/personalization_designs/%<personalization_design>s/deactivate", { personalization_design: CGI.escape(personalization_design) }),
+            params: params,
+            opts: opts
+          )
+        end
+
+        # Updates the status of the specified testmode personalization design object to rejected.
+        def self.reject(personalization_design, params = {}, opts = {})
+          request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/issuing/personalization_designs/%<personalization_design>s/reject", { personalization_design: CGI.escape(personalization_design) }),
+            params: params,
+            opts: opts
+          )
+        end
+
+        # Updates the status of the specified testmode personalization design object to active.
+        def activate(params = {}, opts = {})
+          @resource.request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/issuing/personalization_designs/%<personalization_design>s/activate", { personalization_design: CGI.escape(@resource["id"]) }),
+            params: params,
+            opts: opts
+          )
+        end
+
+        # Updates the status of the specified testmode personalization design object to inactive.
+        def deactivate(params = {}, opts = {})
+          @resource.request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/issuing/personalization_designs/%<personalization_design>s/deactivate", { personalization_design: CGI.escape(@resource["id"]) }),
+            params: params,
+            opts: opts
+          )
+        end
+
+        # Updates the status of the specified testmode personalization design object to rejected.
+        def reject(params = {}, opts = {})
+          @resource.request_stripe_object(
+            method: :post,
+            path: format("/v1/test_helpers/issuing/personalization_designs/%<personalization_design>s/reject", { personalization_design: CGI.escape(@resource["id"]) }),
+            params: params,
+            opts: opts
+          )
+        end
+      end
+    end
+  end
+end

lib/stripe/resources/issuing/physical_bundle.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # A Physical Bundle represents the bundle of physical items - card stock, carrier letter, and envelope - that is shipped to a cardholder when you create a physical card.
+    class PhysicalBundle < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "issuing.physical_bundle"
+    end
+  end
+end

lib/stripe/resources/margin.rb

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A (partner) margin represents a specific discount distributed in partner reseller programs to business partners who
+  # resell products and services and earn a discount (margin) for doing so.
+  class Margin < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "margin"
+  end
+end

lib/stripe/resources/order.rb

@@ -0,0 +1,97 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # An Order describes a purchase being made by a customer, including the
+  # products & quantities being purchased, the order status, the payment information,
+  # and the billing/shipping details.
+  #
+  # Related guide: [Orders overview](https://stripe.com/docs/orders)
+  class Order < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "order"
+
+    # Cancels the order as well as the payment intent if one is attached.
+    def cancel(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/orders/%<id>s/cancel", { id: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # When retrieving an order, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+    def list_line_items(params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/orders/%<id>s/line_items", { id: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Reopens a submitted order.
+    def reopen(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/orders/%<id>s/reopen", { id: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Submitting an Order transitions the status to processing and creates a PaymentIntent object so the order can be paid. If the Order has an amount_total of 0, no PaymentIntent object will be created. Once the order is submitted, its contents cannot be changed, unless the [reopen](https://stripe.com/docs/api#reopen_order) method is called.
+    def submit(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/orders/%<id>s/submit", { id: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Cancels the order as well as the payment intent if one is attached.
+    def self.cancel(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/orders/%<id>s/cancel", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # When retrieving an order, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+    def self.list_line_items(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/orders/%<id>s/line_items", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Reopens a submitted order.
+    def self.reopen(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/orders/%<id>s/reopen", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Submitting an Order transitions the status to processing and creates a PaymentIntent object so the order can be paid. If the Order has an amount_total of 0, no PaymentIntent object will be created. Once the order is submitted, its contents cannot be changed, unless the [reopen](https://stripe.com/docs/api#reopen_order) method is called.
+    def self.submit(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/orders/%<id>s/submit", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

lib/stripe/resources/quote.rb

@@ -8,9 +8,13 @@ module Stripe
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
+    extend Stripe::APIOperations::NestedResource
 
     OBJECT_NAME = "quote"
 
+    nested_resource_class_methods :preview_invoice, operations: %i[list]
+    nested_resource_class_methods :preview_subscription_schedule, operations: %i[list]
+
     # Accepts the specified quote.
     def accept(params = {}, opts = {})
       request_stripe_object(
@@ -61,6 +65,46 @@ module Stripe
       )
     end
 
+    # Retrieves a paginated list of lines for a quote. These lines describe changes that will be used to create new subscription schedules or update existing subscription schedules when the quote is accepted.
+    def list_lines(params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/lines", { quote: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Preview the invoice line items that would be generated by accepting the quote.
+    def list_preview_invoice_lines(preview_invoice, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/preview_invoices/%<preview_invoice>s/lines", { quote: CGI.escape(self["id"]), preview_invoice: CGI.escape(preview_invoice) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Converts a stale quote to draft.
+    def mark_draft(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_draft", { quote: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Converts a draft or open quote to stale.
+    def mark_stale(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_stale", { quote: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Download the PDF for a finalized quote
     def pdf(params = {}, opts = {}, &read_body_chunk_block)
       config = opts[:client]&.config || Stripe.config
@@ -74,6 +118,16 @@ module Stripe
       )
     end
 
+    # Recompute the upcoming invoice estimate for the quote.
+    def reestimate(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/reestimate", { quote: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Accepts the specified quote.
     def self.accept(quote, params = {}, opts = {})
       request_stripe_object(
@@ -124,6 +178,46 @@ module Stripe
       )
     end
 
+    # Retrieves a paginated list of lines for a quote. These lines describe changes that will be used to create new subscription schedules or update existing subscription schedules when the quote is accepted.
+    def self.list_lines(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/lines", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Preview the invoice line items that would be generated by accepting the quote.
+    def self.list_preview_invoice_lines(quote, preview_invoice, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/preview_invoices/%<preview_invoice>s/lines", { quote: CGI.escape(quote), preview_invoice: CGI.escape(preview_invoice) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Converts a stale quote to draft.
+    def self.mark_draft(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_draft", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Converts a draft or open quote to stale.
+    def self.mark_stale(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_stale", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Download the PDF for a finalized quote
     def self.pdf(quote, params = {}, opts = {}, &read_body_chunk_block)
       config = opts[:client]&.config || Stripe.config
@@ -136,5 +230,15 @@ module Stripe
         &read_body_chunk_block
       )
     end
+
+    # Recompute the upcoming invoice estimate for the quote.
+    def self.reestimate(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/reestimate", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

lib/stripe/resources/quote_phase.rb

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A quote phase describes the line items, coupons, and trialing status of a subscription for a predefined time period.
+  class QuotePhase < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "quote_phase"
+
+    # When retrieving a quote phase, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+    def list_line_items(params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quote_phases/%<quote_phase>s/line_items", { quote_phase: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # When retrieving a quote phase, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+    def self.list_line_items(quote_phase, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quote_phases/%<quote_phase>s/line_items", { quote_phase: CGI.escape(quote_phase) }),
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

lib/stripe/resources/quote_preview_invoice.rb

@@ -0,0 +1,42 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # Invoices are statements of amounts owed by a customer, and are either
+  # generated one-off, or generated periodically from a subscription.
+  #
+  # They contain [invoice items](https://stripe.com/docs/api#invoiceitems), and proration adjustments
+  # that may be caused by subscription upgrades/downgrades (if necessary).
+  #
+  # If your invoice is configured to be billed through automatic charges,
+  # Stripe automatically finalizes your invoice and attempts payment. Note
+  # that finalizing the invoice,
+  # [when automatic](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection), does
+  # not happen immediately as the invoice is created. Stripe waits
+  # until one hour after the last webhook was successfully sent (or the last
+  # webhook timed out after failing). If you (and the platforms you may have
+  # connected to) have no webhooks configured, Stripe waits one hour after
+  # creation to finalize the invoice.
+  #
+  # If your invoice is configured to be billed by sending an email, then based on your
+  # [email settings](https://dashboard.stripe.com/account/billing/automatic),
+  # Stripe will email the invoice to your customer and await payment. These
+  # emails can contain a link to a hosted page to pay the invoice.
+  #
+  # Stripe applies any customer credit on the account before determining the
+  # amount due for the invoice (i.e., the amount that will be actually
+  # charged). If the amount due for the invoice is less than Stripe's [minimum allowed charge
+  # per currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts), the
+  # invoice is automatically marked paid, and we add the amount due to the
+  # customer's credit balance which is applied to the next invoice.
+  #
+  # More details on the customer's credit balance are
+  # [here](https://stripe.com/docs/billing/customer/balance).
+  #
+  # Related guide: [Send invoices to customers](https://stripe.com/docs/billing/invoices/sending)
+  class QuotePreviewInvoice < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "quote_preview_invoice"
+  end
+end

lib/stripe/resources/quote_preview_subscription_schedule.rb

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class QuotePreviewSubscriptionSchedule < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "quote_preview_subscription_schedule"
+  end
+end

lib/stripe/resources/subscription_schedule.rb

@@ -12,6 +12,16 @@ module Stripe
 
     OBJECT_NAME = "subscription_schedule"
 
+    # Amends an existing subscription schedule.
+    def amend(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscription_schedules/%<schedule>s/amend", { schedule: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
     def cancel(params = {}, opts = {})
       request_stripe_object(
@@ -32,6 +42,16 @@ module Stripe
       )
     end
 
+    # Amends an existing subscription schedule.
+    def self.amend(schedule, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscription_schedules/%<schedule>s/amend", { schedule: CGI.escape(schedule) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
     def self.cancel(schedule, params = {}, opts = {})
       request_stripe_object(

lib/stripe/resources/tax/form.rb

@@ -0,0 +1,41 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    # Tax forms are legal documents which are delivered to one or more tax authorities for information reporting purposes.
+    #
+    # Related guide: [US tax reporting for Connect platforms](https://stripe.com/docs/connect/tax-reporting)
+    class Form < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "tax.form"
+
+      # Download the PDF for a tax form.
+      def pdf(params = {}, opts = {}, &read_body_chunk_block)
+        config = opts[:client]&.config || Stripe.config
+        opts = { api_base: config.uploads_base }.merge(opts)
+        request_stream(
+          method: :get,
+          path: format("/v1/tax/forms/%<id>s/pdf", { id: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts,
+          &read_body_chunk_block
+        )
+      end
+
+      # Download the PDF for a tax form.
+      def self.pdf(id, params = {}, opts = {}, &read_body_chunk_block)
+        config = opts[:client]&.config || Stripe.config
+        opts = { api_base: config.uploads_base }.merge(opts)
+        execute_resource_request_stream(
+          :get,
+          format("/v1/tax/forms/%<id>s/pdf", { id: CGI.escape(id) }),
+          params,
+          opts,
+          &read_body_chunk_block
+        )
+      end
+    end
+  end
+end

lib/stripe/resources/terminal/reader.rb

@@ -24,6 +24,36 @@ module Stripe
         )
       end
 
+      # Initiates an input collection flow on a Reader.
+      def collect_inputs(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/collect_inputs", { reader: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Initiates a payment flow on a Reader and updates the PaymentIntent with card details before manual confirmation.
+      def collect_payment_method(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/collect_payment_method", { reader: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Finalizes a payment on a Reader.
+      def confirm_payment_intent(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/confirm_payment_intent", { reader: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
       # Initiates a payment flow on a Reader.
       def process_payment_intent(params = {}, opts = {})
         request_stripe_object(
@@ -74,6 +104,36 @@ module Stripe
         )
       end
 
+      # Initiates an input collection flow on a Reader.
+      def self.collect_inputs(reader, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/collect_inputs", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Initiates a payment flow on a Reader and updates the PaymentIntent with card details before manual confirmation.
+      def self.collect_payment_method(reader, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/collect_payment_method", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Finalizes a payment on a Reader.
+      def self.confirm_payment_intent(reader, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/confirm_payment_intent", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts
+        )
+      end
+
       # Initiates a payment flow on a Reader.
       def self.process_payment_intent(reader, params = {}, opts = {})
         request_stripe_object(

lib/stripe/stripe_client.rb

@@ -209,9 +209,10 @@ module Stripe
     end
 
     def execute_request(method, path,
-                        api_base: nil, api_key: nil, headers: {}, params: {}, usage: [])
+                        api_base: nil, api_key: nil,
+                        headers: {}, params: {}, api_mode: nil, usage: [])
       http_resp, api_key = execute_request_internal(
-        method, path, api_base, api_key, headers, params, usage
+        method, path, api_base, api_key, headers, params, api_mode, usage
       )
 
       begin
@@ -242,6 +243,7 @@ module Stripe
     def execute_request_stream(method, path,
                                api_base: nil, api_key: nil, usage: [],
                                headers: {}, params: {},
+                               api_mode: nil,
                                &read_body_chunk_block)
       unless block_given?
         raise ArgumentError,
@@ -249,7 +251,8 @@ module Stripe
       end
 
       http_resp, api_key = execute_request_internal(
-        method, path, api_base, api_key, headers, params, usage, &read_body_chunk_block
+        method, path, api_base, api_key,
+        headers, params, api_mode, usage, &read_body_chunk_block
       )
 
       # When the read_body_chunk_block is given, we no longer have access to the
@@ -428,8 +431,8 @@ module Stripe
     end
 
     private def execute_request_internal(method, path,
-                                         api_base, api_key, headers, params, usage,
+                                         api_base, api_key, headers, params,
-                                         &read_body_chunk_block)
+                                         api_mode, usage, &read_body_chunk_block)
       raise ArgumentError, "method should be a symbol" \
       unless method.is_a?(Symbol)
       raise ArgumentError, "path should be a string" \
@@ -437,9 +440,10 @@ module Stripe
 
       api_base ||= config.api_base
       api_key ||= config.api_key
+      authenticator ||= config.authenticator
       params = Util.objects_to_ids(params)
 
-      check_api_key!(api_key)
+      check_keys!(api_key, authenticator)
 
       body_params = nil
       query_params = nil
@@ -452,8 +456,9 @@ module Stripe
 
       query_params, path = merge_query_params(query_params, path)
 
-      headers = request_headers(api_key, method)
+      headers = request_headers(api_key, method, api_mode)
                 .update(Util.normalize_headers(headers))
+
       url = api_url(path, api_base)
 
       # Merge given query parameters with any already encoded in the path.
@@ -464,13 +469,16 @@ module Stripe
       # a log-friendly variant of the encoded form. File objects are displayed
       # as such instead of as their file contents.
       body, body_log =
-        body_params ? encode_body(body_params, headers) : [nil, nil]
+        body_params ? encode_body(body_params, headers, api_mode) : [nil, nil]
+
+      authenticator.authenticate(method, headers, body) unless api_key
 
       # stores information on the request we're about to make so that we don't
       # have to pass as many parameters around for logging.
       context = RequestLogContext.new
       context.account         = headers["Stripe-Account"]
       context.api_key         = api_key
+      context.authenticator   = authenticator
       context.api_version     = headers["Stripe-Version"]
       context.body            = body_log
       context.idempotency_key = headers["Idempotency-Key"]
@@ -507,8 +515,16 @@ module Stripe
       (api_base || config.api_base) + url
     end
 
-    private def check_api_key!(api_key)
+    private def check_keys!(api_key, authenticator)
-      unless api_key
+      if api_key && authenticator
+        raise AuthenticationError, "Can't specify both API key " \
+                                   "and authenticator. Either set your API key" \
+                                   'using "Stripe.api_key = <API-KEY>", or set your authenticator ' \
+                                   'using "Stripe.authenticator = <AUTHENTICATOR>"' \
+      end
+
+      unless api_key || authenticator
+        # Default to missing API key error message for general users.
         raise AuthenticationError, "No API key provided. " \
                                    'Set your API key using "Stripe.api_key = <API-KEY>". ' \
                                    "You can generate API keys from the Stripe web interface. " \
@@ -527,7 +543,7 @@ module Stripe
     # Encodes a set of body parameters using multipart if `Content-Type` is set
     # for that, or standard form-encoding otherwise. Returns the encoded body
     # and a version of the encoded body that's safe to be logged.
-    private def encode_body(body_params, headers)
+    private def encode_body(body_params, headers, api_mode)
       body = nil
       flattened_params = Util.flatten_params(body_params)
 
@@ -543,15 +559,22 @@ module Stripe
         flattened_params =
           flattened_params.map { |k, v| [k, v.is_a?(String) ? v : v.to_s] }.to_h
 
+      elsif api_mode == :preview
+        body = JSON.generate(body_params)
+        headers["Content-Type"] = "application/json"
       else
         body = Util.encode_parameters(body_params)
       end
 
-      # We don't use `Util.encode_parameters` partly as an optimization (to not
+      body_log = if api_mode == :preview
-      # redo work we've already done), and partly because the encoded forms of
+                   body
-      # certain characters introduce a lot of visual noise and it's nice to
+                 else
-      # have a clearer format for logs.
+                   # We don't use `Util.encode_parameters` partly as an optimization (to
-      body_log = flattened_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                   # not redo work we've already done), and partly because the encoded
+                   # forms of certain characters introduce a lot of visual noise and it's
+                   # nice to have a clearer format for logs.
+                   flattened_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                 end
 
       [body, body_log]
     end
@@ -738,10 +761,11 @@ module Stripe
     end
 
     private def specific_api_error(resp, error_data, context)
+      message = error_data[:message]
       Util.log_error("Stripe API error",
                      status: resp.http_status,
                      error_code: error_data[:code],
-                     error_message: error_data[:message],
+                     error_message: message,
                      error_param: error_data[:param],
                      error_type: error_data[:type],
                      idempotency_key: context.idempotency_key,
@@ -762,26 +786,26 @@ module Stripe
       when 400, 404
         case error_data[:type]
         when "idempotency_error"
-          IdempotencyError.new(error_data[:message], **opts)
+          IdempotencyError.new(message, **opts)
         else
           InvalidRequestError.new(
-            error_data[:message], error_data[:param],
+            message, error_data[:param],
             **opts
           )
         end
       when 401
-        AuthenticationError.new(error_data[:message], **opts)
+        AuthenticationError.new(message, **opts)
       when 402
         CardError.new(
-          error_data[:message], error_data[:param],
+          message, error_data[:param],
           **opts
         )
       when 403
-        PermissionError.new(error_data[:message], **opts)
+        PermissionError.new(message, **opts)
       when 429
-        RateLimitError.new(error_data[:message], **opts)
+        RateLimitError.new(message, **opts)
       else
-        APIError.new(error_data[:message], **opts)
+        APIError.new(message, **opts)
       end
     end
 
@@ -849,16 +873,20 @@ module Stripe
             message + "\n\n(Network error: #{error.message})"
     end
 
-    private def request_headers(api_key, method)
+    private def request_headers(api_key, method, api_mode)
       user_agent = "Stripe/v1 RubyBindings/#{Stripe::VERSION}"
       user_agent += " " + format_app_info(Stripe.app_info) unless Stripe.app_info.nil?
 
       headers = {
         "User-Agent" => user_agent,
         "Authorization" => "Bearer #{api_key}",
-        "Content-Type" => "application/x-www-form-urlencoded",
       }
 
+      if api_mode != :preview
+        # TODO: (major) don't set Content-Type if method is not post
+        headers["Content-Type"] = "application/x-www-form-urlencoded"
+      end
+
       if config.enable_telemetry? && !@last_request_metrics.nil?
         headers["X-Stripe-Client-Telemetry"] = JSON.generate(
           last_request_metrics: @last_request_metrics.payload
@@ -871,7 +899,12 @@ module Stripe
         headers["Idempotency-Key"] ||= SecureRandom.uuid
       end
 
-      headers["Stripe-Version"] = config.api_version if config.api_version
+      if api_mode == :preview
+        headers["Stripe-Version"] = ApiVersion::PREVIEW
+      elsif config.api_version
+        headers["Stripe-Version"] = config.api_version
+      end
+
       headers["Stripe-Account"] = config.stripe_account if config.stripe_account
 
       user_agent = @system_profiler.user_agent
@@ -954,7 +987,8 @@ module Stripe
     # that we can log certain information. It's useful because it means that we
     # don't have to pass around as many parameters.
     class RequestLogContext
-      attr_accessor :body, :account, :api_key, :api_version, :idempotency_key, :method, :path, :query, :request_id
+      attr_accessor :body, :account, :api_key, :authenticator, :api_version, :idempotency_key, :method, :path, :query,
+                    :request_id
 
       # The idea with this method is that we might want to update some of
       # context information because a response that we've received from the API

lib/stripe/stripe_configuration.rb

@@ -25,7 +25,7 @@ module Stripe
   # If `.logger` is set, the value of `.log_level` is ignored. The decision on
   # what levels to print is entirely deferred to the logger.
   class StripeConfiguration
-    attr_accessor :api_key, :api_version, :client_id, :enable_telemetry, :logger, :stripe_account
+    attr_accessor :api_key, :api_version, :authenticator, :client_id, :enable_telemetry, :logger, :stripe_account
 
     attr_reader :api_base, :uploads_base, :connect_base, :ca_bundle_path, :log_level, :initial_network_retry_delay,
                 # rubocop:todo Layout/LineLength
@@ -50,6 +50,7 @@ module Stripe
 
     def initialize
       @api_version = ApiVersion::CURRENT
+
       @ca_bundle_path = Stripe::DEFAULT_CA_BUNDLE_PATH
       @enable_telemetry = true
       @verify_ssl_certs = true

lib/stripe/util.rb

@@ -7,6 +7,7 @@ module Stripe
     # Options that a user is allowed to specify.
     OPTS_USER_SPECIFIED = Set[
       :api_key,
+      :authenticator,
       :idempotency_key,
       :stripe_account,
       :stripe_version
@@ -279,7 +280,13 @@ module Stripe
       when String
         { api_key: opts }
       when Hash
-        check_api_key!(opts.fetch(:api_key)) if opts.key?(:api_key)
+        # If the user is using request signing for authentication,
+        # no need to check the api_key per request.
+        if !(opts.key?(:client) &&
+           opts.fetch(:client).config.authenticator) &&
+           opts.key?(:api_key)
+          check_api_key!(opts.fetch(:api_key))
+        end
         # Explicitly use dup here instead of clone to avoid preserving freeze
         # state on input params.
         opts.dup

lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "10.5.0"
+  VERSION = "10.6.0-beta.1"
 end

test/stripe/api_resource_test.rb

@@ -80,6 +80,19 @@ module Stripe
 
     should "not specifying api credentials should raise an exception" do
       Stripe.api_key = nil
+      Stripe.authenticator = nil
+      assert_raises Stripe::AuthenticationError do
+        Stripe::Customer.new("cus_123").refresh
+      end
+    end
+
+    should "specifying both api_key and authenticator should raise an exception" do
+      Stripe.api_key = "sk_123"
+
+      def no_op; end
+
+      Stripe.authenticator = method(:no_op)
+
       assert_raises Stripe::AuthenticationError do
         Stripe::Customer.new("cus_123").refresh
       end

test/stripe/generated_examples_test.rb

@@ -1232,6 +1232,10 @@ module Stripe
       Stripe::Quote.update("qt_xxxxxxxxxxxxx", { metadata: { order_id: "6735" } })
       assert_requested :post, "#{Stripe.api_base}/v1/quotes/qt_xxxxxxxxxxxxx"
     end
+    should "Test quotes preview invoices lines get" do
+      Stripe::Quote.list_preview_invoice_lines("qt_xyz", "in_xyz")
+      assert_requested :get, "#{Stripe.api_base}/v1/quotes/qt_xyz/preview_invoices/in_xyz/lines?"
+    end
     should "Test radar early fraud warnings get" do
       Stripe::Radar::EarlyFraudWarning.list({ limit: 3 })
       assert_requested :get, "#{Stripe.api_base}/v1/radar/early_fraud_warnings?limit=3"
@@ -1565,6 +1569,11 @@ module Stripe
       Stripe::TaxCode.retrieve("txcd_xxxxxxxxxxxxx")
       assert_requested :get, "#{Stripe.api_base}/v1/tax_codes/txcd_xxxxxxxxxxxxx?"
     end
+    should "Test tax forms pdf get" do
+      block_handler = {}
+      Stripe::Tax::Form.pdf("form_xxxxxxxxxxxxx", &block_handler)
+      assert_requested :get, "#{Stripe.api_base}/v1/tax/forms/form_xxxxxxxxxxxxx/pdf?"
+    end
     should "Test tax rates get" do
       Stripe::TaxRate.list({ limit: 3 })
       assert_requested :get, "#{Stripe.api_base}/v1/tax_rates?limit=3"

test/stripe/preview_test.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require File.expand_path("../test_helper", __dir__)
+
+class PreviewTest < Test::Unit::TestCase
+  context "preview raw requests" do
+    should "send preview get request with correct default options" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:get, "#{Stripe.api_base}/v2/accounts/acc_123")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe::Preview.get("/v2/accounts/acc_123")
+
+      assert_equal nil, req.headers["Content-Type"]
+      assert_equal Stripe::ApiVersion::PREVIEW, req.headers["Stripe-Version"]
+      assert_equal expected_body, resp.http_body
+    end
+
+    should "send preview post request with correct default options" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:post, "#{Stripe.api_base}/v2/accounts")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe::Preview.post("/v2/accounts", { p1: 1, p2: "string" })
+
+      assert_equal "application/json", req.headers["Content-Type"]
+      assert_equal Stripe::ApiVersion::PREVIEW, req.headers["Stripe-Version"]
+      assert_equal "{\"p1\":1,\"p2\":\"string\"}", req.body
+      assert_equal expected_body, resp.http_body
+    end
+
+    should "send preview delete request with correct default options" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:delete, "#{Stripe.api_base}/v2/accounts/acc_123")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe::Preview.delete("/v2/accounts/acc_123")
+
+      assert_equal nil, req.headers["Content-Type"]
+      assert_equal Stripe::ApiVersion::PREVIEW, req.headers["Stripe-Version"]
+      assert_equal expected_body, resp.http_body
+    end
+
+    should "allow overriding default options for preview requests" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      stripe_version_override = "2022-11-15"
+      req = nil
+
+      stub_request(:post, "#{Stripe.api_base}/v2/accounts")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe::Preview.post("/v2/accounts", {}, { stripe_version: stripe_version_override })
+
+      assert_equal "application/json", req.headers["Content-Type"]
+      assert_equal stripe_version_override, req.headers["Stripe-Version"]
+      assert_equal expected_body, resp.http_body
+    end
+
+    should "allow setting stripe_context for preview requests" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      stripe_context = "acc_123"
+      req = nil
+
+      stub_request(:post, "#{Stripe.api_base}/v2/accounts")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      Stripe::Preview.post("/v2/accounts", {}, { stripe_context: stripe_context })
+
+      assert_equal "application/json", req.headers["Content-Type"]
+      assert_equal stripe_context, req.headers["Stripe-Context"]
+    end
+  end
+end

test/stripe/raw_request_test.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require File.expand_path("../test_helper", __dir__)
+
+class RawRequestTest < Test::Unit::TestCase
+  context "raw_request" do
+    should "send get request and return a response" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:get, "#{Stripe.api_base}/v1/accounts/acc_123")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe.raw_request(:get, "/v1/accounts/acc_123")
+
+      assert_equal expected_body, resp.http_body
+      assert_equal "application/x-www-form-urlencoded", req.headers["Content-Type"]
+      assert_equal Stripe::ApiVersion::CURRENT, req.headers["Stripe-Version"]
+    end
+
+    should "send post request with body and return a response" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:post, "#{Stripe.api_base}/v1/accounts/acc_123")
+        .with(body: "p1=1&p2=string")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe.raw_request(:post, "/v1/accounts/acc_123", { p1: 1, p2: "string" })
+
+      assert_equal expected_body, resp.http_body
+      assert_equal "application/x-www-form-urlencoded", req.headers["Content-Type"]
+      assert_equal Stripe::ApiVersion::CURRENT, req.headers["Stripe-Version"]
+    end
+
+    should "send post request with json body and return a response" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:post, "#{Stripe.api_base}/v1/accounts/acc_123")
+        .with(body: "{\"p1\":1,\"p2\":\"string\"}")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe.raw_request(:post, "/v1/accounts/acc_123", { p1: 1, p2: "string" }, { api_mode: :preview })
+
+      assert_equal expected_body, resp.http_body
+      assert_equal "application/json", req.headers["Content-Type"]
+      assert_equal Stripe::ApiVersion::PREVIEW, req.headers["Stripe-Version"]
+    end
+
+    should "send post request with json body and headers and return a response" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:post, "#{Stripe.api_base}/v1/accounts/acc_123")
+        .with(body: "{\"p1\":1,\"p2\":\"string\"}")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe.raw_request(:post, "/v1/accounts/acc_123", { p1: 1, p2: "string" }, { api_mode: :preview, "Stripe-Context": "bar" })
+
+      assert_equal expected_body, resp.http_body
+      assert_equal "application/json", req.headers["Content-Type"]
+      assert_equal Stripe::ApiVersion::PREVIEW, req.headers["Stripe-Version"]
+      assert_equal "bar", req.headers["Stripe-Context"]
+    end
+
+    should "send get request with json body and headers and return a response" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:get, "#{Stripe.api_base}/v1/accounts/acc_123")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      resp = Stripe.raw_request(:get, "/v1/accounts/acc_123", {}, { api_mode: :preview, "Stripe-Account": "bar" })
+
+      assert_not_equal "application/x-www-form-urlencoded", req.headers["Content-Type"]
+      assert_equal expected_body, resp.http_body
+    end
+
+    should "set default preview version when api_mode is preview and stripe_version not specified" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:get, "#{Stripe.api_base}/v1/accounts/acc_123")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      Stripe.raw_request(:get, "/v1/accounts/acc_123", {}, { api_mode: :preview })
+
+      assert_equal Stripe::ApiVersion::PREVIEW, req.headers["Stripe-Version"]
+    end
+
+    should "allow overriding stripe version when api_mode is preview" do
+      expected_body = "{\"id\": \"acc_123\"}"
+      req = nil
+
+      stub_request(:get, "#{Stripe.api_base}/v1/accounts/acc_123")
+        .with { |request| req = request }
+        .to_return(body: expected_body)
+
+      stripe_version_override = "2023-05-15.preview"
+      Stripe.raw_request(:get, "/v1/accounts/acc_123", {}, { api_mode: :preview, stripe_version: stripe_version_override })
+
+      assert_equal stripe_version_override, req.headers["Stripe-Version"]
+    end
+  end
+end

test/stripe/request_signing_authenticator_test.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require File.expand_path("../test_helper", __dir__)
+
+module Stripe
+  class RequestSigningAuthenticatorTest < Test::Unit::TestCase
+    TEST_AUTH_TOKEN = "keyid"
+    TEST_SIGN_LAMBDA = -> {}
+
+    context "initialize" do
+      should "raise error if given non-String auth token" do
+        assert_raises ArgumentError do
+          Stripe::RequestSigningAuthenticator.new(123, TEST_SIGN_LAMBDA)
+        end
+      end
+
+      should "raise error if given non-lambda sign function" do
+        assert_raises ArgumentError do
+          Stripe::RequestSigningAuthenticator.new(TEST_AUTH_TOKEN, nil)
+        end
+      end
+
+      should "create a new authenticator with valid arguments" do
+        authenticator = Stripe::RequestSigningAuthenticator.new(TEST_AUTH_TOKEN, TEST_SIGN_LAMBDA)
+        assert_equal(authenticator.auth_token, TEST_AUTH_TOKEN)
+        assert_equal(authenticator.sign_lambda, TEST_SIGN_LAMBDA)
+      end
+    end
+
+    context ".authenticate" do
+      setup do
+        RequestSigningAuthenticator.any_instance.stubs(:created_time).returns(123_456_789)
+      end
+
+      should "applies signature for POST requests" do
+        signature_bases = []
+        sign = lambda { |signature_base|
+          signature_bases.push(signature_base)
+          return [1, 2, 3, 4, 5].pack("C*")
+        }
+
+        authenticator = RequestSigningAuthenticator.new(TEST_AUTH_TOKEN, sign)
+        headers = { "Content-Type" => "application/json" }
+        authenticator.authenticate(:post, headers, '{"string":"String!"}')
+
+        assert_equal("\"content-type\": application/json\n" \
+                     "\"content-digest\": sha-256=:HA3i38j+04ac71IzPtG1JK8o4q9sPK0fYPmJHmci5bg=:\n" \
+                     "\"stripe-context\": \n" \
+                     "\"stripe-account\": \n" \
+                     "\"authorization\": STRIPE-V2-SIG keyid\n" \
+                     "\"@signature-params\": (\"content-type\" \"content-digest\" \"stripe-context\" \"stripe-account\" \"authorization\");created=123456789",
+                     signature_bases[0].force_encoding(Encoding::UTF_8))
+
+        assert_equal('sig1=("content-type" "content-digest" "stripe-context" "stripe-account" "authorization");' \
+                     "created=123456789", headers["Signature-Input"])
+        assert_equal("sha-256=:HA3i38j+04ac71IzPtG1JK8o4q9sPK0fYPmJHmci5bg=:", headers["Content-Digest"])
+        assert_equal("sig1=:AQIDBAU=:", headers["Signature"])
+        assert_equal("STRIPE-V2-SIG keyid", headers["Authorization"])
+      end
+
+      should "applies signature for DELETE requests" do
+        signature_bases = []
+        sign = lambda { |signature_base|
+          signature_bases.push(signature_base)
+          return [1, 2, 3, 4, 5].pack("C*")
+        }
+
+        authenticator = RequestSigningAuthenticator.new(TEST_AUTH_TOKEN, sign)
+        headers = { "Content-Type" => "application/json" }
+        authenticator.authenticate(:delete, headers, nil)
+
+        assert_equal("\"content-type\": application/json\n" \
+                     "\"content-digest\": sha-256=:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=:\n" \
+                     "\"stripe-context\": \n" \
+                     "\"stripe-account\": \n" \
+                     "\"authorization\": STRIPE-V2-SIG keyid\n" \
+                     "\"@signature-params\": (\"content-type\" \"content-digest\" \"stripe-context\" \"stripe-account\" \"authorization\");created=123456789",
+                     signature_bases[0].force_encoding(Encoding::UTF_8))
+
+        assert_equal('sig1=("content-type" "content-digest" "stripe-context" "stripe-account" "authorization");' \
+                     "created=123456789", headers["Signature-Input"])
+        assert_equal("sha-256=:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=:", headers["Content-Digest"])
+        assert_equal("sig1=:AQIDBAU=:", headers["Signature"])
+        assert_equal("STRIPE-V2-SIG keyid", headers["Authorization"])
+      end
+
+      should "applies signature for GET requests" do
+        signature_bases = []
+        sign = lambda { |signature_base|
+          signature_bases.push(signature_base)
+          return [1, 2, 3, 4, 5].pack("C*")
+        }
+
+        authenticator = RequestSigningAuthenticator.new(TEST_AUTH_TOKEN, sign)
+        headers = {}
+        authenticator.authenticate(:get, headers, nil)
+
+        assert_equal("\"stripe-context\": \n" \
+                     "\"stripe-account\": \n" \
+                     "\"authorization\": STRIPE-V2-SIG keyid\n" \
+                     "\"@signature-params\": (\"stripe-context\" \"stripe-account\" \"authorization\");created=123456789",
+                     signature_bases[0].force_encoding(Encoding::UTF_8))
+
+        assert_equal('sig1=("stripe-context" "stripe-account" "authorization");' \
+                     "created=123456789", headers["Signature-Input"])
+        assert_nil(headers["Content-Digest"])
+        assert_equal("sig1=:AQIDBAU=:", headers["Signature"])
+        assert_equal("STRIPE-V2-SIG keyid", headers["Authorization"])
+      end
+    end
+  end
+end

test/stripe/stripe_client_test.rb

@@ -476,6 +476,55 @@ module Stripe
           end
         end
 
+        context "signing headers" do
+          setup do
+            RequestSigningAuthenticator.any_instance.stubs(:content_digest).returns("digest")
+            RequestSigningAuthenticator.any_instance.stubs(:created_time).returns(1_234_567_890)
+            RequestSigningAuthenticator.any_instance.stubs(:encoded_signature).returns("signature")
+
+            Stripe.api_key = nil
+            Stripe.authenticator = RequestSigningAuthenticator.new("keyinfo_test_123", -> {})
+          end
+
+          should "apply valid signing headers for get requests" do
+            stub_request(:get, "#{Stripe.api_base}/v1/charges/ch_123")
+              .to_return(body: JSON.generate(object: "charge"))
+
+            client = StripeClient.new
+            client.send(request_method, :get, "/v1/charges/ch_123",
+                        &@read_body_chunk_block)
+            assert_requested(
+              :get,
+              "#{Stripe.api_base}/v1/charges/ch_123",
+              headers: {
+                "Authorization" => "STRIPE-V2-SIG keyinfo_test_123",
+                "Signature" => "sig1=:signature:",
+                "Signature-Input" => 'sig1=("stripe-context" "stripe-account" "authorization");created=1234567890',
+              }
+            )
+          end
+
+          should "apply valid signing headers for post requests" do
+            stub_request(:post, "#{Stripe.api_base}/v1/charges")
+              .to_return(body: JSON.generate(object: "charge"))
+
+            client = StripeClient.new
+            client.send(request_method, :post, "/v1/charges",
+                        &@read_body_chunk_block)
+
+            assert_requested(
+              :post,
+              "#{Stripe.api_base}/v1/charges",
+              headers: {
+                "Authorization" => "STRIPE-V2-SIG keyinfo_test_123",
+                "Content-Digest" => "sha-256=:digest:",
+                "Signature" => "sig1=:signature:",
+                "Signature-Input" => 'sig1=("content-type" "content-digest" "stripe-context" "stripe-account" "authorization");created=1234567890',
+              }
+            )
+          end
+        end
+
         context "logging" do
           setup do
             # Freeze time for the purposes of the `elapsed` parameter that we

test/stripe_test.rb

@@ -134,4 +134,42 @@ class StripeTest < Test::Unit::TestCase
       assert_equal "client", Stripe.client_id
     end
   end
+
+  context "deserialize" do
+    should "deserializes string into known object" do
+      expected_body = "{\"id\": \"acc_123\", \"object\": \"account\"}"
+
+      obj = Stripe.deserialize(expected_body)
+
+      assert_equal obj.class, Stripe::Account
+      assert_equal obj.id, "acc_123"
+    end
+
+    should "deserializes string into unknown object" do
+      expected_body = "{\"id\": \"acc_123\", \"object\": \"unknown\"}"
+
+      obj = Stripe.deserialize(expected_body)
+
+      assert_equal obj.class, Stripe::StripeObject
+      assert_equal obj.id, "acc_123"
+    end
+
+    should "deserializes hash into known object" do
+      expected_body = { "id" => "acc_123", "object" => "account" }
+
+      obj = Stripe.deserialize(expected_body)
+
+      assert_equal obj.class, Stripe::Account
+      assert_equal obj.id, "acc_123"
+    end
+
+    should "deserializes hash into unknown object" do
+      expected_body = { "id" => "acc_123", "object" => "unknown" }
+
+      obj = Stripe.deserialize(expected_body)
+
+      assert_equal obj.class, Stripe::StripeObject
+      assert_equal obj.id, "acc_123"
+    end
+  end
 end

test/test_helper.rb

@@ -67,6 +67,8 @@ module Test
         Stripe.api_base = "http://localhost:#{MOCK_PORT}"
         Stripe.uploads_base = "http://localhost:#{MOCK_PORT}"
 
+        Stripe.authenticator = nil
+
         stub_connect
       end