stripe 18.2.0.pre.beta.1 → 18.3.0.pre.alpha.1

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

@@ -0,0 +1,105 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      # A claimable sandbox represents a Stripe sandbox that is anonymous.
+      # When it is created, it can be prefilled with specific metadata, such as email, name, or country.
+      # Claimable sandboxes can be claimed through a URL. When a user claims a sandbox through this URL,
+      # it will prompt them to create a new Stripe account. Or, it will allow them to claim this sandbox in their
+      # existing Stripe account.
+      # Claimable sandboxes have 60 days to be claimed. After this expiration time has passed,
+      # if the sandbox is not claimed, it will be deleted.
+      class ClaimableSandbox < APIResource
+        OBJECT_NAME = "v2.core.claimable_sandbox"
+        def self.object_name
+          "v2.core.claimable_sandbox"
+        end
+
+        class Prefill < ::Stripe::StripeObject
+          # Country in which the account holder resides, or in which the business is legally established.
+          # Use two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+          attr_reader :country
+          # Email that this sandbox is meant to be claimed by. Stripe will
+          # send an email to this email address before the sandbox expires.
+          attr_reader :email
+          # Name for the sandbox.
+          attr_reader :name
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class SandboxDetails < ::Stripe::StripeObject
+          class ApiKeys < ::Stripe::StripeObject
+            # Used to communicate with [Stripe's MCP server](https://docs.stripe.com/mcp).
+            # This allows LLM agents to securely operate on a Stripe account.
+            attr_reader :mcp
+            # Publicly accessible in a web or mobile app client-side code.
+            attr_reader :publishable
+            # Should be stored securely in server-side code (such as an environment variable).
+            attr_reader :secret
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The sandbox's Stripe account ID.
+          attr_reader :account
+          # Keys that can be used to set up an integration for this sandbox and operate on the account. This will be present only in the create response, and will be null in subsequent retrieve responses.
+          attr_reader :api_keys
+          # The livemode sandbox Stripe account ID. This field is only set if the user activates their sandbox
+          # and chooses to install your platform's Stripe App in their live account.
+          attr_reader :owner_account
+
+          def self.inner_class_types
+            @inner_class_types = { api_keys: ApiKeys }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # URL for user to claim sandbox into their existing Stripe account.
+        # The value will be null if the sandbox status is `claimed` or `expired`.
+        attr_reader :claim_url
+        # The timestamp the sandbox was claimed. The value will be null if the sandbox status is not `claimed`.
+        attr_reader :claimed_at
+        # When the sandbox is created.
+        attr_reader :created
+        # The timestamp the sandbox will expire. The value will be null if the sandbox is `claimed`.
+        attr_reader :expires_at
+        # Unique identifier for the Claimable sandbox.
+        attr_reader :id
+        # String representing the object's type. Objects of the same type share the same value of the object field.
+        attr_reader :object
+        # Values prefilled during the creation of the sandbox. When a user claims the sandbox, they will be able to update these values.
+        attr_reader :prefill
+        # Data about the Stripe sandbox object.
+        attr_reader :sandbox_details
+        # Status of the sandbox. One of `unclaimed`, `expired`, `claimed`.
+        attr_reader :status
+        # 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
+
+        def self.inner_class_types
+          @inner_class_types = { prefill: Prefill, sandbox_details: SandboxDetails }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      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/core/vault/gb_bank_account.rb

@@ -12,6 +12,21 @@ module Stripe
             "v2.core.vault.gb_bank_account"
           end
 
+          class AlternativeReference < ::Stripe::StripeObject
+            # The ID of the alternative resource being referenced.
+            attr_reader :id
+            # The type of the alternative reference (e.g., external_account for V1 external accounts).
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
           class ConfirmationOfPayee < ::Stripe::StripeObject
             class Result < ::Stripe::StripeObject
               class Matched < ::Stripe::StripeObject
@@ -76,6 +91,8 @@ module Stripe
               @field_remappings = {}
             end
           end
