checkout_sdk 1.9.1 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6fe0b38907019a7e5de79c5bef1cd96bcd3486b9bdb2097a5577fb9a57f009cd
-  data.tar.gz: 6d9f5b05f436e8025b4381157c096cb31e9d141fa4f43e0d87cb69b9da705c5e
+  metadata.gz: 45ebb2b2eaa19b09ab21a461f8a5dd756a97e29d1bd06740e9de75b851100662
+  data.tar.gz: 5d28f0b1d1187bfb0ef21230eb51397f6b9ec8af9953763957f8fdd50a41753a
 SHA512:
-  metadata.gz: 62c16a1f6cb31ba02338f4ac7cfae9dbd2f2b34a571b810bb66a8399e9a959c25f07c5ec8482ec0d0ccd5e6f2e3f3a61d816348b680881e935e1c31a072d9fc8
-  data.tar.gz: f128bee96ea6ca4593f82d871b61d74577760ed036e76b298a881bc7af9fded0e8eb7e4049606117127eb1c9a25ec8017409c37c505c8c917c1f8ce0c575cbcc
+  metadata.gz: e6b22a9a4f136e7f9615a3ea24addfd683af30d416728e51fac8c145fe4c37c049d2bd97a2933161a4facf45cf1777e0b6da304c2b1ee035ccb2d467b05c6e26
+  data.tar.gz: '08954406dad8050207e56060670a2e2ea44c39339d95684abc4ed0ec7f71fc860ccacf8430c2854fe7b3037adbac0bea61ffd96344c4df2a9bb07bdd09540fa8'

data/lib/checkout_sdk/accounts/accounts.rb

@@ -69,3 +69,14 @@ require 'checkout_sdk/accounts/rolling_reserve_rule'
 require 'checkout_sdk/accounts/reserve_rule_update_request'
 require 'checkout_sdk/accounts/reserve_rule_create_request'
 require 'checkout_sdk/accounts/entity_files_request'
+require 'checkout_sdk/accounts/agreed_terms'
+require 'checkout_sdk/accounts/processing_details_ach'
+require 'checkout_sdk/accounts/processing_details_payments'
+require 'checkout_sdk/accounts/company_position'
+require 'checkout_sdk/accounts/entity_roles'
+require 'checkout_sdk/accounts/national_id_type'
+require 'checkout_sdk/accounts/citizenship'
+require 'checkout_sdk/accounts/representative_individual'
+require 'checkout_sdk/accounts/financial_statements'
+require 'checkout_sdk/accounts/financial_statements_type'
+require 'checkout_sdk/accounts/articles_of_association'

data/lib/checkout_sdk/accounts/accounts_client.rb

@@ -14,6 +14,7 @@ module CheckoutSdk
       REQUIREMENTS = 'requirements'
       RESERVE_RULES = 'reserve-rules'
       MEMBERS = 'members'
+      DEFAULT_SCHEMA_VERSION = '3.0'
       private_constant :ACCOUNTS, :ENTITIES, :INSTRUMENT, :PAYOUT_SCHEDULE, :FILES, :PAYMENT_INSTRUMENTS,
                        :REQUIREMENTS, :RESERVE_RULES, :MEMBERS
 
@@ -26,19 +27,25 @@ module CheckoutSdk
       end
 
       # @param [Hash, OnboardEntity] entity_request
-      def create_entity(entity_request)
-        api_client.invoke_post(build_path(ACCOUNTS, ENTITIES), sdk_authorization, entity_request)
+      # @param [String] schema_version Accounts API schema version negotiated via the Accept header.
+      def create_entity(entity_request, schema_version = DEFAULT_SCHEMA_VERSION)
+        api_client.invoke_post(build_path(ACCOUNTS, ENTITIES), sdk_authorization, entity_request, nil,
+                               build_schema_version_headers(schema_version))
       end
 
       # @param [String] entity_id
-      def get_entity(entity_id)
-        api_client.invoke_get(build_path(ACCOUNTS, ENTITIES, entity_id), sdk_authorization)
+      # @param [String] schema_version Accounts API schema version negotiated via the Accept header.
+      def get_entity(entity_id, schema_version = DEFAULT_SCHEMA_VERSION)
+        api_client.invoke_get(build_path(ACCOUNTS, ENTITIES, entity_id), sdk_authorization, nil,
+                              build_schema_version_headers(schema_version))
       end
 
       # @param [String] entity_id
       # @param [Hash, OnboardEntity] entity_request
-      def update_entity(entity_id, entity_request)
-        api_client.invoke_put(build_path(ACCOUNTS, ENTITIES, entity_id), sdk_authorization, entity_request)
+      # @param [String] schema_version Accounts API schema version negotiated via the Accept header.
+      def update_entity(entity_id, entity_request, schema_version = DEFAULT_SCHEMA_VERSION)
+        api_client.invoke_put(build_path(ACCOUNTS, ENTITIES, entity_id), sdk_authorization, entity_request,
+                              build_schema_version_headers(schema_version))
       end
 
       # @deprecated Please use {#add_payment_instrument} instead
@@ -100,10 +107,13 @@ module CheckoutSdk
 
       # Retrieve the list of pending requirements that a sub-entity must resolve.
       # @param [String] entity_id
-      def get_entity_requirements(entity_id)
+      # @param [String] schema_version Accounts API schema version negotiated via the Accept header.
+      def get_entity_requirements(entity_id, schema_version = DEFAULT_SCHEMA_VERSION)
         api_client.invoke_get(
           build_path(ACCOUNTS, ENTITIES, entity_id, REQUIREMENTS),
-          sdk_authorization
+          sdk_authorization,
+          nil,
+          build_schema_version_headers(schema_version)
         )
       end
 
