onlinepayments-sdk-ruby 4.23.0 → 5.0.0

data/lib/onlinepayments/sdk/domain/uploadable_file.rb

@@ -0,0 +1,33 @@
+module OnlinePayments
+  module SDK
+    module Domain
+      # A file that can be uploaded
+      #
+      # The allowed forms of content are defined by the Connection implementation
+      # The default implementation supports file paths and IO objects.
+      #
+      # @attr_reader [String] file_name       The name of the file.
+      # @attr_reader [String, IO] content     The file's content.
+      # @attr_reader [String] content_type    The file's content type.
+      # @attr_reader [Integer] content_length The file's content length, or -1 if not known.
+      class UploadableFile
+
+        def initialize(file_name, content, content_type, content_length = -1)
+          raise ArgumentError.new("file_name is required") if file_name.nil? or !file_name.strip
+          raise ArgumentError.new("content is required") if content.nil?
+          raise ArgumentError.new("content_type is required") if content_type.nil? or !content_type.strip
+
+          @file_name = file_name
+          @content = content
+          @content_type = content_type
+          @content_length = [content_length, -1].max
+        end
+
+        attr_reader :file_name
+        attr_reader :content
+        attr_reader :content_type
+        attr_reader :content_length
+      end
+    end
+  end
+end

data/lib/onlinepayments/sdk/domain/validate_credentials_request.rb

@@ -0,0 +1,37 @@
+#
+# This file was automatically generated.
+#
+require 'onlinepayments/sdk/domain/data_object'
+
+module OnlinePayments
+  module SDK
+    module Domain
+      # @attr [String] key
+      # @attr [String] secret
+      class ValidateCredentialsRequest < OnlinePayments::SDK::Domain::DataObject
+
+        attr_accessor :key
+
+        attr_accessor :secret
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['key'] = @key unless @key.nil?
+          hash['secret'] = @secret unless @secret.nil?
+          hash
+        end
+
+        def from_hash(hash)
+          super
+          if hash.has_key? 'key'
+            @key = hash['key']
+          end
+          if hash.has_key? 'secret'
+            @secret = hash['secret']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/onlinepayments/sdk/domain/validate_credentials_response.rb

@@ -0,0 +1,30 @@
+#
+# This file was automatically generated.
+#
+require 'onlinepayments/sdk/domain/data_object'
+
+module OnlinePayments
+  module SDK
+    module Domain
+      # @attr [String] result
+      class ValidateCredentialsResponse < OnlinePayments::SDK::Domain::DataObject
+
+        attr_accessor :result
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['result'] = @result unless @result.nil?
+          hash
+        end
+
+        def from_hash(hash)
+          super
+          if hash.has_key? 'result'
+            @result = hash['result']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/onlinepayments/sdk/domain/value_mapping_element.rb

@@ -1,36 +1,41 @@
 #
-# This class was auto-generated.
+# This file was automatically generated.
 #
-require 'onlinepayments/sdk/data_object'
+require 'onlinepayments/sdk/domain/data_object'
 require 'onlinepayments/sdk/domain/payment_product_field_display_element'
 
-module OnlinePayments::SDK
-  module Domain
+module OnlinePayments
+  module SDK
+    module Domain
+      # @attr [Array<OnlinePayments::SDK::Domain::PaymentProductFieldDisplayElement>] display_elements
+      # @attr [String] value
+      class ValueMappingElement < OnlinePayments::SDK::Domain::DataObject
 
-    # @attr [Array<OnlinePayments::SDK::Domain::PaymentProductFieldDisplayElement>] display_elements
-    # @attr [String] value
-    class ValueMappingElement < OnlinePayments::SDK::DataObject
-      attr_accessor :display_elements
-      attr_accessor :value
+        attr_accessor :display_elements
 
-      # @return (Hash)
-      def to_h
-        hash = super
-        hash['displayElements'] = @display_elements.collect(&:to_h) if @display_elements
-        hash['value'] = @value unless @value.nil?
-        hash
-      end
+        attr_accessor :value
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['displayElements'] = @display_elements.collect{|val| val.to_h} unless @display_elements.nil?
+          hash['value'] = @value unless @value.nil?
+          hash
+        end
 
