stripe 18.1.0.pre.alpha.2 → 18.1.0.pre.alpha.4

data/lib/stripe/resources/payment_intent.rb

@@ -3459,6 +3459,19 @@ module Stripe
         @field_remappings = {}
       end
     end
+
+    class PaymentsOrchestration < ::Stripe::StripeObject
+      # Whether this feature is enabled.
+      attr_reader :enabled
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
     # Allocated Funds configuration for this PaymentIntent.
     attr_reader :allocated_funds
     # Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
@@ -3573,6 +3586,8 @@ module Stripe
     attr_reader :transfer_data
     # A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers).
     attr_reader :transfer_group
+    # When you enable this parameter, this PaymentIntent will route your payment to processors that you configure in the dashboard.
+    attr_reader :payments_orchestration
 
     # Manually reconcile the remaining amount for a customer_balance PaymentIntent.
     def apply_customer_balance(params = {}, opts = {})
@@ -3947,6 +3962,7 @@ module Stripe
         processing: Processing,
         shipping: Shipping,
         transfer_data: TransferData,
+        payments_orchestration: PaymentsOrchestration,
       }
     end
 

data/lib/stripe/resources/person.rb

@@ -293,7 +293,7 @@ module Stripe
     end
 
     class SelfReportedIncome < ::Stripe::StripeObject
-      # Amount in the minor currency unit (e.g., cents for USD)
+      # The amount in the minor currency unit (for example, cents for USD).
       attr_reader :amount
       # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
       attr_reader :currency
@@ -308,7 +308,7 @@ module Stripe
     end
 
     class SelfReportedMonthlyHousingPayment < ::Stripe::StripeObject
-      # Amount in the minor currency unit (e.g., cents for USD)
+      # The amount in the minor currency unit (for example, cents for USD).
       attr_reader :amount
       # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
       attr_reader :currency

data/lib/stripe/resources/product_catalog/trial_offer.rb

@@ -0,0 +1,101 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module ProductCatalog
+    # Resource for the TrialOffer API, used to describe a subscription item's trial period settings.
+    # Renders a TrialOffer object that describes the price, duration, end_behavior of a trial offer.
+    class TrialOffer < APIResource
+      extend Stripe::APIOperations::Create
+
+      OBJECT_NAME = "product_catalog.trial_offer"
+      def self.object_name
+        "product_catalog.trial_offer"
+      end
+
+      class Duration < ::Stripe::StripeObject
+        class Relative < ::Stripe::StripeObject
+          # The number of iterations of the price's interval for this trial offer.
+          attr_reader :iterations
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field relative
+        attr_reader :relative
+        # The type of trial offer duration.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = { relative: Relative }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class EndBehavior < ::Stripe::StripeObject
+        class Transition < ::Stripe::StripeObject
+          # The new price to use at the end of the trial offer period.
+          attr_reader :price
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field transition
+        attr_reader :transition
+        # The type of behavior when the trial offer ends.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = { transition: Transition }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Attribute for field duration
+      attr_reader :duration
+      # Attribute for field end_behavior
+      attr_reader :end_behavior
+      # Unique identifier for the object.
+      attr_reader :id
+      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      attr_reader :livemode
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The price during the trial offer.
+      attr_reader :price
+
+      # Creates a trial offer.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/product_catalog/trial_offers",
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { duration: Duration, end_behavior: EndBehavior }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/v2/core/event.rb

@@ -13,13 +13,62 @@ module Stripe
 
         class Reason < ::Stripe::StripeObject
           class Request < ::Stripe::StripeObject
