stripe 15.5.0 → 15.6.0.pre.alpha.2

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

@@ -0,0 +1,123 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+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.
+      class AccountLink < APIResource
+        OBJECT_NAME = "v2.core.account_link"
+        def self.object_name
+          "v2.core.account_link"
+        end
+
+        class UseCase < Stripe::StripeObject
+          class AccountOnboarding < 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.
+              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
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # Specifies the requirements that Stripe collects from v2/core/accounts in the Onboarding flow.
+            attr_reader :collection_options
+            # Open Enum. A v2/core/account can be configured to enable certain functionality. The configuration param targets the v2/core/account_link to collect information for the specified v2/core/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.
+            attr_reader :refresh_url
+            # The URL that the user will be redirected to upon completing the linked flow.
+            attr_reader :return_url
+
+            def self.inner_class_types
+              @inner_class_types = { collection_options: CollectionOptions }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          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.
+              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
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # Specifies the requirements that Stripe collects from v2/core/accounts in the Onboarding flow.
+            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.
+            attr_reader :refresh_url
+            # The URL that the user will be redirected to upon completing the linked flow.
+            attr_reader :return_url
+
+            def self.inner_class_types
+              @inner_class_types = { collection_options: CollectionOptions }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Open Enum. The type of AccountLink the user is requesting.
+          attr_reader :type
+          # Indicates that the AccountLink provided should onboard an account.
+          attr_reader :account_onboarding
+          # Indicates that the AccountLink provided should update a previously onboarded account.
+          attr_reader :account_update
+
+          def self.inner_class_types
+            @inner_class_types = {
+              account_onboarding: AccountOnboarding,
+              account_update: AccountUpdate,
+            }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The ID of the Account the link was created for.
+        attr_reader :account
+        # The timestamp at which this AccountLink was created.
+        attr_reader :created
+        # The timestamp at which this AccountLink 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.
+        attr_reader :url
+        # The use case of AccountLink the user is requesting.
+        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
+
+        def self.inner_class_types
+          @inner_class_types = { use_case: UseCase }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,81 @@
+# 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 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
+
+        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
+        # Keys that can be used to set up an integration for this sandbox and operate on the account.
+        attr_reader :api_keys
+        # URL for user to claim sandbox into their existing Stripe account.
+        attr_reader :claim_url
+        # When the sandbox is created.
+        attr_reader :created
+        # 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.
+        attr_reader :prefill
+        # 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 = { api_keys: ApiKeys, prefill: Prefill }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,477 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      # Person retrieval response schema.
+      class Person < APIResource
+        OBJECT_NAME = "v2.core.account_person"
+        def self.object_name
+          "v2.core.account_person"
+        end
+
+        class AdditionalAddress < 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
+          # Purpose of additional address.
+          attr_reader :purpose
+          # State, county, province, or region.
+          attr_reader :state
+          # Town or cho-me.
+          attr_reader :town
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class AdditionalName < Stripe::StripeObject
+          # The individual's full name.
+          attr_reader :full_name
+          # The individual's first or given name.
+          attr_reader :given_name
+          # The purpose or type of the additional name.
+          attr_reader :purpose
+          # The individual's last or family name.
+          attr_reader :surname
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class AdditionalTermsOfService < Stripe::StripeObject
+          class Account < Stripe::StripeObject
+            # The time when the Account's representative accepted the terms of service. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
+            attr_reader :date
+            # The IP address from which the Account's representative accepted the terms of service.
+            attr_reader :ip
+            # The user agent of the browser from which the Account's representative accepted the terms of service.
+            attr_reader :user_agent
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Stripe terms of service agreement.
+          attr_reader :account
+
+          def self.inner_class_types
+            @inner_class_types = { account: Account }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Address < 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 cho-me.
+          attr_reader :town
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class DateOfBirth < Stripe::StripeObject
+          # The day of birth, between 1 and 31.
+          attr_reader :day
+          # The month of birth, between 1 and 12.
+          attr_reader :month
+          # The four-digit year of birth.
+          attr_reader :year
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Documents < Stripe::StripeObject
+          class CompanyAuthorization < Stripe::StripeObject
+            # One or more document IDs returned by a [file upload](https://docs.stripe.com/api/persons/update#create_file) with a purpose value of `account_requirement`.
+            attr_reader :files
+            # The format of the document. Currently supports `files` only.
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Passport < Stripe::StripeObject
+            # One or more document IDs returned by a [file upload](https://docs.stripe.com/api/persons/update#create_file) with a purpose value of `account_requirement`.
+            attr_reader :files
+            # The format of the document. Currently supports `files` only.
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class PrimaryVerification < Stripe::StripeObject
+            class FrontBack < Stripe::StripeObject
+              # A [file upload](https://docs.stripe.com/api/persons/update#create_file) token representing the back of the verification document. The purpose of the uploaded file should be 'identity_document'. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
+              attr_reader :back
+              # A [file upload](https://docs.stripe.com/api/persons/update#create_file) token representing the front of the verification document. The purpose of the uploaded file should be 'identity_document'. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
+              attr_reader :front
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # The [file upload](https://docs.stripe.com/api/persons/update#create_file) tokens for the front and back of the verification document.
+            attr_reader :front_back
+            # The format of the verification document. Currently supports `front_back` only.
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = { front_back: FrontBack }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class SecondaryVerification < Stripe::StripeObject
+            class FrontBack < Stripe::StripeObject
+              # A [file upload](https://docs.stripe.com/api/persons/update#create_file) token representing the back of the verification document. The purpose of the uploaded file should be 'identity_document'. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
+              attr_reader :back
+              # A [file upload](https://docs.stripe.com/api/persons/update#create_file) token representing the front of the verification document. The purpose of the uploaded file should be 'identity_document'. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
+              attr_reader :front
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # The [file upload](https://docs.stripe.com/api/persons/update#create_file) tokens for the front and back of the verification document.
+            attr_reader :front_back
+            # The format of the verification document. Currently supports `front_back` only.
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = { front_back: FrontBack }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Visa < Stripe::StripeObject
+            # One or more document IDs returned by a [file upload](https://docs.stripe.com/api/persons/update#create_file) with a purpose value of `account_requirement`.
+            attr_reader :files
+            # The format of the document. Currently supports `files` only.
+            attr_reader :type
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # One or more documents that demonstrate proof that this person is authorized to represent the company.
+          attr_reader :company_authorization
+          # One or more documents showing the person’s passport page with photo and personal data.
+          attr_reader :passport
+          # An identifying document showing the person's name, either a passport or local ID card.
+          attr_reader :primary_verification
+          # A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.
+          attr_reader :secondary_verification
+          # One or more documents showing the person’s visa required for living in the country where they are residing.
+          attr_reader :visa
+
+          def self.inner_class_types
+            @inner_class_types = {
+              company_authorization: CompanyAuthorization,
+              passport: Passport,
+              primary_verification: PrimaryVerification,
+              secondary_verification: SecondaryVerification,
+              visa: Visa,
+            }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class IdNumber < Stripe::StripeObject
+          # The ID number type of an individual.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Relationship < Stripe::StripeObject
+          # Whether the individual is an authorizer of the Account’s legal entity.
+          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.
+          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.
+          attr_reader :legal_guardian
+          # Whether the individual is an owner of the Account’s legal entity.
+          attr_reader :owner
+          # The percent owned by the individual of the Account’s legal entity.
+          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
+          # The individual's title (e.g., CEO, Support Engineer).
+          attr_reader :title
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class ScriptAddresses < Stripe::StripeObject
+          class Kana < 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 cho-me.
+            attr_reader :town
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Kanji < 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 cho-me.
+            attr_reader :town
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Kana Address.
+          attr_reader :kana
+          # Kanji Address.
+          attr_reader :kanji
+
+          def self.inner_class_types
+            @inner_class_types = { kana: Kana, kanji: Kanji }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class ScriptNames < Stripe::StripeObject
+          class Kana < Stripe::StripeObject
+            # The person's first or given name.
+            attr_reader :given_name
+            # The person's last or family name.
+            attr_reader :surname
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class Kanji < Stripe::StripeObject
+            # The person's first or given name.
+            attr_reader :given_name
+            # The person's last or family name.
+            attr_reader :surname
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Persons name in kana script.
+          attr_reader :kana
+          # Persons name in kanji script.
+          attr_reader :kanji
+
+          def self.inner_class_types
+            @inner_class_types = { kana: Kana, kanji: Kanji }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The account ID which the individual belongs to.
+        attr_reader :account
+        # Additional addresses associated with the person.
+        attr_reader :additional_addresses
+        # Additional names (e.g. aliases) associated with the person.
+        attr_reader :additional_names
+        # Attestations of accepted terms of service agreements.
+        attr_reader :additional_terms_of_service
+        # The person's residential address.
+        attr_reader :address
+        # Time at which the object was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
+        attr_reader :created
+        # The person's date of birth.
+        attr_reader :date_of_birth
+        # Documents that may be submitted to satisfy various informational requests.
+        attr_reader :documents
+        # The person's email address.
+        attr_reader :email
+        # The person's first name.
+        attr_reader :given_name
+        # Unique identifier for the Person.
+        attr_reader :id
+        # The identification numbers (e.g., SSN) associated with the person.
+        attr_reader :id_numbers
+        # The person's gender (International regulations require either "male" or "female").
+        attr_reader :legal_gender
+        # Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+        attr_reader :metadata
+        # The countries where the person is a national. Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+        attr_reader :nationalities
+        # String representing the object's type. Objects of the same type share the same value of the object field.
+        attr_reader :object
+        # The person's phone number.
+        attr_reader :phone
+        # The person's political exposure.
+        attr_reader :political_exposure
+        # The relationship that this person has with the Account's business or legal entity.
+        attr_reader :relationship
+        # The script addresses (e.g., non-Latin characters) associated with the person.
+        attr_reader :script_addresses
+        # The script names (e.g. non-Latin characters) associated with the person.
+        attr_reader :script_names
+        # The person's last name.
+        attr_reader :surname
+        # Time at which the object was last updated. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
+        attr_reader :updated
+        # 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 = {
+            additional_addresses: AdditionalAddress,
+            additional_names: AdditionalName,
+            additional_terms_of_service: AdditionalTermsOfService,
+            address: Address,
+            date_of_birth: DateOfBirth,
+            documents: Documents,
+            id_numbers: IdNumber,
+            relationship: Relationship,
+            script_addresses: ScriptAddresses,
+            script_names: ScriptNames,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end