@@ -226,6 +236,17 @@ module CheckoutSdk
           sdk_authorization
         )
       end
+
+      private
+
+      # Builds the versioned Accept header for Accounts onboarding operations.
+      # @param [String] schema_version
+      # @return [CheckoutSdk::Common::Headers]
+      def build_schema_version_headers(schema_version)
+        headers = CheckoutSdk::Common::Headers.new
+        headers.accept = "application/json;schema_version=#{schema_version}"
+        headers
+      end
     end
   end
 end

data/lib/checkout_sdk/accounts/agreed_terms.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # The terms of service the sub-entity agreed to (Accounts API v3.0, SaaS onboarding).
+    # @!attribute date
+    #   @return [String] Date and time the terms were agreed (RFC 3339 / ISO 8601).
+    # @!attribute ip_address
+    #   @return [String] IP address (IPv4 or IPv6) of the person at the time they agreed.
+    # @!attribute name
+    #   @return [String] First and last name of the person who agreed to the terms.
+    # @!attribute email
+    #   @return [String] Email address of the person who agreed to the terms.
+    # @!attribute version
+    #   @return [String] Identifier of the terms version that was agreed.
+    class AgreedTerms
+      attr_accessor :date,
+                    :ip_address,
+                    :name,
+                    :email,
+                    :version
+    end
+  end
+end

data/lib/checkout_sdk/accounts/articles_of_association.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # @!attribute type
+    #   @return [ArticlesOfAssociationType]
+    # @!attribute front
+    #   @return [String]
+    class ArticlesOfAssociation
+      attr_accessor :type,
+                    :front
+    end
+  end
+end

data/lib/checkout_sdk/accounts/business_type.rb

@@ -3,13 +3,25 @@
 module CheckoutSdk
   module Accounts
     module BusinessType
+      INDIVIDUAL_OR_SOLE_PROPRIETORSHIP = 'individual_or_sole_proprietorship'
       GENERAL_PARTNERSHIP = 'general_partnership'
       LIMITED_PARTNERSHIP = 'limited_partnership'
+      SCOTTISH_LIMITED_PARTNERSHIP = 'scottish_limited_partnership'
       PUBLIC_LIMITED_COMPANY = 'public_limited_company'
       LIMITED_COMPANY = 'limited_company'
+      LIMITED_LIABILITY_CORPORATION = 'limited_liability_corporation'
+      PRIVATE_CORPORATION = 'private_corporation'
+      PUBLICLY_TRADED_CORPORATION = 'publicly_traded_corporation'
       PROFESSIONAL_ASSOCIATION = 'professional_association'
       UNINCORPORATED_ASSOCIATION = 'unincorporated_association'
       AUTO_ENTREPRENEUR = 'auto_entrepreneur'
+      GOVERNMENT_AGENCY = 'government_agency'
+      NON_PROFIT_ENTITY = 'non_profit_entity'
+      TRUST = 'trust'
+      CLUB_OR_SOCIETY = 'club_or_society'
+      REGULATED_FINANCIAL_INSTITUTION = 'regulated_financial_institution'
+      CFTC_REGISTERED_ENTITY = 'cftc_registered_entity'
+      SEC_REGISTERED_ENTITY = 'sec_registered_entity'
     end
   end
 end

data/lib/checkout_sdk/accounts/citizenship.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # A citizenship or legal status held by a company representative (Accounts API v3.0).
+    # @!attribute type
+    #   @return [String] The type of citizenship or legal status (e.g. `citizenship`, `residency`).
+    # @!attribute country
+    #   @return [String] {CheckoutSdk::Common::Country} two-letter ISO 3166-1 alpha-2 code.
+    class Citizenship
+      attr_accessor :type,
+                    :country
+    end
+  end
+end

data/lib/checkout_sdk/accounts/company.rb

@@ -10,6 +10,10 @@ module CheckoutSdk
     #   @return [String]
     # @!attribute trading_name
     #   @return [String]
+    # @!attribute additional_trading_names
+    #   @return [Array(String)]
+    # @!attribute is_registered_company
+    #   @return [Boolean]
     # @!attribute date_of_incorporation
     #   @return [DateOfIncorporation]
     # @!attribute regulatory_licence_number
@@ -29,6 +33,8 @@ module CheckoutSdk
                     :business_type,
                     :legal_name,
                     :trading_name,
+                    :additional_trading_names,
+                    :is_registered_company,
                     :date_of_incorporation,
                     :regulatory_licence_number,
                     :principal_address,

data/lib/checkout_sdk/accounts/company_position.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    module CompanyPosition
+      CEO = 'ceo'
+      CFO = 'cfo'
+      COO = 'coo'
+      MANAGING_MEMBER = 'managing_member'
+      GENERAL_PARTNER = 'general_partner'
+      PRESIDENT = 'president'
+      VICE_PRESIDENT = 'vice_president'
+      TREASURER = 'treasurer'
+      OTHER_SENIOR_MANAGEMENT = 'other_senior_management'
+      OTHER_EXECUTIVE_OFFICER = 'other_executive_officer'
+      OTHER_NON_EXECUTIVE_NON_SENIOR = 'other_non_executive_non_senior'
+    end
+  end
+end

data/lib/checkout_sdk/accounts/date_of_incorporation.rb

@@ -2,13 +2,16 @@
 
 module CheckoutSdk
   module Accounts
+    # @!attribute day
+    #   @return [Integer]
     # @!attribute month
     #   @return [Integer]
     # @!attribute year
     #   @return [Integer]
     class DateOfIncorporation
-      attr_reader :month,
-                  :year
+      attr_accessor :day,
+                    :month,
+                    :year
     end
   end
 end

data/lib/checkout_sdk/accounts/entity_roles.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    module EntityRoles
+      UBO = 'ubo'
+      LEGAL_REPRESENTATIVE = 'legal_representative'
+      AUTHORISED_SIGNATORY = 'authorised_signatory'
+      DIRECTOR = 'director'
+      CONTROL_PERSON = 'control_person'
+    end
+  end
+end

data/lib/checkout_sdk/accounts/financial_statements.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # @!attribute type
+    #   @return [FinancialStatementsType]
+    # @!attribute front
+    #   @return [String]
+    class FinancialStatements
+      attr_accessor :type,
+                    :front
+    end
+  end
+end

data/lib/checkout_sdk/accounts/financial_statements_type.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    module FinancialStatementsType
+      FINANCIAL_STATEMENTS = 'financial_statements'
+    end
+  end
+end

data/lib/checkout_sdk/accounts/national_id_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    module NationalIdType
+      SSN = 'ssn'
+      ITIN = 'itin'
+      PASSPORT = 'passport'
+      DRIVING_LICENSE = 'driving_license'
+      NATIONAL_ID_CARD = 'national_id_card'
+      RESIDENCE_PERMIT = 'residence_permit'
+      OTHER = 'other'
+    end
+  end
+end

data/lib/checkout_sdk/accounts/onboard_entity.rb

@@ -23,6 +23,9 @@ module CheckoutSdk
     # @!attribute seller_category
     #   @return [String] Identifier of a seller category configured on the platform
     #     during onboarding. Used for US ISV onboarding variants.
+    # @!attribute agreed_terms
+    #   @return [AgreedTerms] Details of the person who agreed to the terms and
+    #     conditions (Accounts API v3.0 SaaS onboarding).
     # @!attribute submitter
     #   @return [Submitter] Captures evidence of the end-user's consent to onboarding.
     #     Used for US ISV onboarding variants.
@@ -37,6 +40,7 @@ module CheckoutSdk
                     :documents,
                     :additional_info,
                     :seller_category,
+                    :agreed_terms,
                     :submitter
     end
   end

data/lib/checkout_sdk/accounts/onboard_sub_entity_documents.rb

@@ -7,7 +7,7 @@ module CheckoutSdk
     # @!attribute company_verification
     #   @return [CompanyVerification]
     # @!attribute articles_of_association
-    #   @return [ArticlesOfAssociationType]
+    #   @return [ArticlesOfAssociation]
     # @!attribute bank_verification
     #   @return [BankVerification]
     # @!attribute shareholder_structure
@@ -26,6 +26,8 @@ module CheckoutSdk
     #   @return [TaxVerification]
     # @!attribute financial_verification
     #   @return [FinancialVerification]
+    # @!attribute financial_statements
+    #   @return [FinancialStatements]
     class OnboardSubEntityDocuments
       attr_accessor :identity_verification,
                     :company_verification,
@@ -38,7 +40,8 @@ module CheckoutSdk
                     :additional_document2,
                     :additional_document3,
                     :tax_verification,
-                    :financial_verification
+                    :financial_verification,
+                    :financial_statements
     end
   end
 end

data/lib/checkout_sdk/accounts/phone.rb

@@ -2,10 +2,13 @@
 
 module CheckoutSdk
   module Accounts
+    # @!attribute country_code
+    #   @return [String] ISO 3166-1 alpha-2 country code (Accounts API v3.0), e.g. "GB".
     # @!attribute number
     #   @return [String]
     class Phone
-      attr_accessor :number
+      attr_accessor :country_code,
+                    :number
     end
   end
 end

data/lib/checkout_sdk/accounts/processing_details.rb

@@ -10,17 +10,23 @@ module CheckoutSdk
     #   @return [Integer]
     # @!attribute average_transaction_value
     #   @return [Integer]
+    # @!attribute average_order_fulfillment_time
+    #   @return [Integer]
     # @!attribute highest_transaction_value
     #   @return [Integer]
     # @!attribute currency
     #   @return [CheckoutSdk::Common::Currency]
+    # @!attribute payments
+    #   @return [ProcessingDetailsPayments]
     class ProcessingDetails
       attr_accessor :settlement_country,
                     :target_countries,
                     :annual_processing_volume,
                     :average_transaction_value,
+                    :average_order_fulfillment_time,
                     :highest_transaction_value,
-                    :currency
+                    :currency,
+                    :payments
     end
   end
 end

data/lib/checkout_sdk/accounts/processing_details_ach.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # ACH-specific processing details (Accounts API v3.0). All values in minor units without decimals.
+    # @!attribute annual_ach_volume
+    #   @return [Integer]
+    # @!attribute average_ach_transaction_size
+    #   @return [Integer]
+    # @!attribute estimated_monthly_credit_volume
+    #   @return [Integer]
+    # @!attribute average_credit_amount
+    #   @return [Integer]
+    class ProcessingDetailsAch
+      attr_accessor :annual_ach_volume,
+                    :average_ach_transaction_size,
+                    :estimated_monthly_credit_volume,
+                    :average_credit_amount
+    end
+  end
+end

data/lib/checkout_sdk/accounts/processing_details_payments.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # Payment method-specific processing details (Accounts API v3.0).
+    # @!attribute ach
+    #   @return [ProcessingDetailsAch]
+    class ProcessingDetailsPayments
+      attr_accessor :ach
+    end
+  end
+end

data/lib/checkout_sdk/accounts/representative.rb

@@ -4,6 +4,12 @@ module CheckoutSdk
   module Accounts
     # @!attribute id
     #   @return [String]
+    # @!attribute individual
+    #   @return [RepresentativeIndividual] Personal details (Accounts API v3.0).
+    # @!attribute company_position
+    #   @return [String] {CompanyPosition}
+    # @!attribute ownership_percentage
+    #   @return [Integer]
     # @!attribute first_name
     #   @return [String]
     # @!attribute last_name
@@ -24,15 +30,19 @@ module CheckoutSdk
     #   @return [OnboardSubEntityDocuments]
     class Representative
       attr_accessor :id,
+                    :individual,
+                    :company_position,
+                    :ownership_percentage,
+                    :roles,
+                    :documents,
+                    # v2.0 only — deprecated; use `individual` for v3.0
                     :first_name,
                     :last_name,
                     :address,
                     :identification,
                     :phone,
                     :date_of_birth,
-                    :place_of_birth,
-                    :roles,
-                    :documents
+                    :place_of_birth
     end
   end
 end

data/lib/checkout_sdk/accounts/representative_individual.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Accounts
+    # The personal details of a company representative ("person of interest"), as required by the
+    # Accounts API v3.0 schema.
+    # @!attribute first_name
+    #   @return [String]
+    # @!attribute middle_name
+    #   @return [String]
+    # @!attribute last_name
+    #   @return [String]
+    # @!attribute date_of_birth
+    #   @return [DateOfBirth]
+    # @!attribute place_of_birth
+    #   @return [PlaceOfBirth]
+    # @!attribute citizenships
+    #   @return [Array(Citizenship)]
+    # @!attribute national_id_type
+    #   @return [String] {NationalIdType}
+    # @!attribute national_id_number
+    #   @return [String]
+    # @!attribute email_address
+    #   @return [String]
+    # @!attribute phone
+    #   @return [Phone]
+    # @!attribute address
+    #   @return [CheckoutSdk::Common::Address]
+    class RepresentativeIndividual
+      attr_accessor :first_name,
+                    :middle_name,
+                    :last_name,
+                    :date_of_birth,
+                    :place_of_birth,
+                    :citizenships,
+                    :national_id_type,
+                    :national_id_number,
+                    :email_address,
+                    :phone,
+                    :address
+    end
+  end
+end

data/lib/checkout_sdk/api_client.rb

@@ -14,12 +14,12 @@ module CheckoutSdk
       @log = configuration.logger
     end
 
-    def invoke_get(path, authorization, params = nil)
-      invoke(:get, path, authorization, params: params)
+    def invoke_get(path, authorization, params = nil, headers = nil)
+      invoke(:get, path, authorization, params: params, extra_headers: headers)
     end
 
-    def invoke_post(path, authorization, request = nil, idempotency_key = nil)
-      invoke(:post, path, authorization, request, idempotency_key, params: nil)
+    def invoke_post(path, authorization, request = nil, idempotency_key = nil, headers = nil)
+      invoke(:post, path, authorization, request, idempotency_key, params: nil, extra_headers: headers)
     end
 
     def invoke_put(path, authorization, request, headers = nil)
@@ -71,9 +71,13 @@ module CheckoutSdk
     # canonical HTTP header.
     def apply_extra_headers(http_headers, extra_headers)
       return if extra_headers.nil?
-      return unless extra_headers.respond_to?(:if_match) && extra_headers.if_match
 
-      http_headers[:'If-Match'] = extra_headers.if_match
+      if extra_headers.respond_to?(:if_match) && extra_headers.if_match
+        http_headers[:'If-Match'] = extra_headers.if_match
+      end
+      return unless extra_headers.respond_to?(:accept) && extra_headers.accept
+
+      http_headers[:Accept] = extra_headers.accept
     end
 
     def append_params(path, input_params)

data/lib/checkout_sdk/checkout_api.rb

@@ -67,6 +67,8 @@ module CheckoutSdk
   #   @return [CheckoutSdk::Identities::AmlScreening::AmlScreeningClient]
   # @!attribute id_document_verification
   #   @return [CheckoutSdk::Identities::IdDocumentVerification::IdDocumentVerificationClient]
+  # @!attribute address_document_verification
+  #   @return [CheckoutSdk::Identities::AddressDocumentVerification::AddressDocumentVerificationClient]
   # @!attribute identity_verification
   #   @return [CheckoutSdk::Identities::IdentityVerification::IdentityVerificationClient]
   # @!attribute face_authentication
@@ -109,6 +111,7 @@ module CheckoutSdk
                 :applicants,
                 :aml_screening,
                 :id_document_verification,
+                :address_document_verification,
                 :identity_verification,
                 :face_authentication,
                 :apple_pay,
@@ -152,6 +155,9 @@ module CheckoutSdk
       @aml_screening = CheckoutSdk::Identities::AmlScreening::AmlScreeningClient.new(api_client, configuration)
       @id_document_verification =
         CheckoutSdk::Identities::IdDocumentVerification::IdDocumentVerificationClient.new(api_client, configuration)
+      @address_document_verification =
+        CheckoutSdk::Identities::AddressDocumentVerification::AddressDocumentVerificationClient.new(api_client,
+                                                                                                    configuration)
       @identity_verification =
         CheckoutSdk::Identities::IdentityVerification::IdentityVerificationClient.new(api_client, configuration)
       @face_authentication =

data/lib/checkout_sdk/common/headers.rb

@@ -9,8 +9,11 @@ module CheckoutSdk
     #
     # @!attribute if_match
     #   @return [String] ETag value to forward as the `If-Match` HTTP header.
+    # @!attribute accept
+    #   @return [String] value to forward as the `Accept` HTTP header, e.g.
+    #     `application/json;schema_version=3.0` for Accounts API schema negotiation.
     class Headers
-      attr_accessor :if_match
+      attr_accessor :if_match, :accept
     end
   end
 end

data/lib/checkout_sdk/forward/create_secret_request.rb

@@ -2,7 +2,7 @@
 
 module CheckoutSdk
   module Forward
-    # Request body for POST /forward/secrets.
+    # Request body for POST /secrets.
     #
     # @!attribute name
     #   @return [String] Secret name (1-64 alphanumeric chars).

data/lib/checkout_sdk/forward/forward_client.rb

@@ -25,26 +25,26 @@ module CheckoutSdk
 
       # @param [Hash, CreateSecretRequest] create_secret_request
       def create_secret(create_secret_request)
-        api_client.invoke_post(build_path(FORWARD, SECRETS),
+        api_client.invoke_post(build_path(SECRETS),
                                sdk_authorization,
                                create_secret_request)
       end
 
       def get_secrets
-        api_client.invoke_get(build_path(FORWARD, SECRETS), sdk_authorization)
+        api_client.invoke_get(build_path(SECRETS), sdk_authorization)
       end
 
       # @param [String] name
       # @param [Hash, UpdateSecretRequest] update_secret_request
       def update_secret(name, update_secret_request)
-        api_client.invoke_patch(build_path(FORWARD, SECRETS, name),
+        api_client.invoke_patch(build_path(SECRETS, name),
                                 sdk_authorization,
                                 update_secret_request)
       end
 
       # @param [String] name
       def delete_secret(name)
-        api_client.invoke_delete(build_path(FORWARD, SECRETS, name),
+        api_client.invoke_delete(build_path(SECRETS, name),
                                  sdk_authorization)
       end
     end

data/lib/checkout_sdk/forward/update_secret_request.rb

@@ -2,7 +2,7 @@
 
 module CheckoutSdk
   module Forward
-    # Request body for PATCH /forward/secrets/{name}.
+    # Request body for PATCH /secrets/{name}.
     #
     # @!attribute value
     #   @return [String] New plaintext secret value (max 8KB).

data/lib/checkout_sdk/identities/address_document_verification/address_document_verification_attempt_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Identities
+    module AddressDocumentVerification
+      # Request body for POST /address-document-verifications/{id}/attempts.
+      #
+      # @!attribute document
+      #   @return [String] The address document image to upload. [Required] Format: binary
+      class AddressDocumentVerificationAttemptRequest
+        attr_accessor :document
+      end
+    end
+  end
+end

data/lib/checkout_sdk/identities/address_document_verification/address_document_verification_client.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Identities
+    module AddressDocumentVerification
+      # Client for the Identities — Address Document Verification (Adv) API.
+      class AddressDocumentVerificationClient < Client
+        ADDRESS_DOCUMENT_VERIFICATIONS = 'address-document-verifications'
+        ANONYMIZE = 'anonymize'
+        ATTEMPTS = 'attempts'
+        PDF_REPORT = 'pdf-report'
+        private_constant :ADDRESS_DOCUMENT_VERIFICATIONS, :ANONYMIZE, :ATTEMPTS, :PDF_REPORT
+
+        # @param [ApiClient] api_client
+        # @param [CheckoutConfiguration] configuration
+        def initialize(api_client, configuration)
+          super(api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY_OR_OAUTH)
+        end
+
+        # @param [Hash, AddressDocumentVerificationRequest] request
+        def create_address_document_verification(request)
+          api_client.invoke_post(ADDRESS_DOCUMENT_VERIFICATIONS, sdk_authorization, request)
+        end
+
+        # @param [String] address_document_verification_id
+        def get_address_document_verification(address_document_verification_id)
+          api_client.invoke_get(
+            build_path(ADDRESS_DOCUMENT_VERIFICATIONS, address_document_verification_id),
+            sdk_authorization
+          )
+        end
+
+        # @param [String] address_document_verification_id
+        def anonymize_address_document_verification(address_document_verification_id)
+          api_client.invoke_post(
+            build_path(ADDRESS_DOCUMENT_VERIFICATIONS, address_document_verification_id, ANONYMIZE),
+            sdk_authorization
+          )
+        end
+
+        # Create a new attempt for an existing address document verification.
+        # @param [String] address_document_verification_id
+        # @param [Hash, AddressDocumentVerificationAttemptRequest] attempt_request
+        def create_address_document_verification_attempt(address_document_verification_id, attempt_request = nil)
+          api_client.invoke_post(
+            build_path(ADDRESS_DOCUMENT_VERIFICATIONS, address_document_verification_id, ATTEMPTS),
+            sdk_authorization,
+            attempt_request
+          )
+        end
+
+        # @param [String] address_document_verification_id
+        def get_address_document_verification_attempts(address_document_verification_id)
+          api_client.invoke_get(
+            build_path(ADDRESS_DOCUMENT_VERIFICATIONS, address_document_verification_id, ATTEMPTS),
+            sdk_authorization
+          )
+        end
+
+        # @param [String] address_document_verification_id
+        # @param [String] attempt_id
+        def get_address_document_verification_attempt(address_document_verification_id, attempt_id)
+          api_client.invoke_get(
+            build_path(ADDRESS_DOCUMENT_VERIFICATIONS, address_document_verification_id, ATTEMPTS, attempt_id),
+            sdk_authorization
+          )
+        end
+
+        # @param [String] address_document_verification_id
+        def get_address_document_verification_pdf_report(address_document_verification_id)
+          api_client.invoke_get(
+            build_path(ADDRESS_DOCUMENT_VERIFICATIONS, address_document_verification_id, PDF_REPORT),
+            sdk_authorization
+          )
+        end
+      end
+    end
+  end
+end

data/lib/checkout_sdk/identities/address_document_verification/address_document_verification_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Identities
+    module AddressDocumentVerification
+      # Request body for POST /address-document-verifications.
+      #
+      # @!attribute applicant_id
+      #   @return [String] The applicant's unique identifier. [Required] Pattern: ^aplt_\w+$
+      # @!attribute user_journey_id
+      #   @return [String] Your configuration ID. [Required] Pattern: ^usj_[a-z2-7]{26}$
+      # @!attribute declared_data
+      #   @return [IdvDeclaredData, Hash] The personal details provided by the applicant. [Optional]
+      class AddressDocumentVerificationRequest
+        attr_accessor :applicant_id,
+                      :user_journey_id,
+                      :declared_data
+      end
+    end
+  end
+end

data/lib/checkout_sdk/identities/identities.rb

@@ -14,6 +14,11 @@ require 'checkout_sdk/identities/aml_screening/aml_screening_client'
 require 'checkout_sdk/identities/id_document_verification/id_document_verification_request'
 require 'checkout_sdk/identities/id_document_verification/id_document_verification_client'
 
+# Address Document Verification
+require 'checkout_sdk/identities/address_document_verification/address_document_verification_request'
+require 'checkout_sdk/identities/address_document_verification/address_document_verification_attempt_request'
+require 'checkout_sdk/identities/address_document_verification/address_document_verification_client'
+
 # Identity Verification
 require 'checkout_sdk/identities/identity_verification/idv_declared_data'
 require 'checkout_sdk/identities/identity_verification/idv_client_information'

data/lib/checkout_sdk/sessions/category.rb

@@ -4,7 +4,7 @@ module CheckoutSdk
   module Sessions
     module Category
       PAYMENT = 'payment'
-      NON_PAYMENT = 'nonPayment'
+      NON_PAYMENT = 'non_payment'
     end
   end
 end

data/lib/checkout_sdk/sessions/channel/browser_session.rb

@@ -26,6 +26,11 @@ module CheckoutSdk
     #   @return [String]
     # @!attribute ip_address
     #   @return [String]
+    # @!attribute iframe_payment_allowed
+    #   @return [TrueClass, FalseClass] Whether the Payment API is enabled for all parent frames.
+    #     Required for Google SPA support in hosted sessions.
+    # @!attribute user_agent_client_hint
+    #   @return [String] The raw Sec-CH-UA header value. This can improve Google SPA support.
     class BrowserSession < ChannelData
       attr_accessor :three_ds_method_completion,
                     :accept_header,
@@ -37,7 +42,9 @@ module CheckoutSdk
                     :screen_width,
                     :timezone,
                     :user_agent,
-                    :ip_address
+                    :ip_address,
+                    :iframe_payment_allowed,
+                    :user_agent_client_hint
 
       def initialize(three_ds_method_completion: CheckoutSdk::Sessions::ThreeDsMethodCompletion::U)
         super(ChannelDataType::BROWSER)

data/lib/checkout_sdk/sessions/channel/three_ds_method_completion.rb

@@ -3,9 +3,9 @@
 module CheckoutSdk
   module Sessions
     module ThreeDsMethodCompletion
-      Y = 'y'
-      N = 'n'
-      U = 'u'
+      Y = 'Y'
+      N = 'N'
+      U = 'U'
     end
   end
 end

data/lib/checkout_sdk/sessions/experience.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Sessions
+    # The authentication experience chosen for a session.
+    #
+    # Used by {SessionRequest#preferred_experiences}, which takes an array of these values.
+    #
+    # [Optional]
+    module Experience
+      # 3D Secure authentication. The constant is named THREE_DS because a Ruby constant cannot
+      # begin with a digit; the wire value is '3ds'.
+      THREE_DS = '3ds'
+      # Google Secure Payment Authentication.
+      GOOGLE_SPA = 'google_spa'
+    end
+  end
+end

data/lib/checkout_sdk/sessions/google_spa.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Sessions
+    # This object contains the Google SPA properties (non-hosted only).
+    #
+    # @!attribute continue_url
+    #   @return [String] Fully qualified URL for redirecting the user's browser session after
+    #     authentication. For example, this field may be the merchant's website for purchase
+    #     confirmation once payment is complete. Required if in full redirect (not iframe) mode.
+    class GoogleSpa
+      attr_accessor :continue_url
+    end
+  end
+end

data/lib/checkout_sdk/sessions/session_challenge_indicator.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Sessions
+    # Indicates whether a challenge is requested for this session.
+    #
+    # Used by {SessionRequest#challenge_indicator} for POST /sessions. This is the only field in the
+    # API that accepts the exemption values below; the 3ds.challenge_indicator field on payments,
+    # hosted payments, payment links and payment sessions accepts only the first four values and is
+    # modelled by {CheckoutSdk::Common::ChallengeIndicator}.
+    #
+    # The following are requests for exemption: {LOW_VALUE}, {TRUSTED_LISTING},
+    # {TRUSTED_LISTING_PROMPT} and {TRANSACTION_RISK_ASSESSMENT}. If an exemption cannot be applied,
+    # then the value {NO_CHALLENGE_REQUESTED} will be used instead.
+    #
+    # [Optional]
+    # Default: {NO_PREFERENCE}
+    # max 50 characters
+    module SessionChallengeIndicator
+      NO_PREFERENCE = 'no_preference'
+      NO_CHALLENGE_REQUESTED = 'no_challenge_requested'
+      CHALLENGE_REQUESTED = 'challenge_requested'
+      CHALLENGE_REQUESTED_MANDATE = 'challenge_requested_mandate'
+      LOW_VALUE = 'low_value'
+      TRUSTED_LISTING = 'trusted_listing'
+      TRUSTED_LISTING_PROMPT = 'trusted_listing_prompt'
+      TRANSACTION_RISK_ASSESSMENT = 'transaction_risk_assessment'
+      DATA_SHARE = 'data_share'
+    end
+  end
+end

data/lib/checkout_sdk/sessions/session_request.rb

@@ -3,7 +3,7 @@
 require 'checkout_sdk/sessions/authentication_type'
 require 'checkout_sdk/sessions/category'
 require 'checkout_sdk/sessions/transaction_type'
-require 'checkout_sdk/common/challenge_indicator'
+require 'checkout_sdk/sessions/session_challenge_indicator'
 
 module CheckoutSdk
   module Sessions
@@ -24,15 +24,13 @@ module CheckoutSdk
     # @!attribute account_info
     #   @return [CardHolderAccountInfo]
     # @!attribute challenge_indicator
-    #   @return [String] {CheckoutSdk::Common::ChallengeIndicator}
+    #   @return [String] {SessionChallengeIndicator}
     # @!attribute billing_descriptor
     #   @return [SessionsBillingDescriptor]
     # @!attribute reference
     #   @return [String]
     # @!attribute merchant_risk_info
     #   @return [MerchantRiskInfo]
-    # @!attribute prior_transaction_reference
-    #   @return [String]
     # @!attribute transaction_type
     #   @return [String] {TransactionType}
     # @!attribute shipping_address
@@ -51,6 +49,12 @@ module CheckoutSdk
     #   @return [Optimization]
     # @!attribute initial_transaction
     #   @return [InitialTransaction]
+    # @!attribute device_information
+    #   @return [DeviceInformation]
+    # @!attribute google_spa
+    #   @return [GoogleSpa] Google SPA properties (non-hosted only).
+    # @!attribute preferred_experiences
+    #   @return [Array<String>] The chosen experience(s) for this session. {Experience}
     class SessionRequest
       attr_accessor :source,
                     :amount,
@@ -64,7 +68,6 @@ module CheckoutSdk
                     :billing_descriptor,
                     :reference,
                     :merchant_risk_info,
-                    :prior_transaction_reference,
                     :transaction_type,
                     :shipping_address,
                     :shipping_address_matches_billing,
@@ -74,12 +77,14 @@ module CheckoutSdk
                     :installment,
                     :optimization,
                     :initial_transaction,
-                    :device_information
+                    :device_information,
+                    :google_spa,
+                    :preferred_experiences
 
       def initialize(source: CardSource.new,
                      authentication_type: CheckoutSdk::Sessions::AuthenticationType::REGULAR,
                      authentication_category: CheckoutSdk::Sessions::Category::PAYMENT,
-                     challenge_indicator: CheckoutSdk::Common::ChallengeIndicator::NO_PREFERENCE,
+                     challenge_indicator: CheckoutSdk::Sessions::SessionChallengeIndicator::NO_PREFERENCE,
                      transaction_type: CheckoutSdk::Sessions::TransactionType::GOODS_SERVICE)
         @source = source
         @authentication_type = authentication_type

data/lib/checkout_sdk/sessions/sessions.rb

@@ -6,10 +6,13 @@ require 'checkout_sdk/sessions/card_holder_account_info'
 require 'checkout_sdk/sessions/category'
 require 'checkout_sdk/sessions/delivery_timeframe'
 require 'checkout_sdk/sessions/device_information'
+require 'checkout_sdk/sessions/experience'
+require 'checkout_sdk/sessions/google_spa'
 require 'checkout_sdk/sessions/installment'
 require 'checkout_sdk/sessions/merchant_risk_info'
 require 'checkout_sdk/sessions/recurring'
 require 'checkout_sdk/sessions/session_address'
+require 'checkout_sdk/sessions/session_challenge_indicator'
 require 'checkout_sdk/sessions/session_marketplace_data'
 require 'checkout_sdk/sessions/session_request'
 require 'checkout_sdk/sessions/session_source_type'

data/lib/checkout_sdk/sessions/shipping_indicator.rb

@@ -2,8 +2,20 @@
 
 module CheckoutSdk
   module Sessions
+    # Indicates the shipping method chosen for the transaction.
+    #
+    # Used by {MerchantRiskInfo#shipping_indicator}. Choose the option that accurately describes the
+    # cardholder's specific transaction.
+    #
+    # [Optional]
     module ShippingIndicator
-      VISA = 'visa'
+      BILLING_ADDRESS = 'billing_address'
+      ANOTHER_ADDRESS_ON_FILE = 'another_address_on_file'
+      NOT_ON_FILE = 'not_on_file'
+      STORE_PICK_UP = 'store_pick_up'
+      DIGITAL_GOODS = 'digital_goods'
+      TRAVEL_AND_EVENT_NO_SHIPPING = 'travel_and_event_no_shipping'
+      OTHER = 'other'
     end
   end
 end

data/lib/checkout_sdk/sessions/source/card_source.rb

@@ -12,15 +12,12 @@ module CheckoutSdk
     #   @return [String]
     # @!attribute stored
     #   @return [TrueClass, FalseClass]
-    # @!attribute store_for_future_use
-    #   @return [TrueClass, FalseClass]
     class CardSource < SessionSource
       attr_accessor :number,
                     :expiry_month,
                     :expiry_year,
                     :name,
-                    :stored,
-                    :store_for_future_use
+                    :stored
 
       def initialize(stored: false)
         super(SessionSourceType::CARD)

data/lib/checkout_sdk/sessions/source/session_scheme.rb

@@ -9,6 +9,8 @@ module CheckoutSdk
       AMEX = 'amex'
       DINERS = 'diners'
       CARTES_BANCAIRES = 'cartes_bancaires'
+      DISCOVER = 'discover'
+      UPI = 'upi'
     end
   end
 end

data/lib/checkout_sdk/sessions/transaction_type.rb

@@ -7,7 +7,7 @@ module CheckoutSdk
       CHECK_ACCEPTANCE = 'check_acceptance'
       GOODS_SERVICE = 'goods_service'
       PREPAID_ACTIVATION_AND_LOAD = 'prepaid_activation_and_load'
-      QUASHI_CARD_TRANSACTION = 'quashi_card_transaction'
+      QUASI_CARD_TRANSACTION = 'quasi_card_transaction'
     end
   end
 end

data/lib/checkout_sdk/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkout_sdk
 version: !ruby/object:Gem::Version
-  version: 1.9.1
+  version: 1.11.0
 platform: ruby
 authors:
 - Checkout
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-21 00:00:00.000000000 Z
+date: 2026-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -149,11 +149,15 @@ files:
 - lib/checkout_sdk/accounts/accounts_client.rb
 - lib/checkout_sdk/accounts/additional_document.rb
 - lib/checkout_sdk/accounts/additional_info.rb
+- lib/checkout_sdk/accounts/agreed_terms.rb
+- lib/checkout_sdk/accounts/articles_of_association.rb
 - lib/checkout_sdk/accounts/articles_of_association_type.rb
 - 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/citizenship.rb
 - lib/checkout_sdk/accounts/company.rb
+- lib/checkout_sdk/accounts/company_position.rb
 - lib/checkout_sdk/accounts/company_verification.rb
 - lib/checkout_sdk/accounts/company_verification_type.rb
 - lib/checkout_sdk/accounts/contact_details.rb
@@ -170,7 +174,10 @@ files:
 - lib/checkout_sdk/accounts/entity_requirement_reason.rb
 - 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_request.rb
+- lib/checkout_sdk/accounts/financial_statements.rb
+- lib/checkout_sdk/accounts/financial_statements_type.rb
 - lib/checkout_sdk/accounts/financial_verification.rb
 - lib/checkout_sdk/accounts/financial_verification_type.rb
 - lib/checkout_sdk/accounts/identification.rb
@@ -182,6 +189,7 @@ files:
 - lib/checkout_sdk/accounts/instrument_details_sepa.rb
 - lib/checkout_sdk/accounts/instrument_document.rb
 - lib/checkout_sdk/accounts/invitee.rb
+- lib/checkout_sdk/accounts/national_id_type.rb
 - lib/checkout_sdk/accounts/onboard_entity.rb
 - lib/checkout_sdk/accounts/onboard_sub_entity_documents.rb
 - lib/checkout_sdk/accounts/payment_instrument.rb
@@ -190,12 +198,15 @@ files:
 - lib/checkout_sdk/accounts/phone.rb
 - lib/checkout_sdk/accounts/place_of_birth.rb
 - lib/checkout_sdk/accounts/processing_details.rb
+- lib/checkout_sdk/accounts/processing_details_ach.rb
+- lib/checkout_sdk/accounts/processing_details_payments.rb
 - lib/checkout_sdk/accounts/profile.rb
 - lib/checkout_sdk/accounts/proof_of_legality.rb
 - 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/representative.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
 - lib/checkout_sdk/accounts/reserve_rule_update_request.rb
@@ -305,6 +316,9 @@ files:
 - lib/checkout_sdk/forward/forward_client.rb
 - lib/checkout_sdk/forward/update_secret_request.rb
 - lib/checkout_sdk/http_metadata.rb
+- lib/checkout_sdk/identities/address_document_verification/address_document_verification_attempt_request.rb
+- lib/checkout_sdk/identities/address_document_verification/address_document_verification_client.rb
+- lib/checkout_sdk/identities/address_document_verification/address_document_verification_request.rb
 - lib/checkout_sdk/identities/aml_screening/aml_screening_client.rb
 - lib/checkout_sdk/identities/aml_screening/aml_search_parameters.rb
 - lib/checkout_sdk/identities/aml_screening/aml_verification_request.rb
@@ -621,6 +635,8 @@ files:
 - lib/checkout_sdk/sessions/completion/non_hosted_completion_info.rb
 - lib/checkout_sdk/sessions/delivery_timeframe.rb
 - lib/checkout_sdk/sessions/device_information.rb
+- lib/checkout_sdk/sessions/experience.rb
+- lib/checkout_sdk/sessions/google_spa.rb
 - lib/checkout_sdk/sessions/initial_transaction.rb
 - lib/checkout_sdk/sessions/installment.rb
 - lib/checkout_sdk/sessions/merchant_risk_info.rb
@@ -630,6 +646,7 @@ files:
 - lib/checkout_sdk/sessions/recurring.rb
 - lib/checkout_sdk/sessions/reorder_items_indicator_type.rb
 - lib/checkout_sdk/sessions/session_address.rb
+- lib/checkout_sdk/sessions/session_challenge_indicator.rb
 - lib/checkout_sdk/sessions/session_marketplace_data.rb
 - lib/checkout_sdk/sessions/session_request.rb
 - lib/checkout_sdk/sessions/session_secret_credentials.rb