stripe 19.3.0 → 19.4.0.pre.alpha.2

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

@@ -0,0 +1,146 @@
+# 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 OnboardingLinkDetails < ::Stripe::StripeObject
+          # The timestamp the onboarding link expires.
+          attr_reader :expires_at
+          # The URL the user will be redirected to if the onboarding link is expired or invalid.
+          # The URL specified should attempt to generate a new onboarding link,
+          # and re-direct the user to this new onboarding link so that they can proceed with the onboarding flow.
+          attr_reader :refresh_url
+          # URL that will redirect the user to either claim or onboard the claimable sandbox depending on its status.
+          attr_reader :url
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class OwnerDetails < ::Stripe::StripeObject
+          # The ID of the livemode Stripe account that owns the sandbox.
+          # This field is only set when owner_details.app_install_status is `installed`.
+          attr_reader :account
+          # Indicates whether the platform app is installed on the sandbox’s livemode owner account.
+          attr_reader :app_install_status
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        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
+
+          def self.inner_class_types
+            @inner_class_types = { api_keys: ApiKeys }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The app channel that will be used when pre-installing your app on the claimable sandbox.
+        attr_reader :app_channel
+        # 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
+        # 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 of the object field.
+        attr_reader :object
+        # Details about the onboarding link.
+        attr_reader :onboarding_link_details
+        # Details about the livemode owner account of the sandbox.
+        # This will be null until the sandbox is claimed.
+        attr_reader :owner_details
+        # 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.
+        attr_reader :status
+
+        def self.inner_class_types
+          @inner_class_types = {
+            onboarding_link_details: OnboardingLinkDetails,
+            owner_details: OwnerDetails,
+            prefill: Prefill,
+            sandbox_details: SandboxDetails,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,58 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      # A short-lived, single-use session used to launch client-side Link onboarding
+      # that connects an Account to a Link consumer account.
+      class ConnectionSession < APIResource
+        OBJECT_NAME = "v2.core.connection_session"
+        def self.object_name
+          "v2.core.connection_session"
+        end
+
+        class Connection < ::Stripe::StripeObject
+          # The access granted to the Account by the Connection.
+          attr_reader :granted_access
+          # The type of the Connection.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The Account this Connection Session was created for.
+        attr_reader :account
+        # The Connection types that the Connection Session is allowed to establish.
+        attr_reader :allowed_connection_types
+        # The client secret of this Connection Session. Used on the client to set up secure access to the given Account.
+        attr_reader :client_secret
+        # The Connection created by the ConnectionSession.
+        attr_reader :connection
+        # Time at which the ConnectionSession was created.
+        attr_reader :created
+        # The unique identifier for this ConnectionSession.
+        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 of the object field.
+        attr_reader :object
+        # The access that is collected with the Connection Session.
+        attr_reader :requested_access
+
+        def self.inner_class_types
+          @inner_class_types = { connection: Connection }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

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

@@ -14,13 +14,76 @@ 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
+
+              class StripeAction < ::Stripe::StripeObject
+                def self.inner_class_types
+                  @inner_class_types = {}
+                end
+
+                def self.field_remappings
+                  @field_remappings = {}
+                end
+              end
+              # 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
+              # The type of the client.
+              attr_reader :type
+
+              def self.inner_class_types
+                @inner_class_types = {
+                  api_key: ApiKey,
+                  dashboard_user: DashboardUser,
+                  stripe_action: StripeAction,
+                }
+              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
@@ -54,6 +117,8 @@ module Stripe
         attr_reader :object
         # Reason for the event.
         attr_reader :reason
+        # For interop events, this is the snapshot event ID.
+        attr_reader :snapshot_event
         # The type of the event.
         attr_reader :type
 

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

@@ -1,3 +1,4 @@
+# File copied from our code generator; changes here will be overwritten.
 # frozen_string_literal: true
 
 module Stripe

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

@@ -0,0 +1,225 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      # A FeeBatch represents a settlement grouping of fees.
+      # It bridges the fee domain with actual money movement, tracking what was settled and how.
+      class FeeBatch < APIResource
+        OBJECT_NAME = "v2.core.fee_batch"
+        def self.object_name
+          "v2.core.fee_batch"
+        end
+
+        class Adjustments < ::Stripe::StripeObject
+          class TaxAdjustment < ::Stripe::StripeObject
+            # A lowercase alpha3 currency code like "usd"
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :currency
+            # In major units like "1.23" for 1.23 USD
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :value
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The amount of tax adjusted for this batch.
+          attr_reader :tax_adjustment
+
+          def self.inner_class_types
+            @inner_class_types = { tax_adjustment: TaxAdjustment }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Amount < ::Stripe::StripeObject
+          # A lowercase alpha3 currency code like "usd"
+          # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+          attr_reader :currency
+          # In major units like "1.23" for 1.23 USD
+          # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+          attr_reader :value
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class CollectedBy < ::Stripe::StripeObject
+          # The type of entity that collected this batch.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class CollectionRecord < ::Stripe::StripeObject
+          class Amount < ::Stripe::StripeObject
+            # A lowercase alpha3 currency code like "usd"
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :currency
+            # In major units like "1.23" for 1.23 USD
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :value
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Tax < ::Stripe::StripeObject
+            class Amount < ::Stripe::StripeObject
+              # A lowercase alpha3 currency code like "usd"
+              # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+              attr_reader :currency
+              # In major units like "1.23" for 1.23 USD
+              # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+              attr_reader :value
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # The tax amount collected via this record.
+            attr_reader :amount
+
+            def self.inner_class_types
+              @inner_class_types = { amount: Amount }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The fee amount collected via this record.
+          attr_reader :amount
+          # The ID of the associated v1 balance transaction.
+          attr_reader :balance_transaction
+          # The ID of the associated credit transaction.
+          attr_reader :credit_transaction
+          # The ID of the associated v2 money management transaction.
+          attr_reader :money_management_transaction
+          # The ID of the associated accounts-receivable invoice.
+          attr_reader :payable_invoice
+          # The tax amount collected via this record.
+          attr_reader :tax
+          # The type of money movement object.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = { amount: Amount, tax: Tax }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class StatusTransitions < ::Stripe::StripeObject
+          # Timestamp of when the batch transitioned to BILLED, if applicable.
+          attr_reader :billed_at
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Tax < ::Stripe::StripeObject
+          class Amount < ::Stripe::StripeObject
+            # A lowercase alpha3 currency code like "usd"
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :currency
+            # In major units like "1.23" for 1.23 USD
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :value
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The tax amount included in this batch.
+          attr_reader :amount
+
+          def self.inner_class_types
+            @inner_class_types = { amount: Amount }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Adjustments applied to this batch.
+        attr_reader :adjustments
+        # The total fee amount billed in this batch.
+        attr_reader :amount
+        # The entity that collected this batch.
+        attr_reader :collected_by
+        # The money movement records associated with collecting this batch.
+        attr_reader :collection_records
+        # Timestamp of when this batch was created.
+        attr_reader :created
+        # Unique identifier for the FeeBatch.
+        attr_reader :id
+        # Has the value `true` if the object exists in live mode, or `false` if in test mode.
+        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 current state of this batch.
+        attr_reader :status
+        # Timestamps for each status transition.
+        attr_reader :status_transitions
+        # The tax amount included in this batch.
+        attr_reader :tax
+
+        def self.inner_class_types
+          @inner_class_types = {
+            adjustments: Adjustments,
+            amount: Amount,
+            collected_by: CollectedBy,
+            collection_records: CollectionRecord,
+            status_transitions: StatusTransitions,
+            tax: Tax,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,173 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      # A FeeEntry is the atomic, append-only record of an assessed fee.
+      class FeeEntry < APIResource
+        OBJECT_NAME = "v2.core.fee_entry"
+        def self.object_name
+          "v2.core.fee_entry"
+        end
+
+        class Amount < ::Stripe::StripeObject
+          # A lowercase alpha3 currency code like "usd"
+          # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+          attr_reader :currency
+          # In major units like "1.23" for 1.23 USD
+          # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+          attr_reader :value
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class ChargedBy < ::Stripe::StripeObject
+          class Application < ::Stripe::StripeObject
+            # Human-readable product name, e.g. "Card payments - Stripe fee".
+            attr_reader :feature_name
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Network < ::Stripe::StripeObject
+            # Human-readable product name, e.g. "Card payments - Stripe fee".
+            attr_reader :feature_name
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Stripe < ::Stripe::StripeObject
+            # Human-readable product name, e.g. "Card payments - Stripe fee".
+            attr_reader :feature_name
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Details for a fee charged by a Connect application.
+          attr_reader :application
+          # Details for a fee charged by the payment network.
+          attr_reader :network
+          # Details for a fee charged by Stripe.
+          attr_reader :stripe
+          # The type of entity that charged this fee.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = { application: Application, network: Network, stripe: Stripe }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class IncurredBy < ::Stripe::StripeObject
+          # The account that incurred the usage (may differ from the billing account).
+          attr_reader :account
+          # Public API object id, e.g. ch_xxx.
+          attr_reader :id
+          # Timestamp of when the usage event occurred.
+          attr_reader :occurred_at
+          # Public API object type: "charge", "payment", "refund", "dispute", "payout", etc.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Tax < ::Stripe::StripeObject
+          class Amount < ::Stripe::StripeObject
+            # A lowercase alpha3 currency code like "usd"
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :currency
+            # In major units like "1.23" for 1.23 USD
+            # For the taxonomy label choice, see SECURE_FRAMEWORKS-2849.
+            attr_reader :value
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The tax amount calculated for this fee.
+          attr_reader :amount
+
+          def self.inner_class_types
+            @inner_class_types = { amount: Amount }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The fee amount.
+        attr_reader :amount
+        # The entity that assessed this fee.
+        attr_reader :charged_by
+        # Timestamp of when this fee entry was created.
+        attr_reader :created
+        # The ID of the FeeBatch that collected this fee, if any.
+        attr_reader :fee_batch
+        # Unique identifier for the FeeEntry.
+        attr_reader :id
+        # The usage event that caused this fee to be assessed.
+        attr_reader :incurred_by
+        # Has the value `true` if the object exists in live mode, or `false` if in test mode.
+        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 reason this fee entry was created.
+        attr_reader :reason
+        # The tax portion of the fee, if applicable.
+        attr_reader :tax
+        # The category of this fee.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = {
+            amount: Amount,
+            charged_by: ChargedBy,
+            incurred_by: IncurredBy,
+            tax: Tax,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end