mastercard_merchant_checkout 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6d3013606b83bbc5205c1fb604e17c3bc39c09ad
-  data.tar.gz: dce52cdb88b5ebb3f90fd24cb85661a3450f45d0
+  metadata.gz: 27bbe228d523693b4108b56ea63ff0dc4fd02772
+  data.tar.gz: e5bb3b93176a29f51303de61dc0a2487a8c0269c
 SHA512:
-  metadata.gz: 087a2cd184634dde1a36585a2b66e866157c607ebd12ecab21a7b6698e0ab5851886f726455701e3137f6f04fe95db0dbcabe36002a8b790b0625dbd57483b54
-  data.tar.gz: 82282ca011385ef0952a1ab19b75f077865af73fd5fb3ecd95d46933be272bfa6db528d270108507e6efc629763e5981793f7e17e0233e8e1b4f4510a66a33a8
+  metadata.gz: a4868a2b3b844b7b8edc95ef40749c2b4ba3e2c27276b18becbd5f8dc3105a56f2eff8591b0e7c0a148ed45cf4fc2a6c932d5424dee58cbed8b290c57650df19
+  data.tar.gz: 491ba2af42fd52ad8115e46c83769a5d5fcc786c559683be9f3183547135ce6ee3ef810edbfb19e4cd2fb86cd7e72d46d03dd27060a51c2b477132dba025db85

data/README.md

@@ -8,13 +8,13 @@
   to re-enter payment, shipping or loyalty program details during checkout.
   The Masterpass solution is simple, secure and easy for merchants to integrate into their existing website or application.
  
