Merge pull request #1607 from stripe/latest-codegen-beta

Update generated code for beta

Author: stripe-openapi[bot]

API_VERSION

@@ -0,0 +1 @@
+2025-06-30.preview

CHANGELOG.md

@@ -42,6 +42,11 @@ This release changes the pinned API version to `2025-05-28.preview`.
   * Add support for `tax_transaction_attempts` on `Tax::Association`
   * Add support for `confirm_config` on `Terminal::Reader::Action::ConfirmPaymentIntent` and `Terminal::Reader::ConfirmPaymentIntentParams`
 
+## 15.2.1 - 2025-06-04
+* [#1617](https://github.com/stripe/stripe-ruby/pull/1617) Fix `nil` requestor in `Webhook.construct_event` to allow for event data refresh
+  * Fix bug where `Event` constructed from `Webhook.construct_event` could not be refreshed due to a `nil` APIRequestor
+    * Raised in https://github.com/stripe/stripe-ruby/issues/1616
+
 ## 15.2.0 - 2025-05-29
  This release changes the pinned API version to `2025-05-28.basil`.
 
@@ -224,15 +229,15 @@ This release changes the pinned API version to `2025-05-28.preview`.
   * Adds explicit field types for resources and parameters for methods, and add RBI static annotations for all resources and services
   ![image](https://github.com/user-attachments/assets/1b6cd994-d3ea-4f47-8487-f5c7b9ebf885)
   * See [the wiki](https://github.com/stripe/stripe-ruby/wiki/Static-Type-Annotations) for more details
-  
+
 * [#1543](https://github.com/stripe/stripe-ruby/pull/1543) Support for APIs in the new API version 2025-03-31.basil
 
   This release changes the pinned API version to `2025-03-31.basil`.
-  
+
   ### ⚠️ Breaking changes  due to changes in the Stripe API
 
   Please review details for the breaking changes and alternatives in the [Stripe API changelog](https://docs.stripe.com/changelog/basil) before upgrading.
-  
+
   * Remove support for resources `SubscriptionItemUsageRecordSummary` and `SubscriptionItemUsageRecord`
   * Remove support for `create` method on resource `SubscriptionItemUsageRecord`
   * Remove support for `list` method on resource `SubscriptionItemUsageRecordSummary`
@@ -242,9 +247,9 @@ This release changes the pinned API version to `2025-05-28.preview`.
   * [#1553](https://github.com/stripe/stripe-ruby/pull/1553) Remove public idempotent_replayed? method
     * ⚠️ Remove the `idempotent_replayed?` method on `StripeError`
       * The information is accessible indirectly via the raw response headers, `StripeResponse.http_headers`. For example, use `resource.last_response.http_headers['Idempotent-Replayed']`
-  
+
   ### Additions to the Stripe API
-  
+
   * Add support for new resource `InvoicePayment`
   * Add support for `list` and `retrieve` methods on resource `InvoicePayment`
 
@@ -255,16 +260,16 @@ This release changes the pinned API version to `2025-05-28.preview`.
   * Add support for `succeed_input_collection` and `timeout_input_collection` test helper methods on resource `Terminal.Reader`
 * [#1545](https://github.com/stripe/stripe-ruby/pull/1545) fix ruby merge conflict for beta
 
-## 13.5.0-beta.1 - 2025-02-07
-* [#1527](https://github.com/stripe/stripe-ruby/pull/1527) Update generated code for beta
-
 ## 13.5.0 - 2025-02-24
 * [#1534](https://github.com/stripe/stripe-ruby/pull/1534) Update generated code
   * Fixed `Stripe::InvoiceLineItem.update` method.
 * [#1536](https://github.com/stripe/stripe-ruby/pull/1536) Fix InvoiceLineItem parent class
   * Fix bug where `Stripe::InvoiceLineItem` had the incorrect parent class, making it error when `update` was called
 * [#1533](https://github.com/stripe/stripe-ruby/pull/1533) add codeowners file
 
+## 13.5.0-beta.1 - 2025-02-07
+* [#1527](https://github.com/stripe/stripe-ruby/pull/1527) Update generated code for beta
+
 ## 13.4.1 - 2025-01-28
 * [#1528](https://github.com/stripe/stripe-ruby/pull/1528) Update generated code
   * ⚠️ Bugfix: `invoice` and `line_item_id` can be passed to `update` method in `InvoiceLineItem`.
@@ -394,7 +399,7 @@ This release changes the pinned API version to `2025-05-28.preview`.
 ## 13.0.0 - 2024-10-01
 * [#1458](https://github.com/stripe/stripe-ruby/pull/1458) Support for APIs in the new API version 2024-09-30.acacia
 
-  This release changes the pinned API version to `2024-09-30.acacia`. Please read the [API Upgrade Guide](https://stripe.com/docs/upgrades#2024-09-30.acacia) and carefully review the API changes before upgrading.
+  This release changes the pinned API version to `2024-09-30.acacia`. Please read the [API Changelog](https://docs.stripe.com/changelog/acacia#2024-09-30.acacia) and carefully review the API changes before upgrading.
 
   ### ⚠️ Breaking changes
 
@@ -539,7 +544,7 @@ This release changes the pinned API version to `2025-05-28.preview`.
 * [#1418](https://github.com/stripe/stripe-ruby/pull/1418) Add missing static method for verify on BankAccount
 * [#1419](https://github.com/stripe/stripe-ruby/pull/1419)
 
-  This release changes the pinned API version to 2024-06-20. Please read the [API Upgrade Guide](https://stripe.com/docs/upgrades#2024-06-20) and carefully review the API changes before upgrading.
+  This release changes the pinned API version to 2024-06-20. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-06-20) and carefully review the API changes before upgrading.
 
   ### Additions
 
@@ -600,7 +605,7 @@ This release changes the pinned API version to `2025-05-28.preview`.
 ## 11.0.0 - 2024-04-10
 * [#1374](https://github.com/stripe/stripe-ruby/pull/1374)
 
-  * This release changes the pinned API version to `2024-04-10`. Please read the [API Upgrade Guide](https://stripe.com/docs/upgrades#2024-04-10) and carefully review the API changes before upgrading.
+  * This release changes the pinned API version to `2024-04-10`. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-04-10) and carefully review the API changes before upgrading.
 
   ### ⚠️ Breaking changes
 
@@ -829,9 +834,8 @@ Updated stable APIs to the latest version
 - [#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
+* This release changes the pinned API version to `2023-10-16`. Please read the [API Changelog](https://docs.stripe.com/changelog/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
   - Updated pinned API version
 - [#1281](https://github.com/stripe/stripe-ruby/pull/1281) Update generated code
   - Documentation only changes
@@ -1180,7 +1184,7 @@ Updated stable APIs to the latest version
 
 - [#1144](https://github.com/stripe/stripe-ruby/pull/1144) Next major release changes
 
-Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-11-15.
+Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-11-15.
 
 "⚠️" symbol highlights breaking changes.
 
@@ -1235,7 +1239,7 @@ Breaking changes that arose during code generation of the library that we postpo
 
 ## 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.
+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://docs.stripe.com/changelog/2022-08-01.
 
 "⚠️" symbol highlights breaking changes.
 

OPENAPI_VERSION

@@ -1 +1 @@
-v1773
+v1819

README.md

@@ -60,13 +60,14 @@ value:
 
 ```ruby
 require 'stripe'
-Stripe.api_key = 'sk_test_...'
+
+client = Stripe::StripeClient.new("sk_test_...")
 
 # list customers
-Stripe::Customer.list()
+customers = client.v1.customers.list()
 
-# retrieve single customer
-Stripe::Customer.retrieve('cus_123456789')
+# retrieve single customer 
+customer = client.v1.customers.retrieve('cus_123456789')
 ```
 
 ### Per-request Configuration
@@ -78,55 +79,18 @@ per-request key and/or account:
 ```ruby
 require "stripe"
 
-Stripe::Customer.list(
-  {},
-  {
-    api_key: 'sk_test_...',
-    stripe_account: 'acct_...',
-    stripe_version: '2018-02-28',
-  }
-)
+client = Stripe::StripeClient.new("sk_test_...")
 
-Stripe::Customer.retrieve(
-  'cus_123456789',
+client.v1.customers.list(
+  {},
   {
     api_key: 'sk_test_...',
     stripe_account: 'acct_...',
     stripe_version: '2018-02-28',
   }
 )
-
-Stripe::Customer.retrieve(
-  {
-    id: 'cus_123456789',
-    expand: %w(balance_transaction)
-  },
-  {
-    stripe_version: '2018-02-28',
-    api_key: 'sk_test_...',
-  }
-)
-
-Stripe::Customer.capture(
-  'cus_123456789',
-  {},
-  {
-    stripe_version: '2018-02-28',
-    api_key: 'sk_test_...',
-  }
-)
 ```
 
-Keep in mind that there are different method signatures depending on the action:
-
-- When operating on a collection (e.g. `.list`, `.create`) the method signature is
-  `method(params, opts)`.
-- When operating on resource (e.g. `.capture`, `.update`) the method signature is
-  `method(id, params, opts)`.
-- One exception is that `retrieve`, despite being an operation on a resource, has the signature
-  `retrieve(id, opts)`. In addition, it will accept a Hash for the `id` param but will extract the
-  `id` key out and use the others as options.
-
 ### StripeClient vs legacy pattern
 
 We introduced the `StripeClient` class in v13 of the Ruby SDK. The legacy pattern used prior to that version is still available to use but will be marked as deprecated soon. Review the [migration guide to use StripeClient](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v13) to move from the legacy pattern.
@@ -138,15 +102,15 @@ Once the legacy pattern is deprecated, new API endpoints will only be accessible
 Both indexer and accessors can be used to retrieve values of resource properties.
 
 ```ruby
-customer = Stripe::Customer.retrieve('cus_123456789')
+customer = client.v1.customers.retrieve('cus_123456789')
 puts customer['id']
 puts customer.id
 ```
 
 NOTE: If the resource property is not defined, the accessors will raise an exception, while the indexer will return `nil`.
 
 ```ruby
-customer = Stripe::Customer.retrieve('cus_123456789')
+customer = client.v1.customers.retrieve('cus_123456789')
 puts customer['unknown'] # nil
 puts customer.unknown # raises NoMethodError
 ```
@@ -156,7 +120,7 @@ puts customer.unknown # raises NoMethodError
 Get access to response objects by using the `last_response` property of the returned resource:
 
 ```ruby
-customer = Stripe::Customer.retrieve('cus_123456789')
+customer = client.v1.customers.retrieve('cus_123456789')
 
 print(customer.last_response.http_status) # to retrieve status code
 print(customer.last_response.http_headers) # to retrieve headers
@@ -388,8 +352,8 @@ If you:
 you can now use the `raw_request` method on `StripeClient`.
 
 ```ruby
-client = Stripe::StripeClient.new(...)
-resp = client.raw_request(:post, "/v1/beta_endpoint", {param: 123}, {stripe_version: "2022-11-15; feature_beta=v3"})
+client = Stripe::StripeClient.new('sk_test_...')
+resp = client.raw_request(:post, "/v1/beta_endpoint", params: {param: 123}, opts: {stripe_version: "2022-11-15; feature_beta=v3"})
 
 # (Optional) resp is a StripeResponse. You can use `Stripe.deserialize` to get a StripeObject.
 deserialized_resp = client.deserialize(resp.http_body)

lib/stripe/api_requestor.rb

@@ -854,6 +854,8 @@ def self.maybe_gc_connection_managers
         TemporarySessionExpiredError.new(error_data[:message], **opts)
       when "financial_account_not_open"
         FinancialAccountNotOpenError.new(error_data[:message], **opts)
+      when "feature_not_enabled"
+        FeatureNotEnabledError.new(error_data[:message], **opts)
       when "blocked_by_stripe"
         BlockedByStripeError.new(error_data[:message], **opts)
       when "already_canceled"
@@ -866,8 +868,6 @@ def self.maybe_gc_connection_managers
         QuotaExceededError.new(error_data[:message], **opts)
       when "recipient_not_notifiable"
         RecipientNotNotifiableError.new(error_data[:message], **opts)
-      when "feature_not_enabled"
-        FeatureNotEnabledError.new(error_data[:message], **opts)
       when "invalid_payout_method"
         InvalidPayoutMethodError.new(error_data[:message], **opts)
       when "controlled_by_dashboard"

lib/stripe/api_version.rb

@@ -3,6 +3,6 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2025-05-28.preview"
+    CURRENT = "2025-06-30.preview"
   end
 end

lib/stripe/errors.rb

@@ -168,6 +168,9 @@ class TemporarySessionExpiredError < StripeError
   class FinancialAccountNotOpenError < StripeError
   end
 
+  class FeatureNotEnabledError < StripeError
+  end
+
   class BlockedByStripeError < StripeError
   end
 
@@ -186,9 +189,6 @@ class QuotaExceededError < StripeError
   class RecipientNotNotifiableError < StripeError
   end
 
-  class FeatureNotEnabledError < StripeError
-  end
-
   class InvalidPayoutMethodError < StripeError
   end
 

lib/stripe/events/v2_core_event_destination_ping_event.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  # A ping event used to test the connection to an event destination.
+  # A ping event used to test the connection to an EventDestination.
   class V2CoreEventDestinationPingEvent < Stripe::V2::Event
     def self.lookup_type
       "v2.core.event_destination.ping"