checkout_sdk 2.5.0 → 2.6.0

data/lib/checkout_sdk/accounts/representative.rb

@@ -2,32 +2,93 @@
 
 module CheckoutSdk
   module Accounts
+    # A representative of the sub-entity. One class covers every shape the Accounts API defines: the v3.0
+    # person of interest (individual, roles, company_position, ownership_percentage, documents), the v3.0
+    # controlling company of EEA and GB Company Full (company, ownership_percentage), and the v2.0 company
+    # representative (the flat person fields, roles, documents and, on the US variants, identification).
     # @!attribute id
+    #   The representative's id.
+    #   [Optional]
+    #   ^rep_[a-z0-9]{26}$
+    #   30 characters
     #   @return [String]
     # @!attribute individual
+    #   Information about the individual representing the sub-entity.
+    #   [Required] for every v3.0 person of interest.
     #   @return [RepresentativeIndividual] Personal details (Accounts API v3.0).
     # @!attribute company_position
+    #   The position of the representative within the company (required for the control_person role).
+    #   [Optional] (EEA, GB and US Company Full (3.0) and US ISV Seller Company (3.0))
     #   @return [String] {CompanyPosition}
     # @!attribute ownership_percentage
+    #   The percentage ownership of the UBO or controlling company (required when over 25%).
+    #   [Optional]
+    #   min 25, max 100 on the EEA, GB and US Company Full (3.0) variants; min 0, max 100 on the US ISV
+    #   Seller variants
     #   @return [Integer]
+    # @!attribute roles
+    #   The individual's roles within the company ({EntityRoles} values). For sole traders, must be ubo only.
+    #   [Required] for every variant except EEA and US Company Lite (2.0), where it is [Optional].
+    #   @return [Array(String)] {EntityRoles}
+    # @!attribute documents
+    #   Verification documents for the individual representative. On the EEA, GB and US Company Full (3.0)
+    #   and Sole Trader Full (3.0) variants the API validates this object strictly and rejects any key the
+    #   variant does not define; the US ISV Seller (3.0) and v2.0 variants do not declare it strict. See
+    #   {RepresentativeDocuments} for the keys each variant accepts.
+    #   [Required] for the EEA, GB and US Sole Trader Full (3.0) variants and EEA Company Full (2.0);
+    #   [Optional] otherwise.
+    #   @return [RepresentativeDocuments]
+    # @!attribute company
+    #   The controlling company, when the representative is a company rather than an individual.
+    #   [Required] for a controlling company representative (EEA and GB Company Full (3.0) only).
+    #   The API reads only three attributes here, all [Required]: legal_name, trading_name and
+    #   registered_address. Leave the other {Company} attributes unset.
+    #   @return [Company]
     # @!attribute first_name
+    #   The representative's first name. Accounts API v2.0 only.
+    #   [Required] (v2.0)
+    #   min 2 characters, max 50 characters
+    #   @deprecated Not used by the Accounts API v3.0 schema; use individual.
+    #   @return [String]
+    # @!attribute middle_name
+    #   The representative's middle name. Required if it appears in official documents. Accounts API v2.0
+    #   only.
+    #   [Optional]
+    #   min 2 characters, max 50 characters
+    #   @deprecated Not used by the Accounts API v3.0 schema; use individual.
     #   @return [String]
     # @!attribute last_name
+    #   The representative's last name. Accounts API v2.0 only.
+    #   [Required] (v2.0)
+    #   min 2 characters, max 50 characters
+    #   @deprecated Not used by the Accounts API v3.0 schema; use individual.
     #   @return [String]
     # @!attribute address
+    #   The representative's address. Accounts API v2.0 only.
+    #   [Required] (v2.0)
+    #   @deprecated Not used by the Accounts API v3.0 schema; use individual.
     #   @return [CheckoutSdk::Common::Address]
     # @!attribute identification
+    #   The representative's identification. Accounts API v2.0 US Company variants only.
+    #   [Required] for US Company Full (2.0); [Optional] for US Company Lite (2.0).
+    #   @deprecated Not used by the Accounts API v3.0 schema.
     #   @return [Identification]
     # @!attribute phone