+            class Client < ::Stripe::StripeObject
+              class ApiKey < ::Stripe::StripeObject
+                # The ID of the API key.
+                attr_reader :id
+
+                def self.inner_class_types
+                  @inner_class_types = {}
+                end
+
+                def self.field_remappings
+                  @field_remappings = {}
+                end
+              end
+
+              class DashboardUser < ::Stripe::StripeObject
+                # The email of the dashboard user.
+                attr_reader :email
+                # The IP address of the user.
+                attr_reader :ip_address
+                # The machine identifier of the user.
+                attr_reader :machine_identifier
+
+                def self.inner_class_types
+                  @inner_class_types = {}
+                end
+
+                def self.field_remappings
+                  @field_remappings = {}
+                end
+              end
+              # The type of the client.
+              attr_reader :type
+              # API key that triggered the event.
+              attr_reader :api_key
+              # Dashboard user that triggered the event.
+              attr_reader :dashboard_user
+              # Stripe action that triggered the event.
+              attr_reader :stripe_action
+
+              def self.inner_class_types
+                @inner_class_types = { api_key: ApiKey, dashboard_user: DashboardUser }
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # The client details that made the request.
+            attr_reader :client
             # ID of the API request that caused the event.
             attr_reader :id
             # The idempotency key transmitted during the request.
             attr_reader :idempotency_key
 
             def self.inner_class_types
-              @inner_class_types = {}
+              @inner_class_types = { client: Client }
             end
 
             def self.field_remappings

data/lib/stripe/resources/v2/money_management/received_credit.rb

@@ -210,6 +210,19 @@ module Stripe
             @field_remappings = {}
           end
         end
+
+        class StripeBalancePayment < ::Stripe::StripeObject
+          # Statement descriptor for the Stripe Balance Payment.
+          attr_reader :statement_descriptor
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # The amount and currency of the ReceivedCredit.
         attr_reader :amount
         # Time at which the ReceivedCredit was created.
@@ -241,6 +254,8 @@ module Stripe
         attr_reader :balance_transfer
         # This object stores details about the originating banking transaction that resulted in the ReceivedCredit. Present if `type` field value is `bank_transfer`.
         attr_reader :bank_transfer
+        # This object stores details about the stripe balance pay refund that resulted in the ReceivedCredit. Present if `type` field value is `stripe_balance_payment`.
+        attr_reader :stripe_balance_payment
 
         def self.inner_class_types
           @inner_class_types = {
@@ -250,6 +265,7 @@ module Stripe
             status_transitions: StatusTransitions,
             balance_transfer: BalanceTransfer,
             bank_transfer: BankTransfer,
+            stripe_balance_payment: StripeBalancePayment,
           }
         end
 

data/lib/stripe/resources/v2/money_management/received_debit.rb

@@ -87,6 +87,21 @@ module Stripe
           end
         end
 
+        class BalanceTransfer < ::Stripe::StripeObject
+          # Open Enum. The type of balance transfer that originated the ReceivedDebit.
+          attr_reader :type
+          # The ID of the topup object that originated the ReceivedDebit.
+          attr_reader :topup
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
         class BankTransfer < ::Stripe::StripeObject
           class UsBankAccount < ::Stripe::StripeObject
             # The name of the bank the debit originated from.
@@ -123,6 +138,21 @@ module Stripe
             @field_remappings = {}
           end
         end
+
+        class StripeBalancePayment < ::Stripe::StripeObject
+          # ID of the debit agreement associated with this payment.
+          attr_reader :debit_agreement
+          # Statement descriptor for the Stripe Balance Payment.
+          attr_reader :statement_descriptor
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # Amount and currency of the ReceivedDebit.
         attr_reader :amount
         # The time at which the ReceivedDebit was created.
@@ -146,12 +176,16 @@ module Stripe
         attr_reader :status_details
         # The time at which the ReceivedDebit transitioned to a particular status.
         attr_reader :status_transitions
-        # Open Enum. The type of the ReceivedDebit.
+        # Open enum, the type of the received debit.
         attr_reader :type
         # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
         attr_reader :livemode
+        # This object stores details about the balance transfer object that resulted in the ReceivedDebit.
+        attr_reader :balance_transfer
         # This object stores details about the originating banking transaction that resulted in the ReceivedDebit. Present if `type` field value is `bank_transfer`.
         attr_reader :bank_transfer