-      def from_hash(hash)
-        super
-        if hash.key? 'displayElements'
-          raise TypeError, "value '%s' is not an Array" % [hash['displayElements']] unless hash['displayElements'].is_a? Array
-          @display_elements = []
-          hash['displayElements'].each do |e|
-            @display_elements << OnlinePayments::SDK::Domain::PaymentProductFieldDisplayElement.new_from_hash(e)
+        def from_hash(hash)
+          super
+          if hash.has_key? 'displayElements'
+            raise TypeError, "value '%s' is not an Array" % [hash['displayElements']] unless hash['displayElements'].is_a? Array
+            @display_elements = []
+            hash['displayElements'].each do |e|
+              @display_elements << OnlinePayments::SDK::Domain::PaymentProductFieldDisplayElement.new_from_hash(e)
+            end
+          end
+          if hash.has_key? 'value'
+            @value = hash['value']
           end
         end
-        @value = hash['value'] if hash.key? 'value'
       end
     end
   end

data/lib/onlinepayments/sdk/domain.rb

@@ -0,0 +1,4 @@
+#
+# This file was automatically generated.
+#
+Dir[File.join(__dir__, 'domain', '*.rb')].each { |f| require f }

data/lib/onlinepayments/sdk/exception_factory.rb

@@ -0,0 +1,76 @@
+#
+# This file was automatically generated.
+#
+require_relative 'api_exception'
+require_relative 'authorization_exception'
+require_relative 'declined_payment_exception'
+require_relative 'declined_payout_exception'
+require_relative 'declined_refund_exception'
+require_relative 'idempotence_exception'
+require_relative 'platform_exception'
+require_relative 'reference_exception'
+require_relative 'validation_exception'
+
+require 'onlinepayments/sdk/domain/error_response'
+require 'onlinepayments/sdk/domain/payment_error_response'
+require 'onlinepayments/sdk/domain/payout_error_response'
+require 'onlinepayments/sdk/domain/refund_error_response'
+
+module OnlinePayments
+  module SDK
+    def self.create_exception(status_code, response_body, error_object, context)
+      if error_object.is_a?(OnlinePayments::SDK::Domain::PaymentErrorResponse)
+        return DeclinedPaymentException.new(status_code, response_body, error_object) unless error_object.payment_result.nil?
+        return create_exception_from_response_fields(status_code, response_body, error_object.error_id, error_object.errors, context)
+      end
+      if error_object.is_a?(OnlinePayments::SDK::Domain::PayoutErrorResponse)
+        return DeclinedPayoutException.new(status_code, response_body, error_object) unless error_object.payout_result.nil?
+        return create_exception_from_response_fields(status_code, response_body, error_object.error_id, error_object.errors, context)
+      end
+      if error_object.is_a?(OnlinePayments::SDK::Domain::RefundErrorResponse)
+        return DeclinedRefundException.new(status_code, response_body, error_object) unless error_object.refund_result.nil?
+        return create_exception_from_response_fields(status_code, response_body, error_object.error_id, error_object.errors, context)
+      end
+      raise ArgumentError.new("unsupported error object type: " + error_object.class.name) unless error_object.is_a?(OnlinePayments::SDK::Domain::ErrorResponse)
+      create_exception_from_response_fields(status_code, response_body, error_object.error_id, error_object.errors, context)
+    end
+
+    private
+
+    def self.create_exception_from_response_fields(status_code, response_body, error_id, errors, context)
+      case status_code
+        when 400
+          return ValidationException.new(status_code, response_body, error_id, errors)
+        when 403
+          return AuthorizationException.new(status_code, response_body, error_id, errors)
+        when 404
+          return ReferenceException.new(status_code, response_body, error_id, errors)
+        when 409
+          if is_idempotence_error(errors, context)
+            idempotence_key = context.idempotence_key
+            idempotence_request_timestamp = context.idempotence_request_timestamp
+            return IdempotenceException.new(status_code, response_body, error_id, errors,
+                                            idempotence_key, idempotence_request_timestamp)
+          else
+            return ReferenceException.new(status_code, response_body, error_id, errors)
+          end
+        when 410
+          return ReferenceException.new(status_code, response_body, error_id, errors)
+        when 500
+          return PlatformException.new(status_code, response_body, error_id, errors)
+        when 502
+          return PlatformException.new(status_code, response_body, error_id, errors)
+        when 503
+          return PlatformException.new(status_code, response_body, error_id, errors)
+        else
+          return ApiException.new(status_code, response_body, error_id, errors)
+      end
+    end
+
+    def self.is_idempotence_error(errors, context)
+      !context&.idempotence_key.nil? &&
+        errors&.length == 1 &&
+            errors[0]&.error_code == '1409'
+    end
+  end
+end