+    #   The representative's phone number. Accounts API v2.0 only.
+    #   [Optional]
+    #   @deprecated Not used by the Accounts API v3.0 schema; use individual.
     #   @return [Phone]
     # @!attribute date_of_birth
+    #   The date of birth of the person according to the Gregorian calendar. Accounts API v2.0 only.
+    #   [Required] for the v2.0 Full variants; [Optional] for the v2.0 Lite variants.
+    #   @deprecated Not used by the Accounts API v3.0 schema; use individual.
     #   @return [DateOfBirth]
     # @!attribute place_of_birth
+    #   The place of birth of the person. Accounts API v2.0 only.
+    #   [Required] for EEA Company Full (2.0); [Optional] for EEA Company Lite (2.0). Not part of the other
+    #   v2.0 variants.
+    #   @deprecated Not used by the Accounts API v3.0 schema; use individual.
     #   @return [PlaceOfBirth]
-    # @!attribute roles
-    #   @return [Array(String)]
-    # @!attribute documents
-    #   @return [OnboardSubEntityDocuments]
     class Representative
       attr_accessor :id,
                     :individual,
@@ -35,8 +96,10 @@ module CheckoutSdk
                     :ownership_percentage,
                     :roles,
                     :documents,
+                    :company,
                     # v2.0 only — deprecated; use `individual` for v3.0
                     :first_name,
+                    :middle_name,
                     :last_name,
                     :address,
                     :identification,

data/lib/checkout_sdk/accounts/representative_documents.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # Verification documents for an individual representative, sent as company.representatives[].documents.
+    #
+    # On the EEA, GB and US Company Full (3.0) and the EEA, GB and US Sole Trader Full (3.0) variants the
+    # API validates this object strictly: a key it does not recognise is rejected, not ignored. The US ISV
+    # Seller variants (3.0) and the v2.0 variants do not declare it strict. These four are the only keys
+    # any variant defines, and which apply depends on the variant: EEA Sole Trader Full (3.0) requires
+    # identity_verification, proof_of_residential_address and proof_of_registration; GB and US Sole Trader
+    # Full (3.0) require identity_verification; the EEA, GB and US Company Full (3.0) variants and US ISV
+    # Seller Company (3.0) accept identity_verification and certified_authorised_signatory, both optional;
+    # US ISV Seller Sole Trader (3.0) accepts identity_verification, optional. The v2.0 company
+    # representatives use identity_verification only.
+    #
+    # Leave an attribute unset rather than assigning nil: an attribute set to nil is sent as null.
+    # Company-level documents such as bank_verification belong on {OnboardSubEntityDocuments}.
+    # @!attribute identity_verification
+    #   The document to use to confirm the individual's identity.
+    #   [Optional] (required for the sole trader full variants)
+    #   @return [Document]
+    # @!attribute certified_authorised_signatory
+    #   Certified authorised signatory document. Required when the legal representative or other role
+    #   owner is not registered on the certificate of incorporation.
+    #   [Optional] (EEA, GB and US Company Full (3.0) and US ISV Seller Company (3.0) only)
+    #   @return [CertifiedAuthorisedSignatory]
+    # @!attribute proof_of_residential_address
+    #   Proof of residential address of the representative.
+    #   [Optional] (required for EEA Sole Trader Full (3.0), and only valid there)
+    #   @return [ProofOfResidentialAddress]
+    # @!attribute proof_of_registration
+    #   Proof of the sole trader's registration, for example an extract from a trade register.
+    #   [Optional] (required for EEA Sole Trader Full (3.0), and only valid there)
+    #   @return [ProofOfRegistration]
+    class RepresentativeDocuments
+      attr_accessor :identity_verification,
+                    :certified_authorised_signatory,
+                    :proof_of_residential_address,
+                    :proof_of_registration
+    end
+  end
+end

data/lib/checkout_sdk/accounts/representative_individual.rb

@@ -2,29 +2,62 @@
 
 module CheckoutSdk
   module Accounts
-    # The personal details of a company representative ("person of interest"), as required by the
-    # Accounts API v3.0 schema.
+    # The personal details of a company representative (company.representatives[].individual), Accounts
+    # API v3.0.
     # @!attribute first_name
+    #   The representative's first name.
+    #   [Required]
+    #   min 2 characters, max 50 characters
     #   @return [String]
     # @!attribute middle_name