- For more information, refer [Masterpass Merchant Integration](https://developer.mastercard.com/documentation/masterpass-merchant-integration/v7).
+ For more information, refer [Masterpass Merchant Integration](https://developer.mastercard.com/documentation/masterpass-merchant-integration).
   
 ## Features
 
  Simplified merchant checkout flow with new Masterpass checkout API services.
  
- Supports Masterpass Standard checkout.
+ Supports Masterpass Standard and Express checkout.
 
 ## Installation
 

data/lib/mastercard_merchant_checkout.rb

@@ -14,14 +14,38 @@ require_relative 'mastercard_merchant_checkout/models/personal_info'
 
 require_relative 'mastercard_merchant_checkout/models/postback'
 
+require_relative 'mastercard_merchant_checkout/models/tokenization'
+
+require_relative 'mastercard_merchant_checkout/models/cryptogram'
+
 require_relative 'mastercard_merchant_checkout/models/authentication_options'
 
+require_relative 'mastercard_merchant_checkout/models/pairing'
+
+require_relative 'mastercard_merchant_checkout/models/express_checkout_request'
+
+require_relative 'mastercard_merchant_checkout/models/pre_checkout_data'
+
+require_relative 'mastercard_merchant_checkout/models/contact_info'
+
+require_relative 'mastercard_merchant_checkout/models/recipient_info'
+
+require_relative 'mastercard_merchant_checkout/models/shipping_address'
+
+require_relative 'mastercard_merchant_checkout/models/pre_checkout_card'
+
 
 # APIs
 
 
+require_relative 'mastercard_merchant_checkout/api/pre_checkout_data_api'
+
+require_relative 'mastercard_merchant_checkout/api/express_checkout_api'
+
 require_relative 'mastercard_merchant_checkout/api/postback_api'
 
+require_relative 'mastercard_merchant_checkout/api/pairing_id_api'
+
 require_relative 'mastercard_merchant_checkout/api/payment_data_api'
 
 

data/lib/mastercard_merchant_checkout/api/express_checkout_api.rb

@@ -0,0 +1,40 @@
+require 'uri'
+require 'mastercard_core_sdk'
+require_relative '../../mastercard_merchant_checkout/models/express_checkout_request'
+require_relative '../../mastercard_merchant_checkout/models/payment_data'
+ 
+
+module MastercardMerchantCheckout
+ module Api
+
+  class ExpressCheckoutApi
+    include MastercardCoreSdk::Core, MastercardCoreSdk::Client, MastercardCoreSdk::Exceptions
+	  include MastercardMerchantCheckout::Tracker
+
+
+    # ExpressCheckout Service
+    # Use this service to retrieve the consumer's full payment card, shipping address, and recipient personal information from Masterpass when performing an Express Checkout. If the merchant is PCI-compliant, then this API will return the complete payload. If the merchant is not PCI-compliant, then this API will only return non-PCI data. In both cases, a new pairingId will be returned to the merchant. API URL: /masterpass/expresscheckout
+    # @param express_checkout_request Express Checkout Request.
+    # @param api_config Optional ApiConfig object specifying configuration : consumer key, private key, host URL. 
+    # @return [PaymentData]
+    def self.create(express_checkout_request, api_config = nil)
+		 path = "/masterpass/expresscheckout"
+	 	 service_request = ServiceRequest.new
+     
+	   
+	   service_request.body = express_checkout_request
+	 
+	   service_request.content_type = "application/json"
+	   api_client = ApiClient.new(api_config)
+     api_client.api_tracker = SdkApiTracker.new
+     api_client.error_handler = ErrorHandler.new
+	   return api_client.call(path, service_request, "POST",PaymentData)
+    end
+
+  end
+
+ end
+end
+
+
+

data/lib/mastercard_merchant_checkout/api/pairing_id_api.rb

@@ -0,0 +1,38 @@
+require 'uri'
+require 'mastercard_core_sdk'
+require_relative '../../mastercard_merchant_checkout/models/pairing'
+ 
+
+module MastercardMerchantCheckout
+ module Api
+
+  class PairingIdApi
+    include MastercardCoreSdk::Core, MastercardCoreSdk::Client, MastercardCoreSdk::Exceptions
+	  include MastercardMerchantCheckout::Tracker
+
+
+    # PairingId Service
+    # Use this service to get a consumer’s pairing identifier from Masterpass when they choose to share the payment and shipping information from their Masterpass wallet for future use in an Express Checkout. API URL: /masterpass/pairingid
+    # @param query_params The query parameters.
+    # @param api_config Optional ApiConfig object specifying configuration : consumer key, private key, host URL. 
+    # @return [Pairing]
+    def self.show(query_params, api_config = nil)
+		 path = "/masterpass/pairingid"
+	 	 service_request = ServiceRequest.new
+     
+	   
+	 service_request.query_params = query_params
+	   service_request.content_type = "application/json"
+	   api_client = ApiClient.new(api_config)
+     api_client.api_tracker = SdkApiTracker.new
+     api_client.error_handler = ErrorHandler.new
+	   return api_client.call(path, service_request, "GET",Pairing)
+    end
+
+  end
+
+ end
+end
+
+
+

data/lib/mastercard_merchant_checkout/api/payment_data_api.rb

@@ -12,8 +12,8 @@ module MastercardMerchantCheckout
 
 
     # PaymentData Service
-    # This service is used to retrieve the consumer's payment, shipping address, and recipient personal information from Masterpass.
-    # @param transaction_id This is a transaction identifier.
+    # Use this service to retrieve the consumer's payment card, and shipping details from Masterpass. New or existing Brazil merchants looking for the house number and street name as separate fields should leverage these two additional extension points in their Masterpass checkout integration. Line 4 will provide the house number and line 5 will provide the street name. Brazil merchants should first look for data in lines 4 and 5, and in the case that no data is found there, merchants should then look for data in line 1. API URL: /masterpass/paymentdata/:transaction_id
+    # @param transaction_id Identifies the transaction for which to return the consumer’s payment data. This is the oauth_verifier value sent by Masterpass in the callback URL after the Masterpass UI is closed.
     # @param query_params The query parameters.
     # @param api_config Optional ApiConfig object specifying configuration : consumer key, private key, host URL. 
     # @return [PaymentData]

data/lib/mastercard_merchant_checkout/api/postback_api.rb

@@ -12,7 +12,7 @@ module MastercardMerchantCheckout
 
 
     # Postback Service
-    # The final step of the Masterpass transaction, Masterpass Postback is a service call from the merchant to Masterpass communicating the result of the transaction (success or failure). This is a mandatory step. Abandoned transactions do not need to be reported.
+    # This is the final step in the transaction and reports the result of their transactions to Masterpass. Postback is required for all transactions (abandoned transactions do not need to be reported). API URL: /masterpass/postback
     # @param postback This is the merchant's transaction details.
     # @param api_config Optional ApiConfig object specifying configuration : consumer key, private key, host URL. 
     # @return [nil]

data/lib/mastercard_merchant_checkout/api/pre_checkout_data_api.rb

@@ -0,0 +1,39 @@
+require 'uri'
+require 'mastercard_core_sdk'
+require_relative '../../mastercard_merchant_checkout/models/pre_checkout_data'
+ 
+
+module MastercardMerchantCheckout
+ module Api
+
+  class PreCheckoutDataApi
+    include MastercardCoreSdk::Core, MastercardCoreSdk::Client, MastercardCoreSdk::Exceptions
+	  include MastercardMerchantCheckout::Tracker
+
+
+    # PreCheckout Data Service
+    # Use the consumer’s pairingID to retrieve their shipping and payment information prior to complete an Express Checkout.  You can use the data returned from this service to confirm the user’s payment selections before completing the checkout. API URL: /masterpass/precheckoutdata/:pairing_id
+    # @param pairing_id The unique pairing token identifier used to fetch pre-checkout data for a wallet that is paired with a merchant.
+    # @param api_config Optional ApiConfig object specifying configuration : consumer key, private key, host URL. 
+    # @return [PreCheckoutData]
+    def self.show(pairing_id, api_config = nil)
+		 path = "/masterpass/precheckoutdata/{pairingId}"
+	 	 service_request = ServiceRequest.new
+     service_request.path_params["pairingId"] = pairing_id
+	 
+	   
+	 
+	   service_request.content_type = "application/json"
+	   api_client = ApiClient.new(api_config)
+     api_client.api_tracker = SdkApiTracker.new
+     api_client.error_handler = ErrorHandler.new
+	   return api_client.call(path, service_request, "GET",PreCheckoutData)
+    end
+
+  end
+
+ end
+end
+
+
+

data/lib/mastercard_merchant_checkout/models/address.rb

@@ -14,35 +14,35 @@ module MastercardMerchantCheckout
     xml_accessor :city, :from =>"city"
    
     # @!attribute country
-    # @return [String] the cardholder's country as defined by ISO 3166-1 alpha-2 digit country codes; for example, US is the United States, AU is Australia, CA is Canada, GB is the United Kingdom, and so on.
+    # @return [String] the cardholder's country as defined by ISO 3166-1 alpha-2 country codes.
     xml_accessor :country, :from =>"country"
    
     # @!attribute subdivision
-    # @return [String] the cardholder's country's subdivision as defined by ISO 3166-1 alpha-2 digit code; for example, US-VA is Virginia, US-OH is Ohio, and so on.
+    # @return [String] the cardholder's country's subdivision as defined by ISO 3166-1 alpha-2 code for US, CA, AU, JP, and BR. All other countries use a freeform text field.
     xml_accessor :subdivision, :from =>"subdivision"
    
     # @!attribute line1
-    # @return [String] the address in line 1 is used for the street number and the street name.
+    # @return [String] the cardholder’s house number and the street name.
     xml_accessor :line1, :from =>"line1"
    
     # @!attribute line2
-    # @return [String] the address in line 2 is used for the apartment number, suite Number, and so on.
+    # @return [String] the cardholder’s apartment number, suite number, etc.
     xml_accessor :line2, :from =>"line2"
    
     # @!attribute line3
-    # @return [String] the address in line 3 is used to enter the remaining address information if it does not fit in lines 1 and 2.
+    # @return [String] the cardholder’s remaining address information that does not fit in lines 1 and 2.
     xml_accessor :line3, :from =>"line3"
    
     # @!attribute line4
-    # @return [String] the address in line 4 is used to enter the remaining address information if it does not fit in lines 1, 2 and 3.
+    # @return [String] the line4 is only returned for addresses in Brazil, and provides the cardholder’s billing house number. If no data is returned for this field, then reference card​.billingAddress​.line1
     xml_accessor :line4, :from =>"line4"
    
     # @!attribute line5
-    # @return [String] the address in line 5 is used to enter the remaining address information if it does not fit in line 1,2,3 and 4.
+    # @return [String] the line5 is only returned for addresses in Brazil, and provides the cardholder’s billing street name. If no data is returned for this field, then reference card​.billingAddress​.line1
     xml_accessor :line5, :from =>"line5"
    
     # @!attribute postal_code
-    # @return [String] the postal code or zip code appended to the mailing address for the purpose of sorting mail.
+    # @return [String] the cardholder’s postal code or zip code.
     xml_accessor :postal_code, :from =>"postalCode"
    
 
@@ -168,7 +168,7 @@ module MastercardMerchantCheckout
       when :Float
         value.to_f
       when :BOOLEAN
-        if value =~ /^(true|t|yes|y|1)$/i
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
           true
         else
           false

data/lib/mastercard_merchant_checkout/models/authentication_options.rb

@@ -3,7 +3,7 @@ require 'roxml'
  
 
 module MastercardMerchantCheckout
-  # This class contains methods to set different authentication options required during DSRP.
+  # The authentication information required during DSRP.
   class AuthenticationOptions
     include ROXML
     
@@ -14,27 +14,27 @@ module MastercardMerchantCheckout
     xml_accessor :authenticate_method, :from =>"authenticateMethod"
    
     # @!attribute card_enrollment_method
-    # @return [String] the method by which the card was added to the wallet. Valid values are: Manual Direct Provisioned 3DS Manual NFC Tap.
+    # @return [String] the method by which the card was added to the wallet. Valid values are: Manual Direct Provisioned 3DS Manual, and NFC Tap.
     xml_accessor :card_enrollment_method, :from =>"cardEnrollmentMethod"
    
     # @!attribute c_avv
-    # @return [String] the (CAVV) Cardholder Authentication Verification Value generated by card issuer upon successful authentication of the cardholder. This must be passed in the authorization message.
+    # @return [String] the (CAVV) Cardholder Authentication Verification Value generated by the card issuer upon successful authentication of the cardholder. This must be passed in the authorization message.
     xml_accessor :c_avv, :from =>"cAvv"
    
     # @!attribute eci_flag
-    # @return [String] the Electronic commerce indicator (ECI) flag. Possible values are as follows: MasterCard: 00:No Authentication 01:Attempts (Card Issuer Liability) 02:Authenticated by ACS (Card Issuer Liability) 03:Maestro (MARP) 05:Risk Based Authentication (Issuer, not in use) 06:Risk Based Authentication (Merchant, not in use) Visa: 05:Authenticated (Card Issuer Liability) 06:Attempts (Card Issuer Liability) 07:No 3DS Authentication (Merchant Liability)
+    # @return [String] the Electronic commerce indicator (ECI) flag. Possible values are as follows: Mastercard: 00:No Authentication 01:Attempts (Card Issuer Liability) 02:Authenticated by ACS (Card Issuer Liability) 03:Maestro (MARP) 05:Risk Based Authentication (Issuer, not in use) 06:Risk Based Authentication (Merchant, not in use) Visa: 05:Authenticated (Card Issuer Liability) 06:Attempts (Card Issuer Liability) 07:No 3DS Authentication (Merchant Liability)
     xml_accessor :eci_flag, :from =>"eciFlag"
    
     # @!attribute master_card_assigned_id
-    # @return [String] the value assigned by MasterCard and represents programs associated directly with Maestro cards. This field should be supplied in the authorization request by the merchant.
+    # @return [String] the value assigned by Mastercard and represents programs associated directly with Maestro cards. This field should be supplied in the authorization request by the merchant.
     xml_accessor :master_card_assigned_id, :from =>"masterCardAssignedID"
    
     # @!attribute pa_res_status
-    # @return [String] the message formatted, digitally signed, and sent from the ACS (issuer) to the MPI providing the results of the issuer's MasterCard SecureCode/Verified by Visa cardholder authentication. Possible values are: Y-The card was successfully authenticated via 3-D Secure A-signifies that either (a) the transaction was successfully authenticated via a 3-D Secure attempts transaction or (b)the cardholder was prompted to activate 3-D Secure during shopping but declined (Visa). U-Authentication results were unavailable.
+    # @return [String] the message formatted, digitally signed, and sent from the ACS (issuer) to the MPI providing the results of the issuer's Mastercard SecureCode/Verified by Visa cardholder authentication. Possible values are: Y-The card was successfully authenticated via 3-D Secure A-signifies that either (a) the transaction was successfully authenticated via a 3-D Secure attempts transaction or (b)the cardholder was prompted to activate 3-D Secure during shopping but declined (Visa). U-Authentication results were unavailable.
     xml_accessor :pa_res_status, :from =>"paResStatus"
    
     # @!attribute sc_enrollment_status
-    # @return [String] the MasterCard SecureCode Enrollment Status. Indicates if the issuer of the card supports payer authentication for this card. Possible values are as follows: Y-The card is eligible for 3-D Secure authentication. N-The card is not eligible for 3-D Secure authentication. U-Lookup of the card's 3-D Secure eligibility status was either unavailable, or the card is inapplicable (for example, prepaid cards).
+    # @return [String] the Mastercard SecureCode Enrollment Status. Indicates if the issuer of the card supports payer authentication for this card. Possible values are as follows: Y-The card is eligible for 3-D Secure authentication. N-The card is not eligible for 3-D Secure authentication. U-Lookup of the card's 3-D Secure eligibility status was either unavailable, or the card is inapplicable (for example, prepaid cards).
     xml_accessor :sc_enrollment_status, :from =>"scEnrollmentStatus"
    
     # @!attribute signature_verification
@@ -168,7 +168,7 @@ module MastercardMerchantCheckout
       when :Float
         value.to_f
       when :BOOLEAN
-        if value =~ /^(true|t|yes|y|1)$/i
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
           true
         else
           false

data/lib/mastercard_merchant_checkout/models/card.rb

@@ -11,15 +11,15 @@ module MastercardMerchantCheckout
     xml_name "Card"
     
     # @!attribute brand_id
-    # @return [String] the card's brand id; for example, master for MasterCard.
+    # @return [String] the card brand id referenced by Masterpass (master, amex, diners, discover, jcb, maestro, visa).
     xml_accessor :brand_id, :from =>"brandId"
    
     # @!attribute brand_name
-    # @return [String] the card's brand name; for example, MasterCard.
+    # @return [String] the card brand full name (Mastercard, American Express, Diners Club, Discover, JCB, Maestro, Visa).
     xml_accessor :brand_name, :from =>"brandName"
    
     # @!attribute account_number
-    # @return [String] the PAN.
+    # @return [String] the card number, also known as Primary Account Number (PAN)
     xml_accessor :account_number, :from =>"accountNumber"
    
     # @!attribute card_holder_name
@@ -27,17 +27,21 @@ module MastercardMerchantCheckout
     xml_accessor :card_holder_name, :from =>"cardHolderName"
    
     # @!attribute expiry_month
-    # @return [Integer] the expiration month displayed on the payment card.
+    # @return [Integer] the PAN expiration month, returned as a two-digit string.
     xml_accessor :expiry_month, :from =>"expiryMonth"
    
     # @!attribute expiry_year
-    # @return [Integer] the expiration year displayed on the payment card.
+    # @return [Integer] the PAN expiration year, returned as a two-digit string (for the year 2020, Masterpass will return 20).
     xml_accessor :expiry_year, :from =>"expiryYear"
    
     # @!attribute billing_address
-    # @return [Address] the card's billing details.
+    # @return [Address] the billing address associated with the card.
     xml_accessor :billing_address, :from =>"billingAddress",:as => Address
    
+    # @!attribute last_four
+    # @return [String] the last four digits of the PAN.
+    xml_accessor :last_four, :from =>"lastFour"
+   
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
@@ -48,7 +52,8 @@ module MastercardMerchantCheckout
         :card_holder_name => :cardHolderName ,
         :expiry_month => :expiryMonth ,
         :expiry_year => :expiryYear ,
-        :billing_address => :billingAddress 
+        :billing_address => :billingAddress ,
+        :last_four => :lastFour 
         
       }
     end
@@ -88,6 +93,10 @@ module MastercardMerchantCheckout
         self.billing_address = attributes[:billing_address]
       end
       
+      if attributes.has_key?(:last_four)
+        self.last_four = attributes[:last_four]
+      end
+      
     end
     
  
@@ -103,7 +112,8 @@ module MastercardMerchantCheckout
           card_holder_name == o.card_holder_name &&
           expiry_month == o.expiry_month &&
           expiry_year == o.expiry_year &&
-          billing_address == o.billing_address
+          billing_address == o.billing_address &&
+          last_four == o.last_four
     end
 
     # @see the `==` method
@@ -113,7 +123,7 @@ module MastercardMerchantCheckout
 
     # Calculate hash code according to all attributes.
     def hash
-      [brand_id, brand_name, account_number, card_holder_name, expiry_month, expiry_year, billing_address].hash
+      [brand_id, brand_name, account_number, card_holder_name, expiry_month, expiry_year, billing_address, last_four].hash
     end
 
     # build the object from hash
@@ -149,7 +159,7 @@ module MastercardMerchantCheckout
       when :Float
         value.to_f
       when :BOOLEAN
-        if value =~ /^(true|t|yes|y|1)$/i
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
           true
         else
           false
@@ -224,7 +234,8 @@ module MastercardMerchantCheckout
         :card_holder_name => 'String',
         :expiry_month => 'Integer',
         :expiry_year => 'Integer',
-        :billing_address => 'Address'
+        :billing_address => 'Address',
+        :last_four => 'String'
         
       }
     end

data/lib/mastercard_merchant_checkout/models/contact_info.rb

@@ -0,0 +1,211 @@
+require 'date'
+require 'roxml'
+ 
+
+module MastercardMerchantCheckout
+  # The contact info details for the wallet user.
+  class ContactInfo
+    include ROXML
+    
+    xml_name "ContactInfo"
+    
+    # @!attribute first_name
+    # @return [String] the first name associated with the wallet user.
+    xml_accessor :first_name, :from =>"firstName"
+   
+    # @!attribute last_name
+    # @return [String] the last name associated with the wallet user.
+    xml_accessor :last_name, :from =>"lastName"
+   
+    # @!attribute country
+    # @return [String] the country associated with the wallet user.
+    xml_accessor :country, :from =>"country"
+   
+    # @!attribute email_address
+    # @return [String] the email address associated with the wallet user.
+    xml_accessor :email_address, :from =>"emailAddress"
+   
+    # @!attribute phone_number
+    # @return [String] the phone number associated with the wallet user.
+    xml_accessor :phone_number, :from =>"phoneNumber"
+   
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :first_name => :firstName ,
+        :last_name => :lastName ,
+        :country => :country ,
+        :email_address => :emailAddress ,
+        :phone_number => :phoneNumber 
+        
+      }
+    end
+
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      # convert string to symbol for hash key
+      attributes = attributes.inject({}){|memo,(k,v)| memo[k.to_sym] = v; memo}
+
+      
+      if attributes.has_key?(:first_name)
+        self.first_name = attributes[:first_name]
+      end
+      
+      if attributes.has_key?(:last_name)
+        self.last_name = attributes[:last_name]
+      end
+      
+      if attributes.has_key?(:country)
+        self.country = attributes[:country]
+      end
+      
+      if attributes.has_key?(:email_address)
+        self.email_address = attributes[:email_address]
+      end
+      
+      if attributes.has_key?(:phone_number)
+        self.phone_number = attributes[:phone_number]
+      end
+      
+    end
+    
+ 
+	
+
+    # Check equality by comparing each attribute.
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          first_name == o.first_name &&
+          last_name == o.last_name &&
+          country == o.country &&
+          email_address == o.email_address &&
+          phone_number == o.phone_number
+    end
+
+    # @see the `==` method
+    def eql?(o)
+      self == o
+    end
+
+    # Calculate hash code according to all attributes.
+    def hash
+      [first_name, last_name, country, email_address, phone_number].hash
+    end
+
+    # build the object from hash
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      self.class.datatype_map.each_pair do |key, type|
+        if type =~ /^Array<(.*)>/i
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map{ |v| _deserialize($1, v) } )
+          else
+            #TODO show warning in debug mode
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
+        else
+          # data not found in attributes(hash), not an issue as the data can be optional
+        end
+      end
+
+      self
+    end
+
+    def _deserialize(type, value)
+      case type.to_sym
+      when :DateTime
+        DateTime.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :BOOLEAN
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        _model = MastercardMerchantCheckout.const_get(type).new
+        _model.build_from_hash(value)
+      end
+    end
+
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_body (backward compatibility))
+    def to_body
+      to_hash
+    end
+
+    # return the object in the form of hash
+    def to_hash(include_root = false)
+      attributes_hash = {} 
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        next if value.nil?
+        hash[param] = _to_hash(value)
+      end
+      attributes_hash = include_root ? { "ContactInfo" => hash } : hash  
+      return attributes_hash
+    end
+
+    # Method to output non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map{ |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+
+    private
+    def after_parse
+      self.send(:remove_instance_variable, :@roxml_references) if defined? self.roxml_references
+    end
+    
+    # Attribute datatype mapping.
+    def self.datatype_map
+      {
+        :first_name => 'String',
+        :last_name => 'String',
+        :country => 'String',
+        :email_address => 'String',
+        :phone_number => 'String'
+        
+      }
+    end
+  end
+
+
+end