mastercard_core_sdk 1.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6e7df2eff37964c63a22e1236da3947f19a991b4
+  data.tar.gz: 76953aebb3f13d721632da658b251fdb04c678f5
+SHA512:
+  metadata.gz: 098ae2e010fd9bd98a8711a9303fa69c3bf113fc10abe0be31976dd8bdd43c1de2d1ab1c4286b8680c13dc3b078fbd7f8d3ce3dc91e4aa92c1e9bde454f237ca
+  data.tar.gz: e756bba10eba20b7ef1c639fb9230ec42a6abce1c6c082f0be4e70a89f53a9e68dccac1e33b533c44ed2226e6f6186d4c5da9c2da8d70fdcae1826c359409b81

data/LICENSE.txt

@@ -0,0 +1,24 @@
+Copyright (c) 2016, MasterCard International Incorporated
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are 
+permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of 
+conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of 
+conditions and the following disclaimer in the documentation and/or other materials 
+provided with the distribution.
+Neither the name of the MasterCard International Incorporated nor the names of its 
+contributors may be used to endorse or promote products derived from this software 
+without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 
+EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
+SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
+OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
+SUCH DAMAGE.

data/README.md

@@ -0,0 +1,66 @@
+# MastercardCoreSdk
+	This is core SDK containing the configuration part for checkout SDK.
+	The merchant checkout SDK - MastercardMasterpassMerchant requires this MastercardCoreSdk as dependency for calling the checkout API services. 
+	Features include :
+	• Exception Handler - Exception handling features help you deal with any unexpected or exceptional situations that occur while calling the API services. 
+	• Serializers - Serializer handles the request and responses for the API services. 
+	• ApiTracker - ApiTracker tracks the details of SDK from which API services are called. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mastercard_core_sdk'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mastercard_core_sdk
+
+## Usage
+Set MasterCard Configuration using Consumer Key & Private Key from developer's site and call API: 
+
+```
+require 'mastercard_core_sdk'
+
+MasterCardApiConfiguration.consumer_key = <Consumer Key>
+MasterCardApiConfiguration.private_key = OpenSSL::PKCS12.new(File.open(<Path to P12 file>), <Password>).key
+MasterCardApiConfiguration.sandbox = false  #By default SANDBOX environment is set, Set sandbox to false to use Production environment
+
+request_token_response = RequestTokenApi.create(<URL>)
+```
+
+
+## Copyright
+Copyright (c) 2016, MasterCard International Incorporated. See LICENSE for details.
+
+## LICENSE
+Copyright (c) 2016, MasterCard International Incorporated. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are 
+permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of 
+conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of 
+conditions and the following disclaimer in the documentation and/or other materials 
+provided with the distribution.
+Neither the name of the MasterCard International Incorporated nor the names of its 
+contributors may be used to endorse or promote products derived from this software 
+without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 
+EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
+SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
+OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
+SUCH DAMAGE.
+

data/lib/mastercard_core_sdk/api/access_token_api.rb

@@ -0,0 +1,31 @@
+require_relative '../core/service_request'
+require_relative '../client/api_client'
+require_relative '../exceptions/error_handler'
+require_relative '../models/access_token_response'
+
+module MastercardCoreSdk
+  module Api
+   class AccessTokenApi
+      include MastercardCoreSdk::Core, MastercardCoreSdk::Client, MastercardCoreSdk::Exceptions, MastercardCoreSdk::Tracker
+      
+      # Access Token Api service
+      # @param oauth_verifier
+      # @param oauth_token
+      # @param api_config Optional ApiConfig object.
+      # @return [AccessTokenResponse]
+      def self.create(oauth_verifier, oauth_token, api_config = nil)
+        path = "/oauth/consumer/v1/access_token"
+        
+        service_request = ServiceRequest.new
+        service_request.headers = {"oauth_verifier" => oauth_verifier, "oauth_token" => oauth_token}  
+        service_request.content_type = "application/xml"
+        api_client = ApiClient.new(api_config)
+
+        api_client.api_tracker = TokenApiTracker.new
+        api_client.error_handler = ErrorHandler.new
+        return api_client.call(path, service_request, "POST", AccessTokenResponse)
+      end
+      
+    end
+  end
+end

data/lib/mastercard_core_sdk/api/request_token_api.rb

@@ -0,0 +1,30 @@
+require_relative '../core/service_request'
+require_relative '../client/api_client'
+require_relative '../exceptions/error_handler'
+require_relative '../models/request_token_response'
+
+module MastercardCoreSdk
+  module Api
+    class RequestTokenApi
+      include MastercardCoreSdk::Core, MastercardCoreSdk::Client, MastercardCoreSdk::Exceptions, MastercardCoreSdk::Tracker
+      
+      # Request Token Api service
+      # @param oauth_callback_url Callback URL.
+      # @param api_config Optional ApiConfig object.
+      # @return [RequestTokenResponse]
+      def self.create(oauth_callback_url, api_config = nil)
+        path = "/oauth/consumer/v1/request_token"
+
+        service_request = ServiceRequest.new
+        service_request.headers = {"oauth_callback" => oauth_callback_url}
+        service_request.content_type = "application/xml"
+        api_client = ApiClient.new(api_config)
+
+        api_client.api_tracker = TokenApiTracker.new
+        api_client.error_handler = ErrorHandler.new
+        return api_client.call(path, service_request, "POST", RequestTokenResponse)
+      end
+      
+    end
+  end
+end

data/lib/mastercard_core_sdk/client/api_client.rb

@@ -0,0 +1,192 @@
+require 'date'
+require 'typhoeus'
+require 'uri'
+require 'logging'
+
+require_relative '../models/error_response'
+require_relative '../core/mastercard_authenticator'
+require_relative '../core/mastercard_api_configuration'
+require_relative '../core/api_config'
+require_relative '../interceptors/signature_builder'
+require_relative '../interceptors/logger_builder'
+require_relative '../interceptors/api_tracker_builder'
+require_relative '../converters/sdk_converter_factory'
+
+module MastercardCoreSdk
+  module Client
+    class ApiClient
+      include MastercardCoreSdk::Core, MastercardCoreSdk::Interceptors, MastercardCoreSdk::Converters, MastercardCoreSdk::Tracker
+
+      @@logger = Logging.logger[self]
+
+      # The Configuration object holding settings to be used in the API client.
+      attr_accessor :config
+      
+      # The ApiConfig object holding environment configurations.
+      attr_accessor :api_config
+
+      # Defines the headers to be used in HTTP requests of all API calls by default.
+      #
+      # @return [Hash]
+      attr_accessor :default_headers
+
+      # Defines the api_tracker to be added in request header having parameters.
+      #
+      # @return [Hash]
+      attr_accessor :api_tracker
+
+      # Defines the object that would handle error for all the requests.
+      attr_accessor :error_handler
+      
+      attr_accessor :mastercard_authenticator
+      
+      # Initializing Api Client with user-agent, configuration and default headers.
+      # Validating MasterCardApiConfiguration and calling interceptor for Authorization signature and logger.
+      def initialize(api_config = nil)
+        @config = Configuration.default
+        @user_agent = @config.user_agent
+        @default_headers = @config.default_headers
+        
+        @mastercard_authenticator = MastercardAuthenticator.new
+        @api_config = api_config || MasterCardApiConfiguration.api_config
+        MasterCardApiConfiguration.validate_config(@api_config)
+      end
+      
+      def self.default
+        @@default ||= ApiClient.new
+      end
+
+      # Execute Typhoeus request.
+      # @param path URL for request
+      # @param service_request Service Request object
+      # @param http_method Specifies HTTP method
+      # @param return_type Specifies response return type model
+      # @return [String]
+      def call(path, service_request, http_method, return_type)
+        request = build_request(http_method, path, service_request, @api_config)
+        response_body, response_code, response_headers = call_api(request, return_type)
+
+        return response_body
+      end
+
+      private
+      # Call an API with given options.
+      #
+      # @return [Array<(Object, Fixnum, Hash)>] an array of 3 elements:
+      #   the data deserialized from response body (could be nil), response status code and response headers.
+      def call_api(request, return_type)
+        @mastercard_authenticator.api_tracker = @api_tracker
+        @mastercard_authenticator.authenticate  
+        response = request.run
+
+        # Clearing callbacks
+        request.on_complete.clear
+        Typhoeus.before.clear
+        
+        unless response.success?
+          error_response = ErrorResponse.new(:response => response, :response_code => response.response_code)
+          @error_handler.handle_error(error_response)
+        end
+
+        if return_type
+          converter = SDKConverterFactory.get_converter(mime_sub_type(response.headers['Content-Type']))
+          data = converter.response_body_converter(response.response_body, return_type)
+        else
+          data = nil
+        end
+
+        return data, response.code, response.headers
+      end
+
+      def build_request(http_method, path, request, api_config)
+        url = build_request_url(path, request, api_config)
+        http_method = http_method.to_sym.downcase
+        content_type_header = {"Content-Type" => request.content_type}
+        api_config_header = {ApiConfig::CONFIG_NAME_HEADER => @api_config.name}
+        header_params = @default_headers.merge(content_type_header || {}).merge(request.headers || {}).merge(api_config_header)
+        query_params = request.query_params || {}
+
+        req_opts = {
+          :method => http_method,
+          :headers => header_params,
+          :params => query_params,
+          :timeout => @config.timeout,
+          :ssl_verifypeer => @config.verify_ssl
+        }
+
+        if [:post, :patch, :put, :delete].include?(http_method)
+          req_body = build_request_body(request)
+          req_opts.update :body => req_body
+        end
+
+        Typhoeus::Request.new(url, req_opts)
+      end
+
+      def build_request_url(path, service_request, api_config)
+        if service_request.path_params.length > 0
+          service_request.path_params.each do |param, value|
+            path = path.sub('{' + param + '}', value.to_s)
+          end
+        end
+        # Add leading and trailing slashes to path
+        path = "/#{path}".gsub(/\/+/, '/')
+        URI.encode(api_config.host_url + path)
+      end
+
+      def build_request_body(service_request)
+        content_type = service_request.content_type || nil
+        body = service_request.body || nil
+        data = nil
+        if body
+           converter = SDKConverterFactory.get_converter(mime_sub_type(content_type))
+           data = converter.request_body_converter(body)
+        end
+        return data
+      end
+
+      def user_agent=(user_agent)
+        @user_agent = user_agent
+        @default_headers['User-Agent'] = @user_agent
+      end
+      
+     
+      def mime_sub_type(content_type)
+        mime_type = ""
+        if json_mime?(content_type)
+          mime_type = JSON_MIME_TYPE 
+        elsif xml_mime?(content_type)
+          mime_type = XML_MIME_TYPE
+        elsif urlencoded_mime?(content_type)
+          mime_type = URLENCODED_MIME_TYPE
+        end
+        return mime_type
+      end
+      
+      # Check if the given MIME is a JSON MIME.
+      # JSON MIME examples:
+      #   application/json
+      #   application/json; charset=UTF8
+      #   APPLICATION/JSON
+      def json_mime?(mime)
+        !!(mime =~ /\Aapplication\/json(;.*)?\z/i)
+      end
+
+      # Check if the given MIME is a XML MIME.
+      # XML MIME examples:
+      #   application/xml
+      #   application/xml; charset=UTF8
+      #   APPLICATION/XML
+      def xml_mime?(mime)
+        !!(mime =~ /\Aapplication\/xml(;.*)?\z/i)
+      end
+     
+      # Check if the given MIME is a X-WWW-FORM_URLENCODED MIME.
+      # XML MIME examples:
+      #   application/x-www-form-urlencoded
+      def urlencoded_mime?(mime)
+        !!(mime =~ /\Aapplication\/x-www-form-urlencoded(;.*)?\z/i)
+      end
+     
+    end
+  end
+end

data/lib/mastercard_core_sdk/constants/constants.rb

@@ -0,0 +1,95 @@
+module MastercardCoreSdk
+
+  #Constants defined for base SDK
+
+  #Header
+  API_TRACKER_HEADER = "API-Call-Tracker"
+  USER_AGENT_HEADER = "User-Agent"
+
+  #OAuth
+  OAUTH_BODY_HASH = 'oauth_body_hash'
+  OAUTH_CONSUMER_KEY = 'oauth_consumer_key'
+  OAUTH_NONCE = 'oauth_nonce'
+  OAUTH_SIGNATURE = 'oauth_signature'
+  OAUTH_SIGNATURE_METHOD = 'oauth_signature_method'
+  OAUTH_KEY_SIGNATURE_METHOD_VAL = 'RSA-SHA1'
+  OAUTH_TIMESTAMP = 'oauth_timestamp'
+  OAUTH_VERSION = 'oauth_version'
+  OAUTH_VERSION_VAL = '1.0'
+  OAUTH_KEY_TOKEN = 'oauth_token'
+  OAUTH_KEY_LONG_ACCESS_TOKEN = 'long_access_token'
+  OAUTH_KEY_ACCESS_TOKEN = 'access_token'
+  OAUTH_TOKEN = 'oauth_token'
+  OAUTH_VERIFIER = 'oauth_verifier'
+  OAUTH_TOKEN_SECRET = 'oauth_token_secret'
+  OAUTH_CALLBACK = 'oauth_callback'
+  OAUTH_CALLBACK_CONFIRMED = 'oauth_callback_confirmed'
+  OAUTH_EXPIRES_IN = 'oauth_expires_in'
+  REALM = 'realm'
+  REALM_TYPE = 'eWallet'
+  ORIGIN_URL = 'originUrl'
+  AUTH_HEADER = 'Authorization'
+
+  NONCE_LENGTH = 8
+  VALID_CHARS = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
+
+  OAUTH_START_STRING = 'OAuth '
+  ERROR_STATUS_BOUNDARY = 300
+  EMPTY_STRING = ""
+
+  POST = "POST"
+  GET = "GET"
+  DELETE = "DELETE"
+  PUT = "PUT"
+  UTF_8 = "UTF-8"
+  EQUALS = "="
+  AMP = '&'
+  COLON_2X_BACKSLASH = "://"
+  MESSAGE = "Message"
+  HTTP_CODE = "HttpCode"
+
+  SSL_CA_CER_PATH_LOCATION = '/data/cert.pem'
+  BASE_SDK_VERSION = "base_sdk_version="
+  CLIENT_SDK_VERSION = "client_sdk_version="
+  LANG_NAME = "lang_name="
+  LANG_VERSION = "lang_version="
+  PLUGIN_VERSION = "plugin_version"
+  SEPERATOR = ","
+  EQUAL = "="
+  USER_AGENT = "MC Open API OAuth Framework v1.0-Ruby"
+
+  LOG_REQUEST = "Request: "
+  LOG_REQUEST_INFORMATION = "Request Information"
+  COLON = ": "
+  HYPHEN = " - "
+
+  LOG_RESPONSE = "Response: "
+  LOG_RESPONSE_INFORMATION= "Response Information"
+  LOG_URI = "Uri: "
+  LOG_CONTENT = "Content: "
+
+  LOG_MSG_TRACKING_INFO_ERROR = 'Tracking info method should be implemented for API Tracker.'
+  LOG_MSG_USER_AGENT_ERROR = 'User Agent info method should be implemented for API Tracker.'
+  LOG_MSG_OAUTH_HEADER = 'Authorization header added in the request.'
+  LOG_MSG_SANDBOX = "Routing to sandbox environment. Sandbox url: "
+
+  ERR_MSG_PRIVATE_KEY = "Private key must be set through MasterCardApiConfiguration class."
+  ERR_MSG_CONSUMER_KEY = "Consumer key must be set through MasterCardApiConfiguration class."
+  ERR_MSG_NULL_HEADER = "Found null value for API-Call-Tracker or User-Agent header."
+  ERR_MSG_NULL_SERVICE = "Found API tracker service is not implemented."
+  ERR_MSG_NULL_REQUEST = "Request can not be null."
+  ERR_MSG_NULL_RESPONSE = "Response can not be null."
+  ERR_MSG_OAUTH_HEADER = "Parameters can not be null."
+  ERR_MSG_CONVERSION = "Conversion failed."
+  ERR_MSG_API_CONFIG = "Api Config cannot be null."
+  ERR_MSG_HOST_URL = "Host URL cannot be empty."
+
+  NULL_RESPONSE_PARAMETERS_ERROR = "Response parameters cannot be null."
+  NULL_OAUTH_PARAMETERS_ERROR = "Oauth parameters cannot be null."
+  
+  # Mime-types
+  JSON_MIME_TYPE = "JSON"
+  XML_MIME_TYPE = "XML"
+  URLENCODED_MIME_TYPE = "WWW-FORM-URLENCODED"
+
+end

data/lib/mastercard_core_sdk/converters/encoded_url_converter.rb

@@ -0,0 +1,55 @@
+require 'logging'
+require_relative  '../exceptions/sdk_oauth_error'
+
+module MastercardCoreSdk
+  module Converters
+     # Handles conversion for content-type : "application/x-www-form-urlencoded"
+     class EncodedURLConverter
+        include MastercardCoreSdk::Exceptions
+         
+        @@logger = Logging.logger[self] 
+        
+        # Convert the request body to String.
+        # @param value Request body string
+        # @return [String] string representation of the value
+        def request_body_converter(value)
+          return nil if value.nil?
+          return value.to_s if !value.is_a?(String)
+        end
+        
+        # Convert the response to the given return type.
+        # @param response String retrieved that is to be converted to object
+        # @param return_type Defines converted object type; examples: "RequestTokenResponse", "AccessTokenResponse"
+        # @return [Object]
+        def response_body_converter(response, return_type)
+          body = response
+          return nil if body.nil? || body.empty?
+                   
+          begin 
+            object = return_type.new(parse_response_params(body))
+            return object
+          rescue => err
+            @@logger.error err.message
+            raise SDKConversionError.new(:error_message => err.message, :source => self.class)
+          end
+        end
+        
+        private
+        def parse_response_params(response_params)
+          response_params_hash = {}
+          if response_params.empty?
+            raise SdkOAuthError.new(NULL_OAUTH_PARAMETERS_ERROR)
+          else
+            if response_params.is_a?(String) && response_params.match(/&/)
+              response_params_arr = response_params.split('&').compact
+              response_params_hash = Hash[response_params_arr.map {|param| param.include?('=') ? param.split('=') : param}] unless response_params_arr.empty?
+              return response_params_hash
+            else
+              raise SDKConversionError.new(:error_message => ERR_MSG_CONVERSION, :source => self.class)
+            end
+          end
+        end
+        
+     end
+   end
+end

data/lib/mastercard_core_sdk/converters/json_converter.rb

@@ -0,0 +1,107 @@
+require 'logging'
+require 'json'
+require_relative  '../exceptions/sdk_conversion_error'
+
+module MastercardCoreSdk
+  module Converters
+    # Handles conversion for content-type : "application/json"
+    class JsonConverter
+      include MastercardCoreSdk::Exceptions
+
+      @@logger = Logging.logger[self]
+      
+      # Convert object (array, hash, object, etc) to JSON.
+      # @param object to be converted into JSON string
+      # @return [String] JSON string representation of the object
+      def request_body_converter(object)
+        return nil if object.nil? || object.is_a?(String)
+        serialized_json = nil
+
+        begin
+          if object.is_a?(Array)
+            object_hash = object.map{|o| object_to_hash(o) }
+          else
+            object_hash = object_to_hash(object)
+          end
+          serialized_json = object_hash.to_json
+          return serialized_json
+
+        rescue => err
+          @@logger.error err.message
+          raise SDKConversionError.new(:error_message => err.message, :source => self.class)
+        end
+      end
+
+      # Convert the response to the given return type.
+      #
+      # @param [String] return_type some examples: "User", "Array[User]", "Hash[String,Integer]"
+      def response_body_converter(response, return_type)
+        body = response.body
+        return nil if body.nil? || body.empty?
+        begin
+          data = JSON.parse("[#{body}]", :symbolize_names => true)[0]
+        rescue JSON::ParserError => e
+          if %w(String Date DateTime).include?(return_type.to_s)
+            data = body
+          else
+            @@logger.error e.message
+            raise SDKConversionError.new(:error_message => e.message, :source => self.class)
+          end
+        end
+        convert_to_type data, return_type
+      end
+
+      private
+
+      # Convert object(non-array) to hash.
+      # @param [Object] obj object to be converted into JSON string
+      # @return [String] JSON string representation of the object
+      def object_to_hash(obj)
+        if obj.respond_to?(:to_hash)
+          obj.to_hash
+        else
+          obj
+        end
+      end
+
+      # Convert data to the given return type.
+      def convert_to_type(data, return_type)
+        return nil if data.nil?
+        case return_type.to_s
+        when 'String'
+          data.to_s
+        when 'Integer'
+          data.to_i
+        when 'Float'
+          data.to_f
+        when 'BOOLEAN'
+          data == true
+        when 'DateTime'
+          # parse date time (expecting ISO 8601 format)
+          DateTime.parse data
+        when 'Date'
+          # parse date time (expecting ISO 8601 format)
+          Date.parse data
+        when 'Object'
+          # generic object, return directly
+          data
+        when /\AArray<(.+)>\z/
+          # e.g. Array<Pet>
+          sub_type = $1
+          data.map {|item| convert_to_type(item, sub_type) }
+        when /\AHash\<String, (.+)\>\z/
+          # e.g. Hash<String, Integer>
+          sub_type = $1
+          {}.tap do |hash|
+            data.each {|k, v| hash[k] = convert_to_type(v, sub_type) }
+          end
+        else
+          return_type.new.tap do |model|
+            model.build_from_hash data
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/mastercard_core_sdk/converters/sdk_converter_factory.rb

@@ -0,0 +1,57 @@
+require 'logging'
+require_relative  '../exceptions/sdk_conversion_error'
+
+module MastercardCoreSdk
+  module Converters
+    # Decides converter as per content-type of request/response.
+    class SDKConverterFactory
+
+      @@logger = Logging.logger[self]
+      @@content_handlers = {} 
+      
+      CONTENT_TYPE_XML = "XML"
+      CONTENT_TYPE_JSON = "JSON"
+      CONTENT_TYPE_URL_ENCODED = "WWW-FORM-URLENCODED"
+      ERR_MSG_CONTENT_TYPE = "Content-type is not supported :"
+     
+      class << self
+        include MastercardCoreSdk::Exceptions
+        
+        # Get converter as per content-type.
+        # @param content_type String specifying content-type for request.
+        # @return [Hash]
+        def get_converter(content_type)
+          converter = nil
+          if content_type
+            return @@content_handlers[content_type] if @@content_handlers.key?(content_type)
+            if content_type.include?(CONTENT_TYPE_XML)
+              converter = XmlConverter.new
+            elsif content_type.include?(CONTENT_TYPE_JSON)
+              converter = JsonConverter.new
+            elsif content_type.include?(CONTENT_TYPE_URL_ENCODED)
+              converter = EncodedURLConverter.new
+            else
+              @@logger.debug "#{ERR_MSG_CONTENT_TYPE} #{content_type}"
+              raise SDKConversionError.new(:error_message => "#{ERR_MSG_CONTENT_TYPE} #{content_type}", :source => self.class)
+            end
+            set_converter(content_type, converter)
+            return converter
+          end
+        end
+
+        # Set the converter as per content-type.
+        # @param content_type Content-Type for request.
+        # @param converter specifies appropriate converter for the content-type.
+        def set_converter(content_type, converter)
+          if @@content_handlers.key?(content_type)
+            @@content_handlers[content_type] = converter
+          else
+            @@content_handlers.merge!({content_type => converter})
+          end
+        end
+        
+      end
+    end
+  end
+end
+