data/lib/onlinepayments/sdk/factory.rb

@@ -1,135 +1,180 @@
 require 'yaml'
+require 'onlinepayments/sdk/client'
+require 'onlinepayments/sdk/communicator'
+require 'onlinepayments/sdk/communicator_configuration'
+require 'onlinepayments/sdk/authentication/authorization_type'
+require 'onlinepayments/sdk/authentication/v1hmac_authenticator'
+require 'onlinepayments/sdk/communication/default_connection'
+require 'onlinepayments/sdk/communication/metadata_provider'
+require 'onlinepayments/sdk/json/default_marshaller'
 
-module OnlinePayments::SDK
+module OnlinePayments
+  module SDK
+    # Convenience class that constructs instances of several other classes in the SDK.
+    # Provides methods to construct
+    # {OnlinePayments::SDK::CommunicatorConfiguration}, {OnlinePayments::SDK::Communicator} and {OnlinePayments::SDK::Client} instances.
+    class Factory
 
-  # Convenience class that constructs instances of several other classes in the SDK.
-  # Provides methods to construct
-  # {OnlinePayments::SDK::CommunicatorConfiguration}, {OnlinePayments::SDK::Communicator} and {OnlinePayments::SDK::Client} instances.
-  class Factory
+      # Creates and returns a {OnlinePayments::SDK::CommunicatorConfiguration} based on the configuration in the file
+      # located at _configuration_file_name_.
+      #
+      # @param configuration_file_name [String] Path to the configuration file to use, should be in YAML format.
+      # @param api_key_id              [String] Key id for the Online Payments platform.
+      # @param secret_api_key          [String] Secret key used for authentication to the Online Payments platform.
+      # @return [OnlinePayments::SDK::CommunicatorConfiguration] The created communicator configuration
+      def self.create_configuration(configuration_file_name, api_key_id, secret_api_key)
+        properties = YAML::load_file(configuration_file_name)
+        CommunicatorConfiguration.new(properties: properties,
+                                      api_key_id: api_key_id,
+                                      secret_api_key: secret_api_key)
+      end
 
-    # Creates and returns a {OnlinePayments::SDK::CommunicatorConfiguration} based on the configuration in the file located at _configuration_file_name_.
-    #
-    # @param config_file_name [String] Path to the configuration file to use, should be in YAML format.
-    # @param api_key_id       [String] Key id for the OnlinePayments service.
-    # @param secret_api_key   [String] Secret key used for authentication to the OnlinePayments service.
-    # @return [OnlinePayments::SDK::CommunicatorConfiguration] The created communicator configuration
-    def self.create_configuration(config_file_name, api_key_id, secret_api_key)
-      properties = YAML::load_file(config_file_name)
-      CommunicatorConfiguration.new(properties: properties,
-                                    api_key_id: api_key_id,
-                                    secret_api_key: secret_api_key)
-    end
+      # Creates and returns a {OnlinePayments::SDK::Communicator} from a {OnlinePayments::SDK::CommunicatorConfiguration},
+      # a {OnlinePayments::SDK::Communication::MetadataProvider}, a {OnlinePayments::SDK::Communication::Connection},
+      # an {OnlinePayments::SDK::Authentication::Authenticator} and a {OnlinePayments::SDK::JSON::Marshaller}.
+      #
+      # @param configuration     [OnlinePayments::SDK::CommunicatorConfiguration] configuration settings to be used by the client.
+      # @param metadata_provider [OnlinePayments::SDK::Communication::MetadataProvider] stores the metadata for the communicating client.
+      # @param connection        [OnlinePayments::SDK::Communication::Connection] connection that can be used to communicate with the Online Payments platform.
+      # @param authenticator     [OnlinePayments::SDK::Authentication::Authenticator] authenticator that can authenticate messages sent to the Online Payments platform.
+      # @param marshaller        [OnlinePayments::SDK::JSON::Marshaller] marshaller that can marshal and unmarshal objects to and from JSON.
+      # @return [OnlinePayments::SDK::Communicator] The created communicator
+      def self.create_communicator_from_configuration(configuration, metadata_provider: nil,
+                                                      connection: nil, authenticator: nil, marshaller: nil)
+        unless metadata_provider
+          metadata_provider = Communication::MetadataProvider.new(configuration.integrator,
+                                                    shopping_cart_extension: configuration.shopping_cart_extension)
+        end
+        unless connection
+          connection = Communication::DefaultConnection.new({ connect_timeout: configuration.connect_timeout,
+                                                              socket_timeout: configuration.socket_timeout,
+                                                              max_connections: configuration.max_connections,
+                                                              proxy_configuration: configuration.proxy_configuration })
+        end
+        unless authenticator
+          authenticator = get_authenticator(configuration)
+        end
+        unless marshaller
+          marshaller = JSON::DefaultMarshaller.instance
+        end
+        Communicator.new(configuration.api_endpoint, connection, authenticator, metadata_provider, marshaller)
+      end
 
-    # Creates and returns an {OnlinePayments::SDK::Communicator} that can be used for communication with the OnlinePayments service.
-    #
-    # @param configuration      [OnlinePayments::SDK::CommunicatorConfiguration] contains configuration settings to be used by the client.
-    # @param meta_data_provider [OnlinePayments::SDK::MetaDataProvider,nil] stores the metadata for the communicating client.
-    # @param connection         [OnlinePayments::SDK::Connection,nil] connection that can be used to communicate with the Online Payments platform.
-    # @param authenticator      [OnlinePayments::SDK::Authenticator,nil] authenticator that can authenticate messages sent to the Online Payments platform.
-    # @param marshaller         [OnlinePayments::SDK::Marshaller,nil] marshaller that marshalls and unmarshalls messages sent to the Online Payments platform.
-    # @return [OnlinePayments::SDK::Communicator] The created communicator
-    def self.create_communicator_from_configuration(configuration, meta_data_provider: nil, connection: nil, authenticator: nil, marshaller: DefaultImpl::DefaultMarshaller.INSTANCE)
-      meta_data_provider ||= MetaDataProvider.new(configuration.integrator, shopping_cart_extension: configuration.shopping_cart_extension)
-      connection ||= DefaultImpl::DefaultConnection.new({ connect_timeout: configuration.connect_timeout,
-                                                          socket_timeout: configuration.socket_timeout,
-                                                          max_connections: configuration.max_connections,
-                                                          proxy_configuration: configuration.proxy_configuration })
-      authenticator ||= DefaultImpl::DefaultAuthenticator.new(configuration.api_key_id,
-                                                              configuration.secret_api_key,
-                                                              configuration.authorization_type)
-      Communicator.new(configuration.api_endpoint, connection, authenticator, meta_data_provider, marshaller)
-    end
+      # Creates and returns a {OnlinePayments::SDK::Communicator} from a file containing the communicator configuration, api_key_id, secret_api_key,
+      # a {OnlinePayments::SDK::Communication::MetadataProvider}, a {OnlinePayments::SDK::Communication::Connection}.
+      # an {OnlinePayments::SDK::Authentication::Authenticator} and a {OnlinePayments::SDK::JSON::Marshaller}.
+      #
+      # @param configuration_file_name [String] Path to the configuration file to use, should be in YAML format.
+      # @param api_key_id              [String] Key id for the Online Payments platform.
+      # @param secret_api_key          [String] Secret key used for authentication to the Online Payments platform.
+      # @param metadata_provider       [OnlinePayments::SDK::Communication::MetadataProvider] stores the metadata for the communicating client.
+      # @param connection              [OnlinePayments::SDK::Communication::Connection] connection that can be used to communicate with the Online Payments platform.
+      # @param authenticator           [OnlinePayments::SDK::Authentication::Authenticator] authenticator that can authenticate messages sent to the Online Payments platform.
+      # @param marshaller              [OnlinePayments::SDK::JSON::Marshaller] marshaller that can marshal and unmarshal objects to and from JSON.
+      # @return [OnlinePayments::SDK::Communicator] The created communicator
+      def self.create_communicator_from_file(configuration_file_name, api_key_id, secret_api_key,
+                                             metadata_provider: nil, connection: nil, authenticator: nil, marshaller: nil)
+        configuration = create_configuration(configuration_file_name, api_key_id, secret_api_key)
+        create_communicator_from_configuration(configuration, metadata_provider: metadata_provider, connection: connection,
+                                               authenticator: authenticator, marshaller: marshaller)
+      end
 
-    # Creates and returns an {OnlinePayments::SDK::Communicator} that is used for communication with the OnlinePayments service.
-    #
-    # @param config_file_name   [String] Path to the configuration file to use, should be in YAML format.
-    # @param api_key_id         [String] Key id for the OnlinePayments service.
-    # @param secret_api_key     [String] Secret key used for authentication to the OnlinePayments service.
-    # @param meta_data_provider [OnlinePayments::SDK::MetaDataProvider,nil] stores the metadata for the communicating client.
-    # @param connection         [OnlinePayments::SDK::Connection,nil] connection that can be used to communicate with the Online Payments platform.
-    # @param authenticator      [OnlinePayments::SDK::Authenticator,nil] authenticator that can authenticate messages sent to the Online Payments platform.
-    # @return [OnlinePayments::SDK::Communicator] The created communicator
-    def self.create_communicator_from_file(config_file_name, api_key_id, secret_api_key,
-                                           meta_data_provider: nil, connection: nil, authenticator: nil,
-                                           marshaller: DefaultImpl::DefaultMarshaller.INSTANCE)
-      configuration = create_configuration(config_file_name, api_key_id, secret_api_key)
-      create_communicator_from_configuration(configuration, meta_data_provider: meta_data_provider, connection: connection,
-                                             authenticator: authenticator, marshaller: marshaller)
-    end
+      # Creates and returns an {OnlinePayments::SDK::Client} that provides the a high-level interface with the Online Payments platform.
+      # If a code block is given, the created client is returned to the code block and closed afterwards.
+      #
+      # @example Providing a code block
+      #           Factory.create_client_from_configuration(configuration) do |client|
+      #             # use client as needed
+      #           end
+      #           # client is closed here
+      #
+      # @param configuration     [OnlinePayments::SDK::CommunicatorConfiguration] contains configuration settings to be used by the client.
+      # @param metadata_provider [OnlinePayments::SDK::Communication::MetadataProvider] stores the metadata for the communicating client.
+      # @param connection        [OnlinePayments::SDK::Communication::Connection] connection that can be used to communicate with the Online Payments platform.
+      # @param authenticator     [OnlinePayments::SDK::Authentication::Authenticator] authenticator that can authenticate messages sent to the Online Payments platform.
+      # @param marshaller        [OnlinePayments::SDK::JSON::Marshaller] marshaller that can marshal and unmarshal objects to and from JSON.
+      # @return [OnlinePayments::SDK::Client] The created client
+      def self.create_client_from_configuration(configuration, metadata_provider: nil, connection: nil, authenticator: nil, marshaller: nil)
+        communicator = create_communicator_from_configuration(configuration, metadata_provider: metadata_provider, connection: connection,
+                                                              authenticator: authenticator, marshaller: marshaller)
+        client = Client.new(communicator)
+        if block_given?
+          begin
+            yield client
+          ensure
+            client.close
+          end
+        else
+          return client
+        end
+      end
 
-    # Creates and returns an {OnlinePayments::SDK::Client} that provides the a high-level interface with the OnlinePayments service.
-    # If a code block is given, the created client is returned to the code block and closed afterwards.
-    #
-    # @example Providing a code block
-    #           Factory.create_client_from_configuration(configuration) do |client|
-    #             client.merchant(merchant_id).services.testconnection
-    #           end
-    #           # client is closed here
-    #
-    # @param configuration [OnlinePayments::SDK::CommunicatorConfiguration] contains configuration settings to be used by the client.
-    # @return [OnlinePayments::SDK::Client] The created client
-    def self.create_client_from_configuration(configuration)
-      communicator = create_communicator_from_configuration(configuration)
-      client = Client.new(communicator)
-      if block_given?
-        begin
-          yield client
-        ensure
-          client.close
+      # Creates and returns an {OnlinePayments::SDK::Client} that provides the a high-level interface with the Online Payments platform.
+      # If a code block is given, the created client is returned to the code block and closed afterwards.
+      #
+      # @example Providing a code block
+      #           Factory.create_client_from_communicator(communicator) do |client|
+      #             # use client as needed
+      #           end
+      #           # client is closed here
+      #
+      # @param communicator [OnlinePayments::SDK::Communicator] provides network communication service for the Client
+      # @return [OnlinePayments::SDK::Client] The created client
+      def self.create_client_from_communicator(communicator)
+        client = Client.new(communicator)
+        if block_given?
+          begin
+            yield client
+          ensure
+            client.close
+          end
+        else
+          return client
         end
-      else
-        return client
       end
-    end
 
-    # Creates and returns an {OnlinePayments::SDK::Client} that provides the a high-level interface with the OnlinePayments service.
-    # If a code block is given, the created client is returned to the code block and closed afterwards.
-    #
-    # @example Providing a code block
-    #           Factory.create_client_from_communicator(communicator) do |client|
-    #             client.merchant(merchant_id).services.testconnection
-    #           end
-    #           # client is closed here
-    #
-    # @param communicator [OnlinePayments::SDK::Communicator] provides network communication service for the Client
-    # @return [OnlinePayments::SDK::Client] The created client
-    def self.create_client_from_communicator(communicator)
-      client = Client.new(communicator)
-      if block_given?
-        begin
-          yield client
-        ensure
-          client.close
+      # Creates and returns an {OnlinePayments::SDK::Client} that provides the a high-level interface with the Online Payments platform.
+      # If a code block is given, the created client is returned to the code block and closed afterwards.
+      #
+      # @example Providing a code block
+      #           Factory.create_client_from_file(configuration_file_name, api_key_id, secret_api_key) do |client|
+      #             # use client as needed
+      #           end
+      #           # client is closed here
+      #
+      # @param configuration_file_name [String] Path to the configuration file to use, should be in YAML format.
+      # @param api_key_id              [String] Key id for the Online Payments platform.
+      # @param secret_api_key          [String] Secret key used for authentication to the Online Payments platform.
+      # @param metadata_provider       [OnlinePayments::SDK::Communication::MetadataProvider] stores the metadata for the communicating client.
+      # @param connection              [OnlinePayments::SDK::Communication::Connection] connection that can be used to communicate with the Online Payments platform.
+      # @param authenticator           [OnlinePayments::SDK::Authentication::Authenticator] authenticator that can authenticate messages sent to the Online Payments platform.
+      # @param marshaller              [OnlinePayments::SDK::JSON::Marshaller] marshaller that can marshal and unmarshal objects to and from JSON.
+      # @return [OnlinePayments::SDK::Client] The created client
+      def self.create_client_from_file(configuration_file_name, api_key_id, secret_api_key,
+                                       metadata_provider: nil, connection: nil, authenticator: nil, marshaller: nil)
+        communicator = create_communicator_from_file(configuration_file_name, api_key_id, secret_api_key,
+                                                     metadata_provider: metadata_provider, connection: connection,
+                                                     authenticator: authenticator, marshaller: marshaller)
+        client = Client.new(communicator)
+        if block_given?
+          begin
+            yield client
+          ensure
+            client.close
+          end
+        else
+          return client
         end
-      else
-        return client
       end
-    end
 
-    # Creates and returns an {OnlinePayments::SDK::Client} that provides the a high-level interface with the OnlinePayments service.
-    # If a code block is given, the created client is returned to the code block and closed afterwards.
-    #
-    # @example Providing a code block
-    #           Factory.create_client_from_file(config_file_name, api_key_id, secret_api_key) do |client|
-    #             client.merchant(merchant_id).services.testconnection
-    #           end
-    #           # client is closed here
-    #
-    # @param config_file_name [String] Path to the configuration file to use, should be in YAML format.
-    # @param api_key_id       [String] Key id for the OnlinePayments service.
-    # @param secret_api_key   [String] Secret key used for authentication to the OnlinePayments service.
-    # @return [OnlinePayments::SDK::Client] The created client
-    def self.create_client_from_file(config_file_name, api_key_id, secret_api_key)
-      communicator = create_communicator_from_file(config_file_name, api_key_id, secret_api_key)
-      client = Client.new(communicator)
-      if block_given?
-        begin
-          yield client
-        ensure
-          client.close
+      private
+
+      # @param configuration [OnlinePayments::SDK::CommunicatorConfiguration]
+      def self.get_authenticator(configuration)
+        if configuration.authorization_type == Authentication::AuthorizationType::V1HMAC
+          return Authentication::V1HmacAuthenticator.new(configuration)
         end
-      else
-        return client
+        raise RuntimeError.new("Unknown authorizationType #{configuration.authorization_type}")
       end
     end
   end

data/lib/onlinepayments/sdk/idempotence_exception.rb

@@ -1,24 +1,28 @@
-module OnlinePayments::SDK
+#
+# This file was automatically generated.
+#
+require_relative 'api_exception'
 
-  # This exception is thrown when a response from the Online Payments platform indicates
-  # a request with the same _idempotence_key_ was received earlier.
-  # The _idempotence_request_timestamp_ indicates the time when the first request with this _idempotence_key_ arrived.
-  #
-  # @attr_reader [String] idempotence_key                The idempotence key used in the request.
-  # @attr_reader [Integer] idempotence_request_timestamp A timestamp indicating the arrival time of the request that conflicts with the request just sent.
-  class IdempotenceException < ApiException
+module OnlinePayments
+  module SDK
+    # Represents an error response from the payment platform when an idempotent request failed because the first request has not finished yet.
+    # The _idempotence_request_timestamp_ indicates the time when the first request with this _idempotence_key_ arrived.
+    #
+    # @attr_reader [String] idempotence_key                The idempotence key used in the request.
+    # @attr_reader [Integer] idempotence_request_timestamp A timestamp indicating the arrival time of the request that conflicts with the request just sent.
+    class IdempotenceException < ApiException
 
-    # Create a new IdempotenceException
-    # @see ApiException#initialize
-    def initialize(status_code, response_body, error_id, errors, idempotence_key,
-                   idempotence_request_timestamp,
-                   message = 'the Online Payments platform returned a duplicate request error response')
-      super(status_code, response_body, error_id, errors, message)
-      @idempotence_key = idempotence_key
-      @idempotence_request_timestamp = idempotence_request_timestamp
-    end
+      # Create a new IdempotenceException.
+      # @see ApiException#initialize
+      def initialize(status_code, response_body, error_id, errors, idempotence_key, idempotence_request_timestamp,
+                     message='the payment platform returned a duplicate request error response')
+        super(status_code, response_body, error_id, errors, message)
+        @idempotence_key = idempotence_key
+        @idempotence_request_timestamp = idempotence_request_timestamp
+      end
 
-    attr_reader :idempotence_key
-    attr_reader :idempotence_request_timestamp
+      attr_reader :idempotence_key
+      attr_reader :idempotence_request_timestamp
+    end
   end
 end

data/lib/onlinepayments/sdk/json/default_marshaller.rb

@@ -0,0 +1,34 @@
+require 'json'
+require 'singleton'
+require 'onlinepayments/sdk/json/marshaller'
+
+module OnlinePayments
+  module SDK
+    module JSON
+      # Marshals objects to and from JSON format.
+      # Currently supports marshalling and unmarshalling of classes that support class.new_from_hash and class#to_h
+      class DefaultMarshaller < Marshaller
+        include Singleton
+
+        # Marshals the _request_object_ to a JSON string using request_object#to_h
+        def marshal(request_object)
+          ::JSON.pretty_generate(request_object.to_h)
+        end
+
+        # Unmarshals a JSON string into an object of type _klass_ using klass.new_from_hash
+        def unmarshal(json_string, klass)
+          if json_string.nil?
+            return nil
+          elsif json_string.length == 0
+            return ''
+          end
+          if klass.respond_to?(:new_from_hash)
+            klass.new_from_hash(::JSON.load(json_string))
+          else
+            raise NotImplementedError
+          end
+        end
+      end
+    end
+  end
+end