connect-sdk-ruby 1.36.0 → 2.0.0

data/lib/ingenico/connect/sdk/merchant/sessions/sessions_client.rb

@@ -14,27 +14,27 @@ module Ingenico::Connect::SDK
       # Sessions client. Thread-safe.
       class SessionsClient < 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}}/sessions - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/sessions/create.html Create session}
-        # body::    {Ingenico::Connect::SDK::Domain::Sessions::SessionRequest}
-        # context:: {Ingenico::Connect::SDK::CallContext}
-        # Returns:: {Ingenico::Connect::SDK::Domain::Sessions::SessionResponse}
-        # 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}/sessions - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/sessions/create.html Create session}
+        # @param body    [Ingenico::Connect::SDK::Domain::Sessions::SessionRequest]
+        # @param context [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Sessions::SessionResponse]
+        # @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 create(body, context=nil)
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/sessions', nil)
+          uri = instantiate_uri('/v1/{merchantId}/sessions', nil)
           return @communicator.post(
             uri,
             client_headers,

data/lib/ingenico/connect/sdk/merchant/tokens/delete_token_params.rb

@@ -3,21 +3,22 @@
 # https://epayments-api.developer-ingenico.com/s2sapi/v1/
 #
 require 'ingenico/connect/sdk/param_request'
+require 'ingenico/connect/sdk/request_param'
 
 module Ingenico::Connect::SDK
   module Merchant
     module Tokens
 
       # Query parameters for {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/delete.html Delete token}
+      # @attr [String] mandate_cancel_date
       class DeleteTokenParams < Ingenico::Connect::SDK::ParamRequest
 
-        # String
         attr_accessor :mandate_cancel_date
 
-        # Returns an Array of {Ingenico::Connect::SDK::RequestParam} objects representing the attributes of this class
+        # @return [Array<Ingenico::Connect::SDK::RequestParam>] representing the attributes of this class
         def to_request_parameters
           result = []
-          add_parameter(result, 'mandateCancelDate', @mandate_cancel_date)
+          result << RequestParam.new('mandateCancelDate', @mandate_cancel_date) unless @mandate_cancel_date.nil?
           result
         end
       end

data/lib/ingenico/connect/sdk/merchant/tokens/tokens_client.rb

@@ -15,27 +15,27 @@ module Ingenico::Connect::SDK
       # Tokens client. Thread-safe.
       class TokensClient < 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}}/tokens - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/create.html Create token}
-        # body::    {Ingenico::Connect::SDK::Domain::Token::CreateTokenRequest}
-        # context:: {Ingenico::Connect::SDK::CallContext}
-        # Returns:: {Ingenico::Connect::SDK::Domain::Token::CreateTokenResponse}
-        # 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}/tokens - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/create.html Create token}
+        # @param body    [Ingenico::Connect::SDK::Domain::Token::CreateTokenRequest]
+        # @param context [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Token::CreateTokenResponse]
+        # @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 create(body, context=nil)
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/tokens', nil)
+          uri = instantiate_uri('/v1/{merchantId}/tokens', nil)
           return @communicator.post(
             uri,
             client_headers,
@@ -49,24 +49,24 @@ module Ingenico::Connect::SDK
           raise create_exception(e.status_code, e.body, error_object, context)
         end
 
-        # Resource /{{merchantId}}/tokens/{{tokenId}} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/get.html Get token}
-        # token_id:: String
-        # context::  {Ingenico::Connect::SDK::CallContext}
-        # Returns:: {Ingenico::Connect::SDK::Domain::Token::TokenResponse}
-        # 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}/tokens/!{tokenId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/get.html Get token}
+        # @param token_id [String]
+        # @param context  [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Token::TokenResponse]
+        # @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(token_id, context=nil)
           path_context = {
-            'tokenId' => token_id,
+            'tokenId'.freeze => token_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/tokens/{tokenId}', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/tokens/{tokenId}', path_context)
           return @communicator.get(
             uri,
             client_headers,
@@ -79,24 +79,24 @@ module Ingenico::Connect::SDK
           raise create_exception(e.status_code, e.body, error_object, context)
         end
 
-        # Resource /{{merchantId}}/tokens/{{tokenId}} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/update.html Update token}
-        # token_id:: String
-        # body::     {Ingenico::Connect::SDK::Domain::Token::UpdateTokenRequest}
-        # context::  {Ingenico::Connect::SDK::CallContext}
-        # 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}/tokens/!{tokenId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/update.html Update token}
+        # @param token_id [String]
+        # @param body     [Ingenico::Connect::SDK::Domain::Token::UpdateTokenRequest]
+        # @param context  [Ingenico::Connect::SDK::CallContext]
+        # @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 update(token_id, body, context=nil)
           path_context = {
-            'tokenId' => token_id,
+            'tokenId'.freeze => token_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/tokens/{tokenId}', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/tokens/{tokenId}', path_context)
           return @communicator.put(
             uri,
             client_headers,
@@ -110,24 +110,24 @@ module Ingenico::Connect::SDK
           raise create_exception(e.status_code, e.body, error_object, context)
         end
 
-        # Resource /{{merchantId}}/tokens/{{tokenId}} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/delete.html Delete token}
-        # token_id:: String
-        # query::    {Ingenico::Connect::SDK::Merchant::Tokens::DeleteTokenParams}
-        # context::  {Ingenico::Connect::SDK::CallContext}
-        # 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}/tokens/!{tokenId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/delete.html Delete token}
+        # @param token_id [String]
+        # @param query    [Ingenico::Connect::SDK::Merchant::Tokens::DeleteTokenParams]
+        # @param context  [Ingenico::Connect::SDK::CallContext]
+        # @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 delete(token_id, query, context=nil)
           path_context = {
-            'tokenId' => token_id,
+            'tokenId'.freeze => token_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/tokens/{tokenId}', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/tokens/{tokenId}', path_context)
           return @communicator.delete(
             uri,
             client_headers,
@@ -140,24 +140,24 @@ module Ingenico::Connect::SDK
           raise create_exception(e.status_code, e.body, error_object, context)
         end
 
-        # Resource /{{merchantId}}/tokens/{{tokenId}}/approvesepadirectdebit - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/approvesepadirectdebit.html Approve SEPA DD mandate}
-        # token_id:: String
-        # body::     {Ingenico::Connect::SDK::Domain::Token::ApproveTokenRequest}
-        # context::  {Ingenico::Connect::SDK::CallContext}
-        # 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}/tokens/!{tokenId}/approvesepadirectdebit - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/tokens/approvesepadirectdebit.html Approve SEPA DD mandate}
+        # @param token_id [String]
+        # @param body     [Ingenico::Connect::SDK::Domain::Token::ApproveTokenRequest]
+        # @param context  [Ingenico::Connect::SDK::CallContext]
+        # @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 approvesepadirectdebit(token_id, body, context=nil)
           path_context = {
-            'tokenId' => token_id,
+            'tokenId'.freeze => token_id,
           }
-          uri = instantiate_uri('/{apiVersion}/{merchantId}/tokens/{tokenId}/approvesepadirectdebit', path_context)
+          uri = instantiate_uri('/v1/{merchantId}/tokens/{tokenId}/approvesepadirectdebit', path_context)
           return @communicator.post(
             uri,
             client_headers,

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

@@ -4,8 +4,10 @@ require 'base64'
 module Ingenico::Connect::SDK
 
   # Manages metadata about the server using the SDK
+  #
+  # @attr_reader [Array<Ingenico::Connect::SDK::RequestHeader>] meta_data_headers List of headers that should be used in all requests.
   class MetaDataProvider
-    @@SDK_VERSION = '1.36.0'
+    @@SDK_VERSION = '2.0.0'
     @@SERVER_META_INFO_HEADER = 'X-GCS-ServerMetaInfo'
     @@PROHIBITED_HEADERS = [@@SERVER_META_INFO_HEADER, 'X-GCS-Idempotence-Key',
                             'Date', 'Content-Type', 'Authorization'].sort!.freeze
@@ -34,35 +36,32 @@ module Ingenico::Connect::SDK
       # Returns the values of all attributes as a hash.
       def to_h
         hash = super
-        add_to_hash(hash, 'platformIdentifier', platform_identifier)
-        add_to_hash(hash, 'sdkIdentifier', sdk_identifier)
-        add_to_hash(hash, 'sdkCreator', sdk_creator)
-        add_to_hash(hash, 'integrator', integrator)
-        add_to_hash(hash, 'shoppingCartExtension', shopping_cart_extension)
+        hash['platformIdentifier'] = @platform_identifier unless @platform_identifier.nil?
+        hash['sdkIdentifier'] = @sdk_identifier unless @sdk_identifier.nil?
+        hash['sdkCreator'] = @sdk_creator unless @sdk_creator.nil?
+        hash['integrator'] = @integrator unless @integrator.nil?
+        hash['shoppingCartExtension'] = @shopping_cart_extension.to_h unless @shopping_cart_extension.nil?
         hash
       end
 
       # Initializes the ServerMetaInfo object with properties stored in the parameter hash
       def from_hash(hash)
         super
-        @platform_identifier = hash['platformIdentifier'] if hash.has_key?('platformIdentifier')
-        @sdk_identifier = hash['sdkIdentifier'] if hash.has_key?('sdkIdentifier')
-        @sdk_creator = hash['sdkCreator'] if hash.has_key?('sdkCreator')
-        @integrator = hash['integrator'] if hash.has_key?('integrator')
-        if hash.has_key?('shoppingCartExtension')
-          @shopping_cart_extension = Domain::Metadata::ShoppingCartExtension.new_from_hash(hash['shoppingCartExtension'])
-        end
+        @platform_identifier = hash['platformIdentifier'] if hash.has_key? 'platformIdentifier'
+        @sdk_identifier = hash['sdkIdentifier'] if hash.has_key? 'sdkIdentifier'
+        @sdk_creator = hash['sdkCreator'] if hash.has_key? 'sdkCreator'
+        @integrator = hash['integrator'] if hash.has_key? 'integrator'
+        @shopping_cart_extension = Domain::Metadata::ShoppingCartExtension.new_from_hash(hash['shoppingCartExtension']) if hash.has_key? 'shoppingCartExtension'
       end
     end
 
     # Create a new MetaDataProvider instance that can be used to access platform-related information
     #
-    # integrator::                  String
-    # shopping_cart_extension::     String
-    # additional_request_headers::  {Ingenico::Connect::SDK::RequestHeader} list of additional headers to include in all requests made.
-    #                               The following headers are not allowed due to conflicts with already added headers:
-    #                               'X-GCS-Idempotence-Key', 'Date', 'Content-Type', 'Authorization'
-    #                               and 'X-GCS-ServerMetaInfo'
+    # @param integrator                 [String] Name of the integrator
+    # @param shopping_cart_extension    [Ingenico::Connect::SDK::Domain::Metadata::ShoppingCartExtension] shopping cart-related metadata.
+    # @param additional_request_headers [Array<Ingenico::Connect::SDK::RequestHeader>] list of additional headers to include in all requests made.
+    #                                   The following headers are not allowed due to conflicts with already added headers:
+    #                                   'X-GCS-Idempotence-Key', 'Date', 'Content-Type', 'Authorization' and 'X-GCS-ServerMetaInfo'
     def initialize(integrator, shopping_cart_extension: nil, additional_request_headers: [].freeze)
 
       MetaDataProvider.validate_additional_request_headers(additional_request_headers)
@@ -121,6 +120,7 @@ module Ingenico::Connect::SDK
         s = 'Mac OS X'
       end
       s += '/' + RUBY_DESCRIPTION
+      s
     end
 
     # String describing the version of the SDK being used
@@ -146,7 +146,6 @@ module Ingenico::Connect::SDK
       @@PROHIBITED_HEADERS
     end
 
-    # A {Ingenico::Connect::SDK::RequestHeader} list of headers that should be used in all requests.
     attr_reader :meta_data_headers
   end
 end

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

@@ -21,6 +21,11 @@ end
 module Ingenico::Connect::SDK::Domain
 end
 
+# Contains the client used to access the Files service.
+# @see https://epayments-api.developer-ingenico.com/fileserviceapi/v1/en_US/ruby/files/
+module Ingenico::Connect::SDK::Merchant::Files
+end
+
 # Contains data classes that are used in file handling.
 module Ingenico::Connect::SDK::Domain::File
 end
@@ -160,10 +165,6 @@ end
 module Ingenico::Connect::SDK::Domain::Token
 end
 
-# Contains data classes that are used for cryptography services.
-module Ingenico::Connect::SDK::Domain::Publickey
-end
-
 # Contains the general data classes that are used in multiple different types of requests.
 # These classes can be serialized and used in communication with the Ingenico ePayments platform.
 module Ingenico::Connect::SDK::Domain::Definitions

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

@@ -0,0 +1,44 @@
+require 'securerandom'
+
+module Ingenico::Connect::SDK
+
+  # A representation of a multipart/form-data object
+  class MultipartFormDataObject
+    def initialize
+      @boundary = SecureRandom.uuid
+      @content_type = 'multipart/form-data; boundary=' + @boundary
+      @values = {}
+      @files = {}
+    end
+
+    attr_reader :boundary
+    attr_reader :content_type
+    attr_reader :values
+    attr_reader :files
+
+    def add_value(parameter_name, value)
+      if parameter_name.nil? || parameter_name.strip.empty?
+        raise ArgumentError, 'parameter_name is required'
+      end
+      raise ArgumentError, 'value is required' if value.nil?
+      if @values.include?(parameter_name) || @files.include?(parameter_name)
+        raise ArgumentError, 'duplicate parameterName: ' + parameter_name
+      end
+
+      @values[parameter_name] = value
+    end
+
+    # Adds a file to the multipart Form Data Object
+    def add_file(parameter_name, uploadable_file)
+      if parameter_name.nil? || parameter_name.strip.empty?
+        raise ArgumentError, 'parameter_name is required'
+      end
+      raise ArgumentError, 'uploadable_file is required' if uploadable_file.nil?
+      if @values.include?(parameter_name) || @files.include?(parameter_name)
+        raise ArgumentError, 'duplicate parameterName: ' + parameter_name
+      end
+
+      @files[parameter_name] = uploadable_file
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+module Ingenico::Connect::SDK
+  # A representation of a multipart/form-data request
+  class MultipartFormDataRequest
+    # @return [Ingenico::Connect::SDK::MultipartFormDataObject]
+    def to_multipart_form_data_object
+      raise NotImplementedError
+    end
+  end
+end

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

@@ -2,18 +2,15 @@ module Ingenico::Connect::SDK
 
   # Raised when a resource is not found on the Ingenico ePayments platform.
   # This error corresponds to a 404 HTTP response.
+  #
+  # @attr [Exception] cause The error that is the cause of this error.
   class NotFoundException < RuntimeError
 
-    def initialize(cause, message=false)
-      if message
-        super(message)
-      else
-        super
-      end
+    def initialize(cause, message=nil)
+      super(message)
       @cause = cause
     end
 
-    # The error that is the cause of this error.
     attr_accessor :cause
   end
 end