+    #   The representative's middle name. Required if it appears in official documents.
+    #   [Optional]
+    #   min 2 characters, max 50 characters
     #   @return [String]
     # @!attribute last_name
+    #   The representative's last name.
+    #   [Required]
+    #   min 2 characters, max 50 characters
     #   @return [String]
     # @!attribute date_of_birth
+    #   The date of birth of the person according to the Gregorian calendar.
+    #   [Required]
     #   @return [DateOfBirth]
     # @!attribute place_of_birth
+    #   The place of birth of the person.
+    #   [Required]
     #   @return [PlaceOfBirth]
     # @!attribute citizenships
+    #   The list of citizenships or legal statuses for the representative.
+    #   [Required] for the US ISV Seller variants only; not part of the other v3.0 schemas, leave unset for
+    #   them.
     #   @return [Array(Citizenship)]
     # @!attribute national_id_type
+    #   The classification of the national identification number provided.
+    #   [Required] for the US ISV Seller variants only; not part of the other v3.0 schemas, leave unset for
+    #   them.
     #   @return [String] {NationalIdType}
     # @!attribute national_id_number
+    #   The representative's national identification number.
+    #   [Required] for the US ISV Seller variants; [Optional] for the other v3.0 variants.
+    #   The format depends on the variant:
+    #     US ISV Seller: the number for the national_id_type given. ^[a-zA-Z0-9\-]+$, min 5 characters, max
+    #     16 characters.
+    #     Other v3.0 variants: a Social Security Number (SSN) or Individual Taxpayer Identification Number
+    #     (ITIN), US residents only. ^\d{9}$, 9 characters.
     #   @return [String]
     # @!attribute email_address
+    #   The representative's personal email address.
+    #   [Required] for the US ISV Seller variants; [Optional] for the other v3.0 variants.
+    #   Format: email
     #   @return [String]
     # @!attribute phone
+    #   The representative's phone number.
+    #   [Required] for the US ISV Seller variants; [Optional] for the other v3.0 variants.
     #   @return [Phone]
     # @!attribute address
+    #   The representative's address.
+    #   [Required]
     #   @return [CheckoutSdk::Common::Address]
     class RepresentativeIndividual
       attr_accessor :first_name,

data/lib/checkout_sdk/accounts/shareholder_structure.rb

@@ -2,9 +2,17 @@
 
 module CheckoutSdk
   module Accounts
+    # Shareholder structure chart (including % of shares) certified by a competent authority individual and
+    # dated within the last 3 months.
     # @!attribute type
-    #   @return [ShareholderStructureType]
+    #   The type of document.
+    #   [Required]
+    #   @return [String] {ShareholderStructureType}
     # @!attribute front
+    #   The ID of the front side of the document as represented within Checkout.com systems.
+    #   [Required]
+    #   ^file_[a-z2-7]{26}$
+    #   31 characters
     #   @return [String]
     class ShareholderStructure
       attr_accessor :type,

data/lib/checkout_sdk/accounts/shareholder_structure_type.rb

@@ -2,6 +2,7 @@
 
 module CheckoutSdk
   module Accounts
+    # The document type accepted as a certified shareholder structure.
     module ShareholderStructureType
       CERTIFIED_SHAREHOLDER_STRUCTURE = 'certified_shareholder_structure'
     end

data/lib/checkout_sdk/accounts/submitter.rb

@@ -2,10 +2,11 @@
 
 module CheckoutSdk
   module Accounts
-    # Captures evidence of the end-user's consent to onboarding.
-    #
+    # Not defined by any Accounts API onboarding schema.
+    # @deprecated Not part of any Accounts API onboarding schema; the API does not read it.
     # @!attribute ip_address
-    #   @return [String] IP address of the end-user submitting the onboarding request.
+    #   @deprecated Not defined by any Accounts API onboarding schema.
+    #   @return [String]
     class Submitter
       attr_accessor :ip_address
     end

data/lib/checkout_sdk/accounts/tax_verification.rb

@@ -2,9 +2,17 @@
 
 module CheckoutSdk
   module Accounts
+    # IRS-issued Employer Identification Number document used to verify the entity's tax identification
+    # (US variants).
     # @!attribute type
+    #   The type of IRS-issued document used for tax verification.
+    #   [Required]
     #   @return [String] {TaxVerificationType}
     # @!attribute front
+    #   The ID of the front side of the document as represented within Checkout.com systems.
+    #   [Required]
+    #   ^file_[a-z2-7]{26}$
+    #   31 characters
     #   @return [String]
     class TaxVerification
       attr_accessor :type,

data/lib/checkout_sdk/accounts/tax_verification_type.rb

@@ -2,6 +2,7 @@
 
 module CheckoutSdk
   module Accounts
+    # The document type accepted as tax verification: an IRS-issued Employer Identification Number letter.
     module TaxVerificationType
       EIN_LETTER = 'ein_letter'
     end

data/lib/checkout_sdk/accounts/update_payment_instrument_request.rb

@@ -2,12 +2,24 @@
 
 module CheckoutSdk
   module Accounts
+    # Request for PATCH /accounts/entities/{entityId}/payment-instruments/{id}
+    # (PlatformsPaymentInstrumentUpdate).
     # @!attribute label
+    #   A reference that you can use to identify the payment instrument.
+    #   [Optional]
+    #   min 1 character, max 50 characters
     #   @return [String]
     # @!attribute default
+    #   Deprecated by the API: for scheduled payouts the first payment instrument created for a currency
+    #   is used; to change it, update the payout schedule.
+    #   [Optional]
     #   @return [TrueClass, FalseClass]
     # @!attribute headers
-    #   @return [Headers]
+    #   The payment instrument ETag, as returned in the ETag header of the GET, in headers.if_match.
+    #   {AccountsClient#update_payment_instrument} sends it as the If-Match HTTP header; the API
+    #   answers 428 without it and 412 when it does not match.
+    #   [Required] by the API.
+    #   @return [CheckoutSdk::Common::Headers]
     class UpdatePaymentInstrumentRequest
       attr_accessor :label,
                     :default,

data/lib/checkout_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CheckoutSdk
-  VERSION = '2.5.0'
+  VERSION = '2.6.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkout_sdk
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Checkout
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-30 00:00:00.000000000 Z
+date: 2026-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -155,6 +155,8 @@ files:
 - lib/checkout_sdk/accounts/bank_verification.rb
 - lib/checkout_sdk/accounts/bank_verification_type.rb
 - lib/checkout_sdk/accounts/business_type.rb
+- lib/checkout_sdk/accounts/certified_authorised_signatory.rb
+- lib/checkout_sdk/accounts/certified_authorised_signatory_type.rb
 - lib/checkout_sdk/accounts/citizenship.rb
 - lib/checkout_sdk/accounts/company.rb
 - lib/checkout_sdk/accounts/company_position.rb
@@ -175,6 +177,7 @@ files:
 - lib/checkout_sdk/accounts/entity_requirement_update_request.rb
 - lib/checkout_sdk/accounts/entity_requirement_update_status.rb
 - lib/checkout_sdk/accounts/entity_roles.rb
+- lib/checkout_sdk/accounts/file_purpose.rb
 - lib/checkout_sdk/accounts/file_request.rb
 - lib/checkout_sdk/accounts/financial_statements.rb
 - lib/checkout_sdk/accounts/financial_statements_type.rb
@@ -206,7 +209,12 @@ files:
 - lib/checkout_sdk/accounts/proof_of_legality_type.rb
 - lib/checkout_sdk/accounts/proof_of_principal_address.rb
 - lib/checkout_sdk/accounts/proof_of_principal_address_type.rb
+- lib/checkout_sdk/accounts/proof_of_registration.rb
+- lib/checkout_sdk/accounts/proof_of_registration_type.rb
+- lib/checkout_sdk/accounts/proof_of_residential_address.rb
+- lib/checkout_sdk/accounts/proof_of_residential_address_type.rb
 - lib/checkout_sdk/accounts/representative.rb
+- lib/checkout_sdk/accounts/representative_documents.rb
 - lib/checkout_sdk/accounts/representative_individual.rb
 - lib/checkout_sdk/accounts/reserve_rule_create_request.rb
 - lib/checkout_sdk/accounts/reserve_rule_holding_duration.rb