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

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

@@ -4,7 +4,7 @@
 module Stripe
   module V2
     module Core
-      # AccountLinks are the means by which a Merchant grants an Account permission to access Stripe-hosted applications, such as Recipient Onboarding. This API is only available for users enrolled in the public preview for Accounts v2.
+      # Account Links let a platform create a temporary, single-use URL that an account can use to access a Stripe-hosted flow for collecting or updating required information.
       class AccountLink < APIResource
         OBJECT_NAME = "v2.core.account_link"
         def self.object_name
@@ -47,7 +47,7 @@ module Stripe
 
           class AccountUpdate < ::Stripe::StripeObject
             class CollectionOptions < ::Stripe::StripeObject
-              # Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). If you don’t specify collection_options, the default value is currently_due.
+              # Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). The default value is `currently_due`.
               attr_reader :fields
               # Specifies whether the platform collects future_requirements in addition to requirements in Connect Onboarding. The default value is `omit`.
               attr_reader :future_requirements
@@ -64,7 +64,7 @@ module Stripe
             attr_reader :collection_options
             # Open Enum. A v2/account can be configured to enable certain functionality. The configuration param targets the v2/account_link to collect information for the specified v2/account configuration/s.
             attr_reader :configurations
-            # The URL the user will be redirected to if the AccountLink is expired, has been used, or is otherwise invalid. The URL you specify should attempt to generate a new AccountLink with the same parameters used to create the original AccountLink, then redirect the user to the new AccountLink’s URL so they can continue the flow. If a new AccountLink cannot be generated or the redirect fails you should display a useful error to the user. Please make sure to implement authentication before redirecting the user in case this URL is leaked to a third party.
+            # The URL the user will be redirected to if the Account Link is expired, has been used, or is otherwise invalid. The URL you specify should attempt to generate a new Account Link with the same parameters used to create the original Account Link, then redirect the user to the new Account Link URL so they can continue the flow. Make sure to authenticate the user before redirecting to the new Account Link, in case the URL leaks to a third party. If a new Account Link can't be generated, or if the redirect fails, you should display a useful error to the user.
             attr_reader :refresh_url
             # The URL that the user will be redirected to upon completing the linked flow.
             attr_reader :return_url
@@ -77,11 +77,11 @@ module Stripe
               @field_remappings = {}
             end
           end
-          # Open Enum. The type of AccountLink the user is requesting.
+          # Open Enum. The type of Account Link the user is requesting.
           attr_reader :type
-          # Indicates that the AccountLink provided should onboard an account.
+          # Hash containing configuration options for an Account Link object that onboards a new account.
           attr_reader :account_onboarding
-          # Indicates that the AccountLink provided should update a previously onboarded account.
+          # Hash containing configuration options for an Account Link that updates an existing account.
           attr_reader :account_update
 
           def self.inner_class_types
@@ -95,17 +95,17 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The ID of the Account the link was created for.
+        # The ID of the connected account this Account Link applies to.
         attr_reader :account
-        # The timestamp at which this AccountLink was created.
+        # The timestamp at which this Account Link was created.
         attr_reader :created
-        # The timestamp at which this AccountLink will expire.
+        # The timestamp at which this Account Link will expire.
         attr_reader :expires_at
         # String representing the object's type. Objects of the same type share the same value of the object field.
         attr_reader :object
-        # The URL for the AccountLink.
+        # The URL at which the account can access the Stripe-hosted flow.
         attr_reader :url
-        # The use case of AccountLink the user is requesting.
+        # Hash containing usage options.
         attr_reader :use_case
         # 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

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

@@ -4,7 +4,7 @@
 module Stripe
   module V2
     module Core
-      # Person retrieval response schema.
+      # A Person represents an individual associated with an Account's identity (for example, an owner, director, executive, or representative). Use Persons to provide and update identity information for verification and compliance.
       class AccountPerson < APIResource
         OBJECT_NAME = "v2.core.account_person"
         def self.object_name
@@ -26,7 +26,7 @@ module Stripe
           attr_reader :purpose
           # State, county, province, or region.
           attr_reader :state
-          # Town or cho-me.
+          # Town or district.
           attr_reader :town
 
           def self.inner_class_types
@@ -99,7 +99,7 @@ module Stripe
           attr_reader :postal_code
           # State, county, province, or region.
           attr_reader :state
-          # Town or cho-me.
+          # Town or district.
           attr_reader :town
 
           def self.inner_class_types
@@ -271,17 +271,17 @@ module Stripe
         end
 
         class Relationship < ::Stripe::StripeObject
-          # Whether the individual is an authorizer of the Account’s legal entity.
+          # Whether the individual is an authorizer of the Account's identity.
           attr_reader :authorizer
-          # Whether the individual is a director of the Account’s legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
+          # Whether the individual is a director of the Account's identity. Directors are typically members of the governing board of the company or are responsible for making sure that the company meets its regulatory obligations.
           attr_reader :director
           # Whether the individual has significant responsibility to control, manage, or direct the organization.
           attr_reader :executive
-          # Whether the individual is the legal guardian of the Account’s representative.
+          # Whether the individual is the legal guardian of the Account's representative.
           attr_reader :legal_guardian
-          # Whether the individual is an owner of the Account’s legal entity.
+          # Whether the individual is an owner of the Account's identity.
           attr_reader :owner
-          # The percent owned by the individual of the Account’s legal entity.
+          # The percentage of the Account's identity that the individual owns.
           attr_reader :percent_ownership
           # Whether the individual is authorized as the primary representative of the Account. This is the person nominated by the business to provide information about themselves, and general information about the account. There can only be one representative at any given time. At the time the account is created, this person should be set to the person responsible for opening the account.
           attr_reader :representative
@@ -311,7 +311,7 @@ module Stripe
             attr_reader :postal_code
             # State, county, province, or region.
             attr_reader :state
-            # Town or cho-me.
+            # Town or district.
             attr_reader :town
 
             def self.inner_class_types
@@ -336,7 +336,7 @@ module Stripe
             attr_reader :postal_code
             # State, county, province, or region.
             attr_reader :state
-            # Town or cho-me.
+            # Town or district.
             attr_reader :town
 
             def self.inner_class_types

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).
@@ -54,6 +71,8 @@ module Stripe
           attr_reader :created
           # The fedwire routing number of the bank account.
           attr_reader :fedwire_routing_number
+          # The ID of the Financial Connections Account used to create the bank account.
+          attr_reader :financial_connections_account
           # The ID of the USBankAccount object.
           attr_reader :id
           # The last 4 digits of the account number.
@@ -68,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/financial_address_generated_microdeposits.rb

@@ -9,6 +9,20 @@ module Stripe
         "financial_address_generated_microdeposits"
       end
 
+      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
       # The amounts of the microdeposits that were generated.
       attr_reader :amounts
       # String representing the object's type. Objects of the same type share the same value of the object field.
@@ -19,7 +33,7 @@ module Stripe
       attr_reader :livemode
 
       def self.inner_class_types
-        @inner_class_types = {}
+        @inner_class_types = { amounts: Amount }
       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/adjustment.rb

@@ -35,6 +35,21 @@ module Stripe
             @field_remappings = {}
           end
         end
+
+        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
         # If applicable, contains information about the original flow linked to this Adjustment.
         attr_reader :adjusted_flow
         # The amount of the Adjustment.
@@ -55,7 +70,7 @@ module Stripe
         attr_reader :livemode
 
         def self.inner_class_types
-          @inner_class_types = { adjusted_flow: AdjustedFlow }
+          @inner_class_types = { adjusted_flow: AdjustedFlow, amount: Amount }
         end
 
         def self.field_remappings