+          # The alternative reference for this payout method, if it's a projected payout method.
+          attr_reader :alternative_reference
           # Whether this bank account object was archived. Bank account objects can be archived through
           # the /archive API, and they will not be automatically archived by Stripe. Archived bank account objects
           # cannot be used as outbound destinations and will not appear in the outbound destination list.
@@ -101,7 +118,10 @@ module Stripe
           attr_reader :livemode
 
           def self.inner_class_types
-            @inner_class_types = { confirmation_of_payee: ConfirmationOfPayee }
+            @inner_class_types = {
+              alternative_reference: AlternativeReference,
+              confirmation_of_payee: ConfirmationOfPayee,
+            }
           end
 
           def self.field_remappings

data/lib/stripe/resources/v2/core/vault/us_bank_account.rb

@@ -12,6 +12,21 @@ module Stripe
             "v2.core.vault.us_bank_account"
           end
 
+          class AlternativeReference < ::Stripe::StripeObject
+            # The ID of the alternative resource being referenced.
+            attr_reader :id
+            # The type of the alternative reference (e.g., external_account for V1 external accounts).
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
           class Verification < ::Stripe::StripeObject
             class MicrodepositVerificationDetails < ::Stripe::StripeObject
               # Time when microdeposits will expire and have to be re-sent.
@@ -44,6 +59,8 @@ module Stripe
               @field_remappings = {}
             end
           end
+          # The alternative reference for this payout method, if it's a projected payout method.
+          attr_reader :alternative_reference
           # Whether this USBankAccount object was archived.
           attr_reader :archived
           # Closed Enum. The type of bank account (checking or savings).
@@ -70,7 +87,10 @@ module Stripe
           attr_reader :livemode
 
           def self.inner_class_types
-            @inner_class_types = { verification: Verification }
+            @inner_class_types = {
+              alternative_reference: AlternativeReference,
+              verification: Verification,
+            }
           end
 
           def self.field_remappings

data/lib/stripe/resources/v2/iam/api_key.rb

@@ -0,0 +1,129 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Iam
+      # An API key.
+      class ApiKey < APIResource
+        OBJECT_NAME = "v2.iam.api_key"
+        def self.object_name
+          "v2.iam.api_key"
+        end
+
+        class ManagedBy < ::Stripe::StripeObject
+          class Application < ::Stripe::StripeObject
+            # Identifier of the application.
+            attr_reader :id
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The type of entity.
+          attr_reader :type
+          # An application.
+          attr_reader :application
+
+          def self.inner_class_types
+            @inner_class_types = { application: Application }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class PublishableKey < ::Stripe::StripeObject
+          # The plaintext token for the API key.
+          attr_reader :token
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class SecretKey < ::Stripe::StripeObject
+          class EncryptedSecret < ::Stripe::StripeObject
+            # The encrypted secret data in base64 format.
+            attr_reader :ciphertext
+            # The format of the encrypted secret (e.g., jwe_compact).
+            attr_reader :format
+            # The caller's identifier of the public key provided.
+            attr_reader :recipient_key_id
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The encrypted secret for the API key. Only included when a key is first created.
+          attr_reader :encrypted_secret
+          # Redacted version of the secret token for display purposes.
+          attr_reader :secret_token_redacted
+          # The plaintext token for the API key. Only included for testmode keys.
+          attr_reader :token
+
+          def self.inner_class_types
+            @inner_class_types = { encrypted_secret: EncryptedSecret }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Timestamp when the API key was created.
+        attr_reader :created
+        # Timestamp when the API key expires.
+        attr_reader :expires_at
+        # Unique identifier of the API key.
+        attr_reader :id
+        # List of IP addresses allowed to use this API key. Addresses use IPv4 protocol, and may be a CIDR range (e.g., [100.10.38.255, 100.10.38.0/24]).
+        attr_reader :ip_allowlist
+        # Timestamp when the API key was last used.
+        attr_reader :last_used
+        # Account that manages this API key (for keys managed by platforms).
+        attr_reader :managed_by
+        # Name of the API key.
+        attr_reader :name
+        # Note or description for the API key.
+        attr_reader :note
+        # String representing the object's type. Objects of the same type share the same value of the object field.
+        attr_reader :object
+        # Current status of the API key (e.g., active, expired).
+        attr_reader :status
+        # Type of the API key.
+        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
+        # Token set for a publishable key.
+        attr_reader :publishable_key
+        # Token set for a secret key.
+        attr_reader :secret_key
+
+        def self.inner_class_types
+          @inner_class_types = {
+            managed_by: ManagedBy,
+            publishable_key: PublishableKey,
+            secret_key: SecretKey,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,94 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      # The CurrencyConversion object. Contains details such as the amount debited and credited and the FinancialAccount the CurrencyConversion was performed on.
+      class CurrencyConversion < APIResource
+        OBJECT_NAME = "v2.money_management.currency_conversion"
+        def self.object_name
+          "v2.money_management.currency_conversion"
+        end
+
+        class From < ::Stripe::StripeObject
+          class Amount < ::Stripe::StripeObject
+            # A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
+            attr_reader :value
+            # 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
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Amount object.
+          attr_reader :amount
+
+          def self.inner_class_types
+            @inner_class_types = { amount: Amount }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class To < ::Stripe::StripeObject
+          class Amount < ::Stripe::StripeObject
+            # A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
+            attr_reader :value
+            # 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
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Amount object.
+          attr_reader :amount
+
+          def self.inner_class_types
+            @inner_class_types = { amount: Amount }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The time the CurrencyConversion was created at.
+        attr_reader :created
+        # The exchange rate used when processing the CurrencyConversion.
+        attr_reader :exchange_rate
+        # The FinancialAccount the CurrencyConversion was performed on.
+        attr_reader :financial_account
+        # The from block containing what was debited.
+        attr_reader :from
+        # The id of the CurrencyConversion.
+        attr_reader :id
+        # If the CurrencyConversion was performed in livemode or not.
+        attr_reader :livemode
+        # String representing the object's type. Objects of the same type share the same value of the object field.
+        attr_reader :object
+        # The to block containing what was credited.
+        attr_reader :to
+
+        def self.inner_class_types
+          @inner_class_types = { from: From, to: To }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

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

@@ -76,6 +76,19 @@ module Stripe
           end
         end
 
+        class ManagedBy < ::Stripe::StripeObject
+          # Enum describing the Stripe product that is managing this FinancialAccount.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
         class Other < ::Stripe::StripeObject
           # The type of the FinancialAccount, represented as a string. Upgrade your API version to see the type reflected in `financial_account.type`.
           attr_reader :type
@@ -89,6 +102,21 @@ module Stripe
           end
         end
 
+        class Payments < ::Stripe::StripeObject
+          # The currency that non-settlement currency payments will be converted to.
+          attr_reader :default_currency
+          # Settlement currencies enabled for this FinancialAccount. Payments in other currencies will be automatically converted to `default_currency`.
+          attr_reader :settlement_currencies
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
         class StatusDetails < ::Stripe::StripeObject
           class Closed < ::Stripe::StripeObject
             class ForwardingSettings < ::Stripe::StripeObject
@@ -152,12 +180,17 @@ module Stripe
         attr_reader :display_name
         # Unique identifier for the object.
         attr_reader :id
+        # If this is a managed FinancialAccount, `managed_by` indicates the product that created and manages this FinancialAccount. For managed FinancialAccounts,
+        # creation of money management resources can only be orchestrated by the managing product.
+        attr_reader :managed_by
         # Metadata associated with the FinancialAccount.
         attr_reader :metadata
         # String representing the object's type. Objects of the same type share the same value of the object field.
         attr_reader :object
         # If this is a `other` FinancialAccount, this hash indicates what the actual type is. Upgrade your API version to see it reflected in `type`.
         attr_reader :other
+        # If this is a `payments` FinancialAccount, this hash include details specific to `payments` FinancialAccount.
+        attr_reader :payments
         # Closed Enum. An enum representing the status of the FinancialAccount. This indicates whether or not the FinancialAccount can be used for any money movement flows.
         attr_reader :status
         # Attribute for field status_details
@@ -173,7 +206,9 @@ module Stripe
         def self.inner_class_types
           @inner_class_types = {
             balance: Balance,
+            managed_by: ManagedBy,
             other: Other,
+            payments: Payments,
             status_details: StatusDetails,
             storage: Storage,
           }

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

@@ -27,11 +27,31 @@ module Stripe
         end
 
         class DeliveryOptions < ::Stripe::StripeObject
+          class PaperCheck < ::Stripe::StripeObject
+            # Memo printed on the memo field of the check.
+            attr_reader :memo
+            # Open Enum. Shipping speed of the paper check.
+            attr_reader :shipping_speed
+            # Signature for the paper check.
+            attr_reader :signature
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Open Enum. Speed of the payout.
+          attr_reader :speed
           # Open Enum. Method for bank account.
           attr_reader :bank_account
+          # Delivery options for paper check.
+          attr_reader :paper_check
 
           def self.inner_class_types
-            @inner_class_types = {}
+            @inner_class_types = { paper_check: PaperCheck }
           end
 
           def self.field_remappings
@@ -193,6 +213,67 @@ module Stripe
             @field_remappings = {}
           end
         end
+
+        class TrackingDetails < ::Stripe::StripeObject
+          class PaperCheck < ::Stripe::StripeObject
+            class MailingAddress < ::Stripe::StripeObject
+              # City, district, suburb, town, or village.
+              attr_reader :city
+              # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+              attr_reader :country
+              # Address line 1 (e.g., street, PO Box, or company name).
+              attr_reader :line1
+              # Address line 2 (e.g., apartment, suite, unit, or building).
+              attr_reader :line2
+              # ZIP or postal code.
+              attr_reader :postal_code
+              # State, county, province, or region.
+              attr_reader :state
+              # Town or district.
+              attr_reader :town
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # Open Enum. Carrier of the paper check.
+            attr_reader :carrier
+            # Check number.
+            attr_reader :check_number
+            # Postal code of the latest tracking update.
+            attr_reader :current_postal_code
+            # Mailing address of the paper check.
+            attr_reader :mailing_address
+            # Tracking number for the check.
+            attr_reader :tracking_number
+            # Open Enum. Tracking status of the paper check.
+            attr_reader :tracking_status
+            # When the tracking details were last updated.
+            attr_reader :updated_at
+
+            def self.inner_class_types
+              @inner_class_types = { mailing_address: MailingAddress }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Paper check tracking details.
+          attr_reader :paper_check
+
+          def self.inner_class_types
+            @inner_class_types = { paper_check: PaperCheck }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # The "presentment amount" for the OutboundPayment.
         attr_reader :amount
         # Returns true if the OutboundPayment can be canceled, and false otherwise.
@@ -221,6 +302,8 @@ module Stripe
         attr_reader :receipt_url
         # Details about the OutboundPayment notification settings for recipient.
         attr_reader :recipient_notification
+        # The recipient verification id for this OutboundPayment. Only required for countries with regulatory mandates to verify recipient names before OutboundPayment creation.
+        attr_reader :recipient_verification
         # The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer). It will default to `STRIPE` if not set on the account settings.
         attr_reader :statement_descriptor
         # Closed Enum. Current status of the OutboundPayment: `processing`, `failed`, `posted`, `returned`, `canceled`.
@@ -236,6 +319,8 @@ module Stripe
         attr_reader :to
         # A unique identifier that can be used to track this OutboundPayment with recipient bank. Banks might call this a “reference number” or something similar.
         attr_reader :trace_id
+        # Information to track this OutboundPayment with the recipient bank.
+        attr_reader :tracking_details
         # 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
 
@@ -249,6 +334,7 @@ module Stripe
             status_transitions: StatusTransitions,
             to: To,
             trace_id: TraceId,
+            tracking_details: TrackingDetails,
           }
         end
 

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

@@ -27,6 +27,8 @@ module Stripe
         end
 
         class DeliveryOptions < ::Stripe::StripeObject
+          # Open Enum. Speed of the payout.
+          attr_reader :speed
           # Open Enum. Method for bank account.
           attr_reader :bank_account