+        # This object stores details about the Stripe Balance Payment that resulted in the ReceivedDebit.
+        attr_reader :stripe_balance_payment
 
         def self.inner_class_types
           @inner_class_types = {
@@ -159,7 +193,9 @@ module Stripe
             external_amount: ExternalAmount,
             status_details: StatusDetails,
             status_transitions: StatusTransitions,
+            balance_transfer: BalanceTransfer,
             bank_transfer: BankTransfer,
+            stripe_balance_payment: StripeBalancePayment,
           }
         end
 

data/lib/stripe/resources.rb

@@ -112,6 +112,7 @@ require "stripe/resources/price"
 require "stripe/resources/privacy/redaction_job"
 require "stripe/resources/privacy/redaction_job_validation_error"
 require "stripe/resources/product"
+require "stripe/resources/product_catalog/trial_offer"
 require "stripe/resources/product_feature"
 require "stripe/resources/promotion_code"
 require "stripe/resources/quote"
@@ -315,6 +316,12 @@ require "stripe/events/v2_core_health_traffic_volume_drop_firing_event"
 require "stripe/events/v2_core_health_traffic_volume_drop_resolved_event"
 require "stripe/events/v2_core_health_webhook_latency_firing_event"
 require "stripe/events/v2_core_health_webhook_latency_resolved_event"
+require "stripe/events/v2_iam_api_key_created_event"
+require "stripe/events/v2_iam_api_key_default_secret_revealed_event"
+require "stripe/events/v2_iam_api_key_expired_event"
+require "stripe/events/v2_iam_api_key_permissions_updated_event"
+require "stripe/events/v2_iam_api_key_rotated_event"
+require "stripe/events/v2_iam_api_key_updated_event"
 require "stripe/events/v2_money_management_adjustment_created_event"
 require "stripe/events/v2_money_management_financial_account_created_event"
 require "stripe/events/v2_money_management_financial_account_updated_event"

data/lib/stripe/services/product_catalog/trial_offer_service.rb

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module ProductCatalog
+    class TrialOfferService < StripeService
+      # Creates a trial offer.
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/product_catalog/trial_offers",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/product_catalog_service.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class ProductCatalogService < StripeService
+    attr_reader :trial_offers
+
+    def initialize(requestor)
+      super
+      @trial_offers = Stripe::ProductCatalog::TrialOfferService.new(@requestor)
+    end
+  end
+end

data/lib/stripe/services/v1_services.rb

@@ -4,7 +4,7 @@ module Stripe
   class V1Services < StripeService
     # v1 accessors: The beginning of the section generated from our OpenAPI spec
     attr_reader :accounts
-    attr_reader :account_links, :account_notices, :account_sessions, :apple_pay_domains, :application_fees, :apps, :balance, :balance_settings, :balance_transactions, :balance_transfers, :billing, :billing_portal, :capital, :charges, :checkout, :climate, :confirmation_tokens, :country_specs, :coupons, :credit_notes, :customers, :customer_sessions, :delegated_checkout, :disputes, :entitlements, :ephemeral_keys, :events, :exchange_rates, :external_accounts, :files, :file_links, :financial_connections, :forwarding, :fx_quotes, :identity, :invoices, :invoice_items, :invoice_payments, :invoice_rendering_templates, :issuing, :mandates, :margins, :orders, :payment_attempt_records, :payment_intents, :payment_links, :payment_methods, :payment_method_configurations, :payment_method_domains, :payment_records, :payouts, :plans, :prices, :privacy, :products, :promotion_codes, :quotes, :radar, :refunds, :reporting, :reviews, :setup_attempts, :setup_intents, :shipping_rates, :sigma, :sources, :subscriptions, :subscription_items, :subscription_schedules, :tax, :tax_codes, :tax_ids, :tax_rates, :terminal, :test_helpers, :tokens, :topups, :transfers, :treasury, :webhook_endpoints
+    attr_reader :account_links, :account_notices, :account_sessions, :apple_pay_domains, :application_fees, :apps, :balance, :balance_settings, :balance_transactions, :balance_transfers, :billing, :billing_portal, :capital, :charges, :checkout, :climate, :confirmation_tokens, :country_specs, :coupons, :credit_notes, :customers, :customer_sessions, :delegated_checkout, :disputes, :entitlements, :ephemeral_keys, :events, :exchange_rates, :external_accounts, :files, :file_links, :financial_connections, :forwarding, :fx_quotes, :identity, :invoices, :invoice_items, :invoice_payments, :invoice_rendering_templates, :issuing, :mandates, :margins, :orders, :payment_attempt_records, :payment_intents, :payment_links, :payment_methods, :payment_method_configurations, :payment_method_domains, :payment_records, :payouts, :plans, :prices, :privacy, :products, :product_catalog, :promotion_codes, :quotes, :radar, :refunds, :reporting, :reviews, :setup_attempts, :setup_intents, :shipping_rates, :sigma, :sources, :subscriptions, :subscription_items, :subscription_schedules, :tax, :tax_codes, :tax_ids, :tax_rates, :terminal, :test_helpers, :tokens, :topups, :transfers, :treasury, :webhook_endpoints
     # v1 accessors: The end of the section generated from our OpenAPI spec
 
     # OAuthService is manually maintained, as it has special behaviors
@@ -69,6 +69,7 @@ module Stripe
       @prices = Stripe::PriceService.new(@requestor)
       @privacy = Stripe::PrivacyService.new(@requestor)
       @products = Stripe::ProductService.new(@requestor)
+      @product_catalog = Stripe::ProductCatalogService.new(@requestor)
       @promotion_codes = Stripe::PromotionCodeService.new(@requestor)
       @quotes = Stripe::QuoteService.new(@requestor)
       @radar = Stripe::RadarService.new(@requestor)

data/lib/stripe/services.rb

@@ -122,6 +122,8 @@ require "stripe/services/price_service"
 require "stripe/services/privacy/redaction_job_service"
 require "stripe/services/privacy/redaction_job_validation_error_service"
 require "stripe/services/privacy_service"
+require "stripe/services/product_catalog/trial_offer_service"
+require "stripe/services/product_catalog_service"
 require "stripe/services/product_feature_service"
 require "stripe/services/product_service"
 require "stripe/services/promotion_code_service"

data/lib/stripe/stripe_object.rb

@@ -171,7 +171,19 @@ module Stripe
     end
 
     def [](key)
-      @values[key.to_sym]
+      key_sym = key.to_sym
+      return @values[key_sym] if @values.key?(key_sym)
+
+      # super specific one-off case to help users debug this property disappearing
+      # see also: https://go/j/DEVSDK-2835
+      if is_a?(Invoice) && key_sym == :payment_intent
+        raise KeyError,
+              "The 'payment_intent' attribute is no longer available on Invoice objects. " \
+              "See the docs for more details: https://docs.stripe.com/changelog/basil/2025-03-31/" \
+              "add-support-for-multiple-partial-payments-on-invoices#why-is-this-a-breaking-change"
+      end
+
+      nil
     end
 
     def []=(key, value)
@@ -432,6 +444,15 @@ module Stripe
       begin
         super
       rescue NoMethodError => e
+        # super specific one-off case to help users debug this property disappearing
+        # see also: https://go/j/DEVSDK-2835
+        if is_a?(Invoice) && name == :payment_intent
+          raise NoMethodError,
+                "The 'payment_intent' attribute is no longer available on Invoice objects. " \
+                "See the docs for more details: https://docs.stripe.com/changelog/basil/2025-03-31/" \
+                "add-support-for-multiple-partial-payments-on-invoices#why-is-this-a-breaking-change"
+        end
+
         # If we notice the accessed name of our set of transient values we can
         # give the user a slightly more helpful error message. If not, just
         # raise right away.

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "18.1.0-alpha.2"
+  VERSION = "18.1.0-alpha.4"
 end