connect-sdk-ruby 1.36.0 → 2.0.0

data/lib/ingenico/connect/sdk/logging/logging_util.rb

@@ -16,12 +16,12 @@ module Ingenico::Connect::SDK
       end
 
       # Creates a new ValueObfuscator.
-      # fixed_length::      If greater than 0, all values that will be obfuscated
-      #                     will be replaced with that number of asterisks.
-      # keep_start_count::  The number of characters to not obfuscate at the end of any value.
-      #                     This parameter is only used if _fixed_length_ = 0.
-      # keep_end_count::    The number of characters to not obfuscate at the start of any value.
-      #                     This parameter is only used if _fixed_length_ = 0.
+      #
+      # @param fixed_length     [Integer] if greater than 0, all values that will be obfuscated will be replaced with that number of asterisks.
+      # @param keep_start_count [Integer] the number of characters to not obfuscate at the end of any value.
+      #                         This parameter is only used if _fixed_length_ = 0.
+      # @param keep_end_count   [Integer] the number of characters to not obfuscate at the start of any value.
+      #                         This parameter is only used if _fixed_length_ = 0.
       def initialize(fixed_length, keep_start_count, keep_end_count)
         @mask_character = '*'
         @fixed_length = fixed_length
@@ -171,9 +171,9 @@ module Ingenico::Connect::SDK
           super(name)
         end
 
-        def with_fixed_length(name, fixedLength)
+        def with_fixed_length(name, fixed_length)
           raise ArgumentError unless name.is_a? String
-          super(name, fixedLength)
+          super(name, fixed_length)
         end
 
         def build
@@ -187,7 +187,7 @@ module Ingenico::Connect::SDK
       def initialize(obfuscators)
         # case sensitive
         super(obfuscators, false)
-        @propertyPattern = build_property_pattern(obfuscators.keys)
+        @property_pattern = build_property_pattern(obfuscators.keys)
       end
 
       private
@@ -216,12 +216,12 @@ module Ingenico::Connect::SDK
         return nil if body.nil?
         return '' if body.empty?
 
-        body.gsub(@propertyPattern) do
+        body.gsub(@property_pattern) do
           m = Regexp.last_match
-          propertyName = m[2]
+          property_name = m[2]
           value = m[4] || m[5]
           # copy value 'cause it's part of m[0]
-          m[0].sub(value, obfuscate_value(propertyName, value.dup))
+          m[0].sub(value, obfuscate_value(property_name, value.dup))
         end
       end
 
@@ -239,9 +239,9 @@ module Ingenico::Connect::SDK
           super(property)
         end
 
-        def with_fixed_length(property, fixedLength)
+        def with_fixed_length(property, fixed_length)
           raise ArgumentError unless property.is_a? String
-          super(property, fixedLength)
+          super(property, fixed_length)
         end
 
         def with_keep_start_count(key, count)

data/lib/ingenico/connect/sdk/logging/request_log_message_builder.rb

@@ -12,17 +12,17 @@ module Ingenico::Connect::SDK
 
       # Constructs and returns a log message based on the request data. The log message is a string.
       def get_message
-        msgTemplateWithoutBody = "Outgoing request (requestId='%s'):\n" +
+        msg_template_without_body = "Outgoing request (requestId='%s'):\n" +
             "  method:       '%s'\n" +
             "  uri:          '%s'\n" +
             "  headers:      '%s'"
-        msgTemplateWithBody = msgTemplateWithoutBody + "\n" +
+        msg_template_with_body = msg_template_without_body + "\n" +
             "  content-type: '%s'\n" +
             "  body:         '%s'"
 
-        return sprintf(msgTemplateWithoutBody, @request_id, empty_if_null(@method),
+        return sprintf(msg_template_without_body, @request_id, empty_if_null(@method),
                        format_uri, @headers) if @body.nil?
-        sprintf(msgTemplateWithBody, @request_id, empty_if_null(@method),
+        sprintf(msg_template_with_body, @request_id, empty_if_null(@method),
                 format_uri, @headers, empty_if_null(@content_type), @body)
       end
 
@@ -37,7 +37,6 @@ module Ingenico::Connect::SDK
         end
         # @uri.path + '?' + empty_if_null(@uri.query)
       end
-
     end
   end
 end

data/lib/ingenico/connect/sdk/logging/response_log_message_builder.rb

@@ -5,9 +5,10 @@ module Ingenico::Connect::SDK
 
       # Class that converts data about a response into a properly formatted log message.
       # Formats request id, status code, headers, body and time between request and response into a helpful message.
-      # request_id::  Identifier of the request corresponding to this response.
-      # status_code:: HTTP status code of the response.
-      # duration::    Time elapsed between request and response.
+      #
+      # @param request_id  [String] identifier of the request corresponding to this response.
+      # @param status_code [Integer] HTTP status code of the response.
+      # @param duration    [Float] time elapsed between request and response.
       def initialize(request_id, status_code, duration=-1)
         super(request_id)
         @status_code = status_code
@@ -16,7 +17,7 @@ module Ingenico::Connect::SDK
 
       # Constructs and returns a log message based on the request data. The log message is a string.
       def get_message
-        msgTemplate = "Incoming response (requestId='%s'" +
+        msg_template = "Incoming response (requestId='%s'" +
             ((@duration < 0) ? "" : ", %.3f ms") +
             "):\n" +
             "  status-code:  '%s'\n" +
@@ -24,9 +25,9 @@ module Ingenico::Connect::SDK
             "  content-type: '%s'\n" +
             "  body:         '%s'"
 
-        return sprintf(msgTemplate, @request_id, @status_code, @headers,
+        return sprintf(msg_template, @request_id, @status_code, @headers,
                        empty_if_null(@content_type), empty_if_null(@body)) if @duration < 0
-        sprintf(msgTemplate, @request_id, @duration, @status_code, @headers,
+        sprintf(msg_template, @request_id, @duration, @status_code, @headers,
                 empty_if_null(@content_type), empty_if_null(@body))
       end
     end

data/lib/ingenico/connect/sdk/logging/ruby_communicator_logger.rb

@@ -8,9 +8,10 @@ module Ingenico::Connect::SDK
     class RubyCommunicatorLogger < CommunicatorLogger
 
       # Creates a new RubyCommunicatorLogger instance.
-      # logger::      The logger to log messages to. Messages to log will be provided using logger#log(message level, message)
-      # log_level::   Log level to use for non-error messages.
-      # error_level:: Error logging level to use.
+      #
+      # @param logger      [Logger] the logger to log messages to. Messages to log will be provided using logger#log(message level, message)
+      # @param log_level   [String] log level to use for non-error messages.
+      # @param error_level [String] error logging level to use.
       def initialize(logger, log_level, error_level=false)
         # implement the interface
         error_level ||= log_level
@@ -27,7 +28,7 @@ module Ingenico::Connect::SDK
       def log(msg, thrown=false)
         # use Ruby Logger
         if thrown 
-          @logger.log(@errorLevel) { msg + $RS + thrown.backtrace.join($RS) }
+          @logger.log(@errorLevel) { msg + $RS + thrown.to_s + $RS + thrown.backtrace.join($RS) }
         else 
           @logger.log(@logLevel, msg)
         end

data/lib/ingenico/connect/sdk/logging/stdout_communicator_logger.rb

@@ -19,7 +19,8 @@ module Ingenico::Connect::SDK
 
       # Logs a single error or non-error message to $stdout.
       def log(msg, thrown=false)
-        $stdout.puts (get_date_prefix + msg)
+        $stdout.puts get_date_prefix + msg
+        $stdout.puts thrown.to_s if thrown
         $stdout.puts thrown.backtrace.join($RS) if thrown
       end
 

data/lib/ingenico/connect/sdk/marshaller.rb

@@ -3,15 +3,20 @@ module Ingenico::Connect::SDK
   # Class responsible for marshalling and unmarshalling objects to and from JSON
   class Marshaller
 
-    # Marshals _request_object_ to JSON format by calling #to_hash on it.
+    # Marshals _request_object_ to JSON format by calling #to_h on it.
+    #
+    # @param request_object [Ingenico::Connect::SDK::DataObject] the object to format
+    # @return [String] _request_object_ converted to JSON
     def marshal(request_object)
       raise NotImplementedError
     end
 
     # Unmarshals a JSON string into an object of type _type_.
     # The new object is initialized by calling .new_from_hash with contents of the JSON as a Hash object.
-    # response_json:: The JSON to unmarshal
-    # type::          The class of the object that will be instantiated using _type.new_from_hash_
+    #
+    # @param response_json [String] The JSON to unmarshal
+    # @param type          [Type] The class of the object that will be instantiated using _type.new_from_hash_
+    # @return The JSON unmarshalled to the given type
     def unmarshal(response_json, type)
       raise NotImplementedError
     end

data/lib/ingenico/connect/sdk/merchant/captures/captures_client.rb

@@ -14,30 +14,30 @@ module Ingenico::Connect::SDK
       # Captures client. Thread-safe.
       class CapturesClient < Ingenico::Connect::SDK::ApiResource
 
-        # parent::       {Ingenico::Connect::SDK::ApiResource}
-        # path_context:: Hash of String to String
+        # @param parent        [Ingenico::Connect::SDK::ApiResource]
+        # @param path_context  [Hash]
         def initialize(parent, path_context)
           super(parent, path_context)
         end
 
-        # Resource /{{merchantId}}/captures/{{captureId}} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/captures/get.html Get capture}
-        # capture_id:: String
-        # context::    {Ingenico::Connect::SDK::CallContext}
-        # Returns:: {Ingenico::Connect::SDK::Domain::Capture::CaptureResponse}
-        # Raises:: {Ingenico::Connect::SDK::ValidationException} if the request was not correct and couldn't be processed (HTTP status code 400)
-        # Raises:: {Ingenico::Connect::SDK::AuthorizationException} if the request was not allowed (HTTP status code 403)
-        # Raises:: {Ingenico::Connect::SDK::IdempotenceException} if an idempotent request caused a conflict (HTTP status code 409)
-        # Raises:: {Ingenico::Connect::SDK::ReferenceException} if an object was attempted to be referenced that doesn't exist or has been removed,  
-        #          or there was a conflict (HTTP status code 404, 409 or 410)
-        # Raises:: {Ingenico::Connect::SDK::GlobalCollectException} if something went wrong at the Ingenico ePayments platform,  
-        #          the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,  
-        #          or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        # Raises:: {Ingenico::Connect::SDK::ApiException} if the Ingenico ePayments platform returned any other error
+        # Resource /!{merchantId}/captures/!{captureId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/captures/get.html Get capture}
+        # @param capture_id [String]
+        # @param context    [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Capture::CaptureResponse]
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
+        #        or there was a conflict (HTTP status code 404, 409 or 410)
+        # @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
+        #        or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
+        # @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
         def get(capture_id, context=nil)
           path_context = {
-            'captureId' => capture_id,
+            'captureId'.freeze => capture_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/captures/{captureId}', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/captures/{captureId}', path_context)
           return @communicator.get(
             uri,
             client_headers,

data/lib/ingenico/connect/sdk/merchant/disputes/disputes_client.rb

@@ -5,6 +5,7 @@
 require 'ingenico/connect/sdk/api_resource'
 require 'ingenico/connect/sdk/response_exception'
 require 'ingenico/connect/sdk/domain/dispute/dispute_response'
+require 'ingenico/connect/sdk/domain/dispute/upload_dispute_file_response'
 require 'ingenico/connect/sdk/domain/errors/error_response'
 
 module Ingenico::Connect::SDK
@@ -14,30 +15,30 @@ module Ingenico::Connect::SDK
       # Disputes client. Thread-safe.
       class DisputesClient < Ingenico::Connect::SDK::ApiResource
 
-        # parent::       {Ingenico::Connect::SDK::ApiResource}
-        # path_context:: Hash of String to String
+        # @param parent        [Ingenico::Connect::SDK::ApiResource]
+        # @param path_context  [Hash]
         def initialize(parent, path_context)
           super(parent, path_context)
         end
 
-        # Resource /{{merchantId}}/disputes/{{disputeId}} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/get.html Get dispute}
-        # dispute_id:: String
-        # context::    {Ingenico::Connect::SDK::CallContext}
-        # Returns:: {Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse}
-        # Raises:: {Ingenico::Connect::SDK::ValidationException} if the request was not correct and couldn't be processed (HTTP status code 400)
-        # Raises:: {Ingenico::Connect::SDK::AuthorizationException} if the request was not allowed (HTTP status code 403)
-        # Raises:: {Ingenico::Connect::SDK::IdempotenceException} if an idempotent request caused a conflict (HTTP status code 409)
-        # Raises:: {Ingenico::Connect::SDK::ReferenceException} if an object was attempted to be referenced that doesn't exist or has been removed,  
-        #          or there was a conflict (HTTP status code 404, 409 or 410)
-        # Raises:: {Ingenico::Connect::SDK::GlobalCollectException} if something went wrong at the Ingenico ePayments platform,  
-        #          the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,  
-        #          or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        # Raises:: {Ingenico::Connect::SDK::ApiException} if the Ingenico ePayments platform returned any other error
+        # Resource /!{merchantId}/disputes/!{disputeId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/get.html Get dispute}
+        # @param dispute_id [String]
+        # @param context    [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse]
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
+        #        or there was a conflict (HTTP status code 404, 409 or 410)
+        # @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
+        #        or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
+        # @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
         def get(dispute_id, context=nil)
           path_context = {
-            'disputeId' => dispute_id,
+            'disputeId'.freeze => dispute_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/disputes/{disputeId}', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/disputes/{disputeId}', path_context)
           return @communicator.get(
             uri,
             client_headers,
@@ -50,24 +51,24 @@ module Ingenico::Connect::SDK
           raise create_exception(e.status_code, e.body, error_object, context)
         end
 
-        # Resource /{{merchantId}}/disputes/{{disputeId}}/submit - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/submit.html Submit dispute}
-        # dispute_id:: String
-        # context::    {Ingenico::Connect::SDK::CallContext}
-        # Returns:: {Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse}
-        # Raises:: {Ingenico::Connect::SDK::ValidationException} if the request was not correct and couldn't be processed (HTTP status code 400)
-        # Raises:: {Ingenico::Connect::SDK::AuthorizationException} if the request was not allowed (HTTP status code 403)
-        # Raises:: {Ingenico::Connect::SDK::IdempotenceException} if an idempotent request caused a conflict (HTTP status code 409)
-        # Raises:: {Ingenico::Connect::SDK::ReferenceException} if an object was attempted to be referenced that doesn't exist or has been removed,  
-        #          or there was a conflict (HTTP status code 404, 409 or 410)
-        # Raises:: {Ingenico::Connect::SDK::GlobalCollectException} if something went wrong at the Ingenico ePayments platform,  
-        #          the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,  
-        #          or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        # Raises:: {Ingenico::Connect::SDK::ApiException} if the Ingenico ePayments platform returned any other error
+        # Resource /!{merchantId}/disputes/!{disputeId}/submit - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/submit.html Submit dispute}
+        # @param dispute_id [String]
+        # @param context    [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse]
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
+        #        or there was a conflict (HTTP status code 404, 409 or 410)
+        # @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
+        #        or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
+        # @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
         def submit(dispute_id, context=nil)
           path_context = {
-            'disputeId' => dispute_id,
+            'disputeId'.freeze => dispute_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/disputes/{disputeId}/submit', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/disputes/{disputeId}/submit', path_context)
           return @communicator.post(
             uri,
             client_headers,
@@ -81,24 +82,24 @@ module Ingenico::Connect::SDK
           raise create_exception(e.status_code, e.body, error_object, context)
         end
 
-        # Resource /{{merchantId}}/disputes/{{disputeId}}/cancel - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/cancel.html Cancel dispute}
-        # dispute_id:: String
-        # context::    {Ingenico::Connect::SDK::CallContext}
-        # Returns:: {Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse}
-        # Raises:: {Ingenico::Connect::SDK::ValidationException} if the request was not correct and couldn't be processed (HTTP status code 400)
-        # Raises:: {Ingenico::Connect::SDK::AuthorizationException} if the request was not allowed (HTTP status code 403)
-        # Raises:: {Ingenico::Connect::SDK::IdempotenceException} if an idempotent request caused a conflict (HTTP status code 409)
-        # Raises:: {Ingenico::Connect::SDK::ReferenceException} if an object was attempted to be referenced that doesn't exist or has been removed,  
-        #          or there was a conflict (HTTP status code 404, 409 or 410)
-        # Raises:: {Ingenico::Connect::SDK::GlobalCollectException} if something went wrong at the Ingenico ePayments platform,  
-        #          the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,  
-        #          or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        # Raises:: {Ingenico::Connect::SDK::ApiException} if the Ingenico ePayments platform returned any other error
+        # Resource /!{merchantId}/disputes/!{disputeId}/cancel - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/cancel.html Cancel dispute}
+        # @param dispute_id [String]
+        # @param context    [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse]
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
+        #        or there was a conflict (HTTP status code 404, 409 or 410)
+        # @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
+        #        or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
+        # @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
         def cancel(dispute_id, context=nil)
           path_context = {
-            'disputeId' => dispute_id,
+            'disputeId'.freeze => dispute_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/disputes/{disputeId}/cancel', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/disputes/{disputeId}/cancel', path_context)
           return @communicator.post(
             uri,
             client_headers,
@@ -111,6 +112,38 @@ module Ingenico::Connect::SDK
           error_object = @communicator.marshaller.unmarshal(e.body, error_type)
           raise create_exception(e.status_code, e.body, error_object, context)
         end
+
+        # Resource /!{merchantId}/disputes/!{disputeId} - {https://epayments-api.developer-ingenico.com/fileserviceapi/v1/en_US/ruby/disputes/uploadFile.html Upload File}
+        # @param dispute_id [String]
+        # @param body       [Ingenico::Connect::SDK::Merchant::Disputes::UploadFileRequest]
+        # @param context    [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Dispute::UploadDisputeFileResponse]
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
+        #        or there was a conflict (HTTP status code 404, 409 or 410)
+        # @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
+        #        or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
+        # @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
+        def upload_file(dispute_id, body, context=nil)
+          path_context = {
+            'disputeId'.freeze => dispute_id,
+          }
+          uri = instantiate_uri('/files/v1/{merchantId}/disputes/{disputeId}', path_context)
+          return @communicator.post(
+            uri,
+            client_headers,
+            nil,
+            body,
+            Ingenico::Connect::SDK::Domain::Dispute::UploadDisputeFileResponse,
+            context)
+        rescue ResponseException => e
+          error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
+          error_object = @communicator.marshaller.unmarshal(e.body, error_type)
+          raise create_exception(e.status_code, e.body, error_object, context)
+        end
       end
     end
   end

data/lib/ingenico/connect/sdk/merchant/disputes/upload_file_request.rb

@@ -0,0 +1,27 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/multipart_form_data_object'
+require 'ingenico/connect/sdk/multipart_form_data_request'
+
+module Ingenico::Connect::SDK
+  module Merchant
+    module Disputes
+
+      # Multipart/form-data parameters for {https://epayments-api.developer-ingenico.com/fileserviceapi/v1/en_US/ruby/disputes/uploadFile.html Upload File}
+      # @attr [Ingenico::Connect::SDK::UploadableFile] file
+      class UploadFileRequest < Ingenico::Connect::SDK::MultipartFormDataRequest
+
+        attr_accessor :file
+
+        # @return [Array<Ingenico::Connect::SDK::MultipartFormDataObject>] representing the attributes of this class
+        def to_multipart_form_data_object
+          result = MultipartFormDataObject.new
+          result.add_file('file', @file) unless @file.nil?
+          result
+        end
+      end
+    end
+  end
+end

data/lib/ingenico/connect/sdk/merchant/files/files_client.rb

@@ -0,0 +1,55 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/api_resource'
+require 'ingenico/connect/sdk/response_exception'
+require 'ingenico/connect/sdk/domain/errors/error_response'
+
+module Ingenico::Connect::SDK
+  module Merchant
+    module Files
+
+      # Files client. Thread-safe.
+      class FilesClient < Ingenico::Connect::SDK::ApiResource
+
+        # @param parent        [Ingenico::Connect::SDK::ApiResource]
+        # @param path_context  [Hash]
+        def initialize(parent, path_context)
+          super(parent, path_context)
+        end
+
+        # Resource /!{merchantId}/files/!{fileId} - {https://epayments-api.developer-ingenico.com/fileserviceapi/v1/en_US/ruby/files/getFile.html Retrieve File}
+        # @param file_id [String]
+        # @param context [Ingenico::Connect::SDK::CallContext]
+        # @yield [Array<Ingenico::Connect::SDK::ResponseHeader>, IO] The response headers and body.
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
+        #        or there was a conflict (HTTP status code 404, 409 or 410)
+        # @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
+        #        or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
+        # @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
+        def get_file(file_id, context=nil)
+          path_context = {
+            'fileId'.freeze => file_id,
+          }
+          uri = instantiate_uri('/files/v1/{merchantId}/files/{fileId}', path_context)
+          @communicator.get_with_binary_response(
+            uri,
+            client_headers,
+            nil,
+            context) do |headers, response_body|
+            yield headers, response_body
+          end
+        rescue ResponseException => e
+          error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
+          error_object = @communicator.marshaller.unmarshal(e.body, error_type)
+          raise create_exception(e.status_code, e.body, error_object, context)
+        end
+      end
+    end
+  end
+end