checkout_sdk 1.5.0 → 1.7.0

data/lib/checkout_sdk/api_client.rb

@@ -22,8 +22,8 @@ module CheckoutSdk
       invoke(:post, path, authorization, request, idempotency_key, params: nil)
     end
 
-    def invoke_put(path, authorization, request)
-      invoke(:put, path, authorization, request, nil, params: nil)
+    def invoke_put(path, authorization, request, headers = nil)
+      invoke(:put, path, authorization, request, nil, params: nil, extra_headers: headers)
     end
 
     def invoke_patch(path, authorization, request = nil)
@@ -40,13 +40,15 @@ module CheckoutSdk
 
     private
 
-    def invoke(method, path, authorization, body = nil, idempotency_key = nil, params: nil)
+    def invoke(method, path, authorization, body = nil, idempotency_key = nil, params: nil, extra_headers: nil)
       path = append_params(path, params) unless params.nil?
 
       headers = default_headers(authorization)
       headers[:'Content-Type'] = 'application/json'
       headers[:'Cko-Idempotency-Key'] = idempotency_key unless idempotency_key.nil?
 
+      apply_extra_headers(headers, extra_headers)
+
       json_body = CheckoutSdk::JsonSerializer.to_custom_hash(body).to_json
 
       begin
@@ -64,6 +66,16 @@ module CheckoutSdk
         Authorization: authorization.authorization_header }
     end
 
+    # Map a typed headers container (e.g. {CheckoutSdk::Common::Headers}) onto the underlying
+    # HTTP header hash. Each attribute that's set is emitted as the corresponding
+    # 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
+    end
+
     def append_params(path, input_params)
       raise CheckoutArgumentException, 'Query parameters were not provided' if input_params.nil?
 
@@ -92,24 +104,22 @@ module CheckoutSdk
     def upload(path, authorization, file_request)
       headers = default_headers(authorization)
 
-      file = File.open(file_request.file)
+      File.open(file_request.file) do |file|
+        form = build_multipart_request(file_request, file)
 
-      form = build_multipart_request(file_request, file)
+        begin
+          @log.info "post: /#{path}"
+          response = @multipart_client.run_request(:post, path, form, headers)
+        rescue Faraday::ClientError => e
+          raise CheckoutApiException, e.response
+        end
 
-      begin
-        @log.info "post: /#{path}"
-        response = @multipart_client.run_request(:post, path, form, headers)
-      rescue Faraday::ClientError => e
-        raise CheckoutApiException, e.response
-      ensure
-        file.close
+        parse_response(response)
       end
-
-      parse_response(response)
     end
 
     def parse_response(response)
-      raise CheckoutApiException, response if response.status < 200 || response.status >= 300
+      raise CheckoutApiException, response if response.status < 200 || response.status >= 400
 
       metadata = CheckoutUtils.map_to_http_metadata(response)
       body = parse_body(response)

data/lib/checkout_sdk/balances/balance_values.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Balances
+    # Balance values returned per currency account (swagger schema: Balance).
+    #
+    # @!attribute pending
+    #   @return [Integer] Incoming funds that will be added to Available once cleared.
+    # @!attribute available
+    #   @return [Integer] Funds available for processing.
+    # @!attribute payable
+    #   @return [Integer] Funds reserved from Available for outgoing transactions not yet cleared.
+    # @!attribute collateral
+    #   @return [Integer] Funds held to cover potential liabilities.
+    # @!attribute operational
+    #   @return [Integer] Funds held for processing Payouts and Issuing payments when Available is insufficient.
+    # @!attribute collateral_breakdown
+    #   @return [CollateralBreakdown]
+    class BalanceValues
+      attr_accessor :pending,
+                    :available,
+                    :payable,
+                    :collateral,
+                    :operational,
+                    :collateral_breakdown
+    end
+  end
+end

data/lib/checkout_sdk/balances/balances.rb

@@ -1,3 +1,7 @@
 # frozen_string_literal: true
 
+require 'checkout_sdk/balances/balances_query'
+require 'checkout_sdk/balances/collateral_breakdown'
+require 'checkout_sdk/balances/balance_values'
+require 'checkout_sdk/balances/currency_account_balance'
 require 'checkout_sdk/balances/balances_client'

data/lib/checkout_sdk/balances/balances_query.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Balances
+    # Query parameters accepted by GET /balances/{id}.
+    #
+    # @!attribute query
+    #   @return [String] Search expression (e.g. "currency:EUR").
+    # @!attribute with_currency_account_id
+    #   @return [TrueClass, FalseClass] When true, the response includes the
+    #     `currency_account_id` on each {CurrencyAccountBalance}.
+    #   Serialised as `withCurrencyAccountId`.
+    # @!attribute balances_at
+    #   @return [String] A UTC datetime (RFC 3339) to retrieve historical
+    #     balances at a specific point in time. Must be in the past.
+    #   Serialised as `balancesAt`.
+    class BalancesQuery
+      attr_accessor :query,
+                    :with_currency_account_id,
+                    :balances_at
+
+      # Returns the params in the camelCase form expected by the API.
+      def to_h
+        {
+          query: query,
+          withCurrencyAccountId: with_currency_account_id,
+          balancesAt: balances_at
+        }.compact
+      end
+    end
+  end
+end

data/lib/checkout_sdk/balances/collateral_breakdown.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Balances
+    # Breakdown of the funds held in the `collateral` balance.
+    #
+    # @!attribute fixed_reserve
+    #   @return [Integer] (required) The portion of the `collateral` balance held as a fixed reserve.
+    # @!attribute rolling_reserve
+    #   @return [Integer] (required) The portion of the `collateral` balance held as a rolling reserve.
+    class CollateralBreakdown
+      attr_accessor :fixed_reserve,
+                    :rolling_reserve
+    end
+  end
+end

data/lib/checkout_sdk/balances/currency_account_balance.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Balances
+    # A single currency account's balance details (swagger: CurrencyAccountBalance).
+    #
+    # @!attribute currency_account_id
+    #   @return [String] The unique identifier of the currency account (sub-account).
+    #     Returned only when the request is made with `withCurrencyAccountId=true`.
+    # @!attribute descriptor
+    #   @return [String]
+    # @!attribute holding_currency
+    #   @return [String] {CheckoutSdk::Common::Currency}
+    # @!attribute balances_as_of
+    #   @return [String] UTC datetime (RFC 3339) reflecting when balance values were fetched.
+    # @!attribute balances
+    #   @return [BalanceValues]
+    class CurrencyAccountBalance
+      attr_accessor :currency_account_id,
+                    :descriptor,
+                    :holding_currency,
+                    :balances_as_of,
+                    :balances
+    end
+  end
+end

data/lib/checkout_sdk/checkout_api.rb

@@ -45,8 +45,36 @@ module CheckoutSdk
   #   @return [CheckoutSdk::Payments::PaymentSessionsClient]
   # @!attribute payments_setups
   #   @return [CheckoutSdk::Payments::PaymentSetupsClient]
+  # @!attribute flow
+  #   @return [CheckoutSdk::Payments::FlowClient]
   # @!attribute forward
   #   @return [CheckoutSdk::Forward::ForwardClient]
+  # @!attribute onboarding_simulator
+  #   @return [CheckoutSdk::OnboardingSimulator::OnboardingSimulatorClient]
+  # @!attribute agentic_commerce
+  #   @return [CheckoutSdk::AgenticCommerce::AgenticCommerceClient]
+  # @!attribute compliance_requests
+  #   @return [CheckoutSdk::ComplianceRequests::ComplianceRequestsClient]
+  # @!attribute standalone_account_updater
+  #   @return [CheckoutSdk::StandaloneAccountUpdater::StandaloneAccountUpdaterClient]
+  # @!attribute network_tokens
+  #   @return [CheckoutSdk::NetworkTokens::NetworkTokensClient]
+  # @!attribute payment_methods
+  #   @return [CheckoutSdk::PaymentMethods::PaymentMethodsClient]
+  # @!attribute applicants
+  #   @return [CheckoutSdk::Identities::Applicants::ApplicantsClient]
+  # @!attribute aml_screening
+  #   @return [CheckoutSdk::Identities::AmlScreening::AmlScreeningClient]
+  # @!attribute id_document_verification
+  #   @return [CheckoutSdk::Identities::IdDocumentVerification::IdDocumentVerificationClient]
+  # @!attribute identity_verification
+  #   @return [CheckoutSdk::Identities::IdentityVerification::IdentityVerificationClient]
+  # @!attribute face_authentication
+  #   @return [CheckoutSdk::Identities::FaceAuthentication::FaceAuthenticationClient]
+  # @!attribute apple_pay
+  #   @return [CheckoutSdk::Payments::ApplePayClient]
+  # @!attribute google_pay
+  #   @return [CheckoutSdk::Payments::GooglePayClient]
   class CheckoutApi
     attr_reader :customers,
                 :disputes,
@@ -56,6 +84,7 @@ module CheckoutSdk
                 :links,
                 :payments,
                 :payments_setups,
+                :flow,
                 :reports,
                 :sessions,
                 :tokens,
@@ -70,7 +99,20 @@ module CheckoutSdk
                 :issuing,
                 :contexts,
                 :payment_sessions,
-                :forward
+                :forward,
+                :onboarding_simulator,
+                :agentic_commerce,
+                :compliance_requests,
+                :standalone_account_updater,
+                :network_tokens,
+                :payment_methods,
+                :applicants,
+                :aml_screening,
+                :id_document_verification,
+                :identity_verification,
+                :face_authentication,
+                :apple_pay,
+                :google_pay
 
     # @param [CheckoutConfiguration] configuration
     def initialize(configuration)
@@ -97,7 +139,25 @@ module CheckoutSdk
       @contexts = CheckoutSdk::Payments::PaymentContextsClient.new api_client, configuration
       @payment_sessions = CheckoutSdk::Payments::PaymentSessionsClient.new api_client, configuration
       @payments_setups = CheckoutSdk::Payments::PaymentSetupsClient.new api_client, configuration
+      @flow = CheckoutSdk::Payments::FlowClient.new api_client, configuration
       @forward = CheckoutSdk::Forward::ForwardClient.new(api_client, configuration)
+      @onboarding_simulator = CheckoutSdk::OnboardingSimulator::OnboardingSimulatorClient.new(api_client, configuration)
+      @agentic_commerce = CheckoutSdk::AgenticCommerce::AgenticCommerceClient.new(api_client, configuration)
+      @compliance_requests = CheckoutSdk::ComplianceRequests::ComplianceRequestsClient.new(api_client, configuration)
+      @standalone_account_updater =
+        CheckoutSdk::StandaloneAccountUpdater::StandaloneAccountUpdaterClient.new(api_client, configuration)
+      @network_tokens = CheckoutSdk::NetworkTokens::NetworkTokensClient.new(api_client, configuration)
+      @payment_methods = CheckoutSdk::PaymentMethods::PaymentMethodsClient.new(api_client, configuration)
+      @applicants = CheckoutSdk::Identities::Applicants::ApplicantsClient.new(api_client, configuration)
+      @aml_screening = CheckoutSdk::Identities::AmlScreening::AmlScreeningClient.new(api_client, configuration)
+      @id_document_verification =
+        CheckoutSdk::Identities::IdDocumentVerification::IdDocumentVerificationClient.new(api_client, configuration)
+      @identity_verification =
+        CheckoutSdk::Identities::IdentityVerification::IdentityVerificationClient.new(api_client, configuration)
+      @face_authentication =
+        CheckoutSdk::Identities::FaceAuthentication::FaceAuthenticationClient.new(api_client, configuration)
+      @apple_pay = CheckoutSdk::Payments::ApplePayClient.new(api_client, configuration)
+      @google_pay = CheckoutSdk::Payments::GooglePayClient.new(api_client, configuration)
     end
 
     private

data/lib/checkout_sdk/common/common.rb

@@ -29,3 +29,4 @@ require 'checkout_sdk/common/account_type_card_product_type'
 require 'checkout_sdk/common/cardholder_account_age_indicator_type'
 require 'checkout_sdk/common/customer_retry'
 require 'checkout_sdk/common/destination'
+require 'checkout_sdk/common/headers'

data/lib/checkout_sdk/common/headers.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Common
+    # Optional HTTP headers that callers can pass to a client method, mirroring
+    # the SDK's `Headers` pattern. Currently exposes `If-Match` (required
+    # by endpoints with optimistic-concurrency semantics, e.g. update reserve
+    # rule); future shared headers can be added here.
+    #
+    # @!attribute if_match
+    #   @return [String] ETag value to forward as the `If-Match` HTTP header.
+    class Headers
+      attr_accessor :if_match
+    end
+  end
+end

data/lib/checkout_sdk/common/payment_source_type.rb

@@ -44,6 +44,7 @@ module CheckoutSdk
       TNG = 'tng'
       AFTERPAY = 'afterpay'
       BENEFIT = 'benefit'
+      BLIK = 'blik'
       MBWAY = 'mbway'
       POSTFINANCE = 'postfinance'
       STCPAY = 'stcpay'

data/lib/checkout_sdk/compliance_requests/compliance_request_responded_field.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module ComplianceRequests
+    # A single responded field for a compliance request. Matches swagger
+    # `ComplianceRequestRespondedField`.
+    #
+    # @!attribute name
+    #   @return [String] The field name (e.g. "date_of_birth").
+    # @!attribute value
+    #   The value provided for the field. Intentionally untyped per swagger
+    #   (no `type` declaration, `nullable: true`), so the only valid Ruby
+    #   annotation is `Object`. Concrete shape depends on the field being
+    #   responded to (e.g. a date string for `date_of_birth`).
+    #   @return [Object]
+    # @!attribute not_available
+    #   @return [Boolean] Whether the value is unavailable for this field.
+    class ComplianceRequestRespondedField
+      attr_accessor :name, :value, :not_available
+    end
+  end
+end

data/lib/checkout_sdk/compliance_requests/compliance_request_responded_fields.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module ComplianceRequests
+    # Groups responded fields by party (sender/recipient).
+    #
+    # @!attribute sender
+    #   @return [Array<ComplianceRequestRespondedField>]
+    # @!attribute recipient
+    #   @return [Array<ComplianceRequestRespondedField>]
+    class ComplianceRequestRespondedFields
+      attr_accessor :sender, :recipient
+    end
+  end
+end

data/lib/checkout_sdk/compliance_requests/compliance_requests.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'checkout_sdk/compliance_requests/compliance_request_responded_field'
+require 'checkout_sdk/compliance_requests/compliance_request_responded_fields'
+require 'checkout_sdk/compliance_requests/compliance_response_request'
+require 'checkout_sdk/compliance_requests/compliance_requests_client'

data/lib/checkout_sdk/compliance_requests/compliance_requests_client.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module ComplianceRequests
+    # Client for the Compliance Requests API.
+    class ComplianceRequestsClient < Client
+      COMPLIANCE_REQUESTS = 'compliance-requests'
+      private_constant :COMPLIANCE_REQUESTS
+
+      # @param [ApiClient] api_client
+      # @param [CheckoutConfiguration] configuration
+      def initialize(api_client, configuration)
+        super(api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY_OR_OAUTH)
+      end
+
+      # Retrieve an existing compliance request by payment ID.
+      # @param [String] payment_id
+      def get_compliance_request(payment_id)
+        api_client.invoke_get(build_path(COMPLIANCE_REQUESTS, payment_id), sdk_authorization)
+      end
+
+      # Respond to a compliance request.
+      # @param [String] payment_id
+      # @param [Hash, ComplianceResponseRequest] compliance_response_request
+      def respond_to_compliance_request(payment_id, compliance_response_request)
+        api_client.invoke_post(
+          build_path(COMPLIANCE_REQUESTS, payment_id),
+          sdk_authorization,
+          compliance_response_request
+        )
+      end
+    end
+  end
+end

data/lib/checkout_sdk/compliance_requests/compliance_response_request.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module ComplianceRequests
+    # Request body for POST /compliance-requests/{payment_id}.
+    # Used to respond to a compliance information request raised against a payment.
+    #
+    # @!attribute fields
+    #   @return [ComplianceRequestRespondedFields]
+    # @!attribute comments
+    #   @return [String] Optional free-text comment.
+    class ComplianceResponseRequest
+      attr_accessor :fields, :comments
+    end
+  end
+end

data/lib/checkout_sdk/disputes/dispute_status.rb

@@ -13,6 +13,7 @@ module CheckoutSdk
       ARBITRATION_LOST = 'arbitration_lost'
       EVIDENCE_REQUIRED = 'evidence_required'
       EVIDENCE_UNDER_REVIEW = 'evidence_under_review'
+      ARB_EVIDENCE_SUBMITTED = 'arb_evidence_submitted'
       ARBITRATION_UNDER_REVIEW = 'arbitration_under_review'
     end
   end

data/lib/checkout_sdk/disputes/disputes_client.rb

@@ -9,7 +9,8 @@ module CheckoutSdk
       EVIDENCE = 'evidence'
       SUBMITTED = 'submitted'
       SCHEME_FILES = 'schemefiles'
-      private_constant :DISPUTES, :FILES, :ACCEPT, :EVIDENCE, :SCHEME_FILES
+      ARBITRATION = 'arbitration'
+      private_constant :DISPUTES, :FILES, :ACCEPT, :EVIDENCE, :SCHEME_FILES, :ARBITRATION
 
       # @param [ApiClient] api_client
       # @param [CheckoutConfiguration] configuration
@@ -67,6 +68,26 @@ module CheckoutSdk
       def get_file_details(file_id)
         api_client.invoke_get(build_path(FILES, file_id), sdk_authorization)
       end
+
+      # Submit arbitration evidence on a dispute.
+      # @param [String] dispute_id
+      # @param [Hash, DisputeArbitrationRequest] arbitration_request
+      def submit_arbitration(dispute_id, arbitration_request = nil)
+        api_client.invoke_post(
+          build_path(DISPUTES, dispute_id, EVIDENCE, ARBITRATION),
+          sdk_authorization,
+          arbitration_request
+        )
+      end
+
+      # Retrieve submitted arbitration evidence.
+      # @param [String] dispute_id
+      def get_submitted_arbitration_evidence(dispute_id)
+        api_client.invoke_get(
+          build_path(DISPUTES, dispute_id, EVIDENCE, ARBITRATION, SUBMITTED),
+          sdk_authorization
+        )
+      end
     end
   end
 end

data/lib/checkout_sdk/disputes/disputes_query_filter.rb

@@ -3,27 +3,63 @@
 module CheckoutSdk
   module Disputes
     # @!attribute limit
-    #   @return [Integer]
+    #   The number of results to return.
+    #   [Optional]
+    #   min 1, max 250, default 50
+    #   @return [Integer, nil]
     # @!attribute skip
-    #   @return [Integer]
+    #   The number of results to skip.
+    #   [Optional]
+    #   min 0, default 0
+    #   @return [Integer, nil]
     # @!attribute id
-    #   @return [String]
+    #   The unique identifier of the dispute.
+    #   [Optional]
+    #   @return [String, nil]
     # @!attribute statuses
-    #   @return [String] {DisputeStatus}
+    #   One or more comma-separated statuses to filter by. Works like a logical OR.
+    #   [Optional]
+    #   Example: "evidence_required,evidence_under_review"
+    #   @return [String, nil]
     # @!attribute payment_id
-    #   @return [String]
+    #   The unique identifier of the payment.
+    #   [Optional]
+    #   @return [String, nil]
     # @!attribute payment_reference
-    #   @return [String]
+    #   An optional reference (such as an order ID) that identifies the payment.
+    #   [Optional]
+    #   @return [String, nil]
     # @!attribute payment_arn
-    #   @return [String]
+    #   The acquirer reference number (ARN).
+    #   [Optional]
+    #   @return [String, nil]
     # @!attribute this_channel_only
-    #   @return [TrueClass, FalseClass]
+    #   If true, only returns disputes for the channel associated with the secret key.
+    #   [Optional]
+    #   @return [TrueClass, FalseClass, nil]
     # @!attribute entity_ids
-    #   @return [String] - Not available on Previous.
+    #   One or more comma-separated client entity IDs. Works like a logical OR.
+    #   [Optional]
+    #   Example: "ent_wxglze3wwywujg4nna5fb7ldli,ent_vkb5zcy64zoe3cwfmaqvqyqyku"
+    #   @return [String, nil]
     # @!attribute sub_entity_ids
-    #   @return [String] - Not available on Previous.
+    #   One or more comma-separated sub-entity IDs. Works like a logical OR.
+    #   [Optional]
+    #   Example: "ent_uzm3uxtssvmuxnyrfdffcyjxeu,ent_hy5wtzwzeuwefmsnjtdhw4scfi"
+    #   @return [String, nil]
+    # @!attribute processing_channel_ids
+    #   One or more comma-separated processing channel IDs. Works like a logical OR.
+    #   [Optional]
+    #   Example: "pc_uzm3uxtssvmuxnyrfdffcyjxeu,pc_hy5wtzwzeuwefmsnjtdhw4scfi"
+    #   @return [String, nil]
+    # @!attribute segment_ids
+    #   One or more comma-separated segment IDs. Works like a logical OR.
+    #   [Optional]
+    #   @return [String, nil]
     # @!attribute payment_mcc
-    #   @return [String] - Not available on Previous.
+    #   The merchant category code (MCC) of the payment (ISO 18245).
+    #   [Optional]
+    #   @return [String, nil]
     class DisputesQueryFilter < CheckoutSdk::Common::DateRangeQueryFilter
       attr_accessor :limit,
                     :skip,
@@ -35,6 +71,8 @@ module CheckoutSdk
                     :this_channel_only,
                     :entity_ids,
                     :sub_entity_ids,
+                    :processing_channel_ids,
+                    :segment_ids,
                     :payment_mcc
     end
   end

data/lib/checkout_sdk/forward/create_secret_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Forward
+    # Request body for POST /forward/secrets.
+    #
+    # @!attribute name
+    #   @return [String] Secret name (1-64 alphanumeric chars).
+    # @!attribute value
+    #   @return [String] Plaintext secret value (max 8KB).
+    # @!attribute entity_id
+    #   @return [String] Optional entity scope.
+    class CreateSecretRequest
+      attr_accessor :name, :value, :entity_id
+    end
+  end
+end

data/lib/checkout_sdk/forward/forward.rb

@@ -1,3 +1,5 @@
 # frozen_string_literal: true
 
+require 'checkout_sdk/forward/create_secret_request'
+require 'checkout_sdk/forward/update_secret_request'
 require 'checkout_sdk/forward/forward_client'

data/lib/checkout_sdk/forward/forward_client.rb

@@ -4,7 +4,8 @@ module CheckoutSdk
   module Forward
     class ForwardClient < Client
       FORWARD = 'forward'
-      private_constant :FORWARD
+      SECRETS = 'secrets'
+      private_constant :FORWARD, :SECRETS
 
       # @param [ApiClient] api_client
       # @param [CheckoutConfiguration] configuration
@@ -21,6 +22,31 @@ module CheckoutSdk
       def get(forward_id)
         api_client.invoke_get(build_path(FORWARD, forward_id), sdk_authorization)
       end
+
+      # @param [Hash, CreateSecretRequest] create_secret_request
+      def create_secret(create_secret_request)
+        api_client.invoke_post(build_path(FORWARD, SECRETS),
+                               sdk_authorization,
+                               create_secret_request)
+      end
+
+      def get_secrets
+        api_client.invoke_get(build_path(FORWARD, 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),
+                                sdk_authorization,
+                                update_secret_request)
+      end
+
+      # @param [String] name
+      def delete_secret(name)
+        api_client.invoke_delete(build_path(FORWARD, SECRETS, name),
+                                 sdk_authorization)
+      end
     end
   end
 end

data/lib/checkout_sdk/forward/update_secret_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Forward
+    # Request body for PATCH /forward/secrets/{name}.
+    #
+    # @!attribute value
+    #   @return [String] New plaintext secret value (max 8KB).
+    # @!attribute entity_id
+    #   @return [String] Update the entity scope.
+    class UpdateSecretRequest
+      attr_accessor :value, :entity_id
+    end
+  end
+end

data/lib/checkout_sdk/identities/aml_screening/aml_screening_client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Identities
+    module AmlScreening
+      # Client for the Identities — AML Screening API.
+      class AmlScreeningClient < Client
+        AML_VERIFICATIONS = 'aml-verifications'
+        private_constant :AML_VERIFICATIONS
+
+        # @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, AmlVerificationRequest] aml_verification_request
+        def create_aml_verification(aml_verification_request)
+          api_client.invoke_post(AML_VERIFICATIONS, sdk_authorization, aml_verification_request)
+        end
+
+        # @param [String] aml_verification_id
+        def get_aml_verification(aml_verification_id)
+          api_client.invoke_get(build_path(AML_VERIFICATIONS, aml_verification_id), sdk_authorization)
+        end
+      end
+    end
+  end
+end