mastercard_masterpass_merchant 1.0.0

data/lib/mastercard_masterpass_merchant/models/address_extension_point.rb

@@ -0,0 +1,176 @@
+require 'date'
+require 'roxml'
+ 
+
+module MastercardMasterpassMerchant
+  # This class contains methods to get additional address details.
+  class AddressExtensionPoint
+    include ROXML
+    
+    xml_name "AddressExtensionPoint"
+    
+    # @!attribute line4
+    # @return [String] the address line 4 used to additional address information.
+    xml_accessor :line4, :from =>"Line4"
+   
+    # @!attribute line5
+    # @return [String] the address line 5 used to remaining address information.
+    xml_accessor :line5, :from =>"Line5"
+   
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :line4 => :Line4 ,
+        :line5 => :Line5 
+        
+      }
+    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?(:Line4) ||  attributes.has_key?(:line4)
+        self.line4 = attributes[:Line4] || attributes[:line4]
+      end
+      
+      if attributes.has_key?(:Line5) ||  attributes.has_key?(:line5)
+        self.line5 = attributes[:Line5] || attributes[:line5]
+      end
+      
+    end
+    
+ 
+	
+
+    # Check equality by comparing each attribute.
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          line4 == o.line4 &&
+          line5 == o.line5
+    end
+
+    # @see the `==` method
+    def eql?(o)
+      self == o
+    end
+
+    # Calculate hash code according to all attributes.
+    def hash
+      [line4, line5].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 =~ /^(true|t|yes|y|1)$/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 = MastercardMasterpassMerchant.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
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        next if value.nil?
+        hash[param] = _to_hash(value)
+      end
+      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
+      {
+        :line4 => 'String',
+        :line5 => 'String'
+        
+      }
+    end
+  end
+
+
+end

data/lib/mastercard_masterpass_merchant/models/authentication_options.rb

@@ -0,0 +1,265 @@
+require 'date'
+require 'roxml'
+require_relative '../../mastercard_masterpass_merchant/models/extension_point'
+ 
+
+module MastercardMasterpassMerchant
+  # This class contains methods to set different authentication options required during DSRP.
+  class AuthenticationOptions
+    include ROXML
+    
+    xml_name "AuthenticationOptions"
+    
+    # @!attribute authenticate_method
+    # @return [String] the method used to authenticate the cardholder at checkout. Valid values are MERCHANT ONLY, 3DS and No Authentication.
+    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.
+    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.
+    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)
+    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.
+    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.
+    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).
+    xml_accessor :sc_enrollment_status, :from =>"SCEnrollmentStatus"
+   
+    # @!attribute signature_verification
+    # @return [String] the signature verification. Possible values are as follows: Y-Indicates that the signature of the PaRes has been validated successfully and the message contents can be trusted. N-Indicates that for a variety of reasons (tampering, certificate expiration, and so on) the PaRes could not be validated, and the result should not be trusted.
+    xml_accessor :signature_verification, :from =>"SignatureVerification"
+   
+    # @!attribute xid
+    # @return [String] the transaction identifier resulting from authentication processing.
+    xml_accessor :xid, :from =>"Xid"
+   
+    # @!attribute extension_point
+    # @return [ExtensionPoint] the ExtensionPoint for future enhancement.
+    xml_accessor :extension_point, :from =>"ExtensionPoint",:as => ExtensionPoint
+   
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :authenticate_method => :AuthenticateMethod ,
+        :card_enrollment_method => :CardEnrollmentMethod ,
+        :c_avv => :CAvv ,
+        :eci_flag => :EciFlag ,
+        :master_card_assigned_id => :MasterCardAssignedID ,
+        :pa_res_status => :PaResStatus ,
+        :sc_enrollment_status => :SCEnrollmentStatus ,
+        :signature_verification => :SignatureVerification ,
+        :xid => :Xid ,
+        :extension_point => :ExtensionPoint 
+        
+      }
+    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?(:AuthenticateMethod) ||  attributes.has_key?(:authenticate_method)
+        self.authenticate_method = attributes[:AuthenticateMethod] || attributes[:authenticate_method]
+      end
+      
+      if attributes.has_key?(:CardEnrollmentMethod) ||  attributes.has_key?(:card_enrollment_method)
+        self.card_enrollment_method = attributes[:CardEnrollmentMethod] || attributes[:card_enrollment_method]
+      end
+      
+      if attributes.has_key?(:CAvv) ||  attributes.has_key?(:c_avv)
+        self.c_avv = attributes[:CAvv] || attributes[:c_avv]
+      end
+      
+      if attributes.has_key?(:EciFlag) ||  attributes.has_key?(:eci_flag)
+        self.eci_flag = attributes[:EciFlag] || attributes[:eci_flag]
+      end
+      
+      if attributes.has_key?(:MasterCardAssignedID) ||  attributes.has_key?(:master_card_assigned_id)
+        self.master_card_assigned_id = attributes[:MasterCardAssignedID] || attributes[:master_card_assigned_id]
+      end
+      
+      if attributes.has_key?(:PaResStatus) ||  attributes.has_key?(:pa_res_status)
+        self.pa_res_status = attributes[:PaResStatus] || attributes[:pa_res_status]
+      end
+      
+      if attributes.has_key?(:SCEnrollmentStatus) ||  attributes.has_key?(:sc_enrollment_status)
+        self.sc_enrollment_status = attributes[:SCEnrollmentStatus] || attributes[:sc_enrollment_status]
+      end
+      
+      if attributes.has_key?(:SignatureVerification) ||  attributes.has_key?(:signature_verification)
+        self.signature_verification = attributes[:SignatureVerification] || attributes[:signature_verification]
+      end
+      
+      if attributes.has_key?(:Xid) ||  attributes.has_key?(:xid)
+        self.xid = attributes[:Xid] || attributes[:xid]
+      end
+      
+      if attributes.has_key?(:ExtensionPoint) ||  attributes.has_key?(:extension_point)
+        self.extension_point = attributes[:ExtensionPoint] || attributes[:extension_point]
+      end
+      
+    end
+    
+ 
+	
+
+    # Check equality by comparing each attribute.
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          authenticate_method == o.authenticate_method &&
+          card_enrollment_method == o.card_enrollment_method &&
+          c_avv == o.c_avv &&
+          eci_flag == o.eci_flag &&
+          master_card_assigned_id == o.master_card_assigned_id &&
+          pa_res_status == o.pa_res_status &&
+          sc_enrollment_status == o.sc_enrollment_status &&
+          signature_verification == o.signature_verification &&
+          xid == o.xid &&
+          extension_point == o.extension_point
+    end
+
+    # @see the `==` method
+    def eql?(o)
+      self == o
+    end
+
+    # Calculate hash code according to all attributes.
+    def hash
+      [authenticate_method, card_enrollment_method, c_avv, eci_flag, master_card_assigned_id, pa_res_status, sc_enrollment_status, signature_verification, xid, extension_point].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 =~ /^(true|t|yes|y|1)$/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 = MastercardMasterpassMerchant.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
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        next if value.nil?
+        hash[param] = _to_hash(value)
+      end
+      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
+      {
+        :authenticate_method => 'String',
+        :card_enrollment_method => 'String',
+        :c_avv => 'String',
+        :eci_flag => 'String',
+        :master_card_assigned_id => 'String',
+        :pa_res_status => 'String',
+        :sc_enrollment_status => 'String',
+        :signature_verification => 'String',
+        :xid => 'String',
+        :extension_point => 'ExtensionPoint'
+        
+      }
+    end
+  end
+
+
+end

data/lib/mastercard_masterpass_merchant/models/base_card.rb

@@ -0,0 +1,221 @@
+require 'date'
+require 'roxml'
+require_relative '../../mastercard_masterpass_merchant/models/address'
+ 
+
+module MastercardMasterpassMerchant
+  # This class contains methods to get consumer card brand information.
+  class BaseCard
+    include ROXML
+    
+    xml_name "BaseCard"
+    
+    # @!attribute brand_id
+    # @return [String] the card brand id, for example, master for MasterCard.
+    xml_accessor :brand_id, :from =>"BrandId"
+   
+    # @!attribute brand_name
+    # @return [String] the card brand name, for example, MasterCard.
+    xml_accessor :brand_name, :from =>"BrandName"
+   
+    # @!attribute billing_address
+    # @return [Address] the billing address for the card holder.
+    xml_accessor :billing_address, :from =>"BillingAddress",:as => Address
+   
+    # @!attribute card_holder_name
+    # @return [String] the cardholder name.
+    xml_accessor :card_holder_name, :from =>"CardHolderName"
+   
+    # @!attribute expiry_month
+    # @return [Integer] the expiration month displayed on the payment card.
+    xml_accessor :expiry_month, :from =>"ExpiryMonth"
+   
+    # @!attribute expiry_year
+    # @return [Integer] the expiration year displayed on the payment card.
+    xml_accessor :expiry_year, :from =>"ExpiryYear"
+   
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :brand_id => :BrandId ,
+        :brand_name => :BrandName ,
+        :billing_address => :BillingAddress ,
+        :card_holder_name => :CardHolderName ,
+        :expiry_month => :ExpiryMonth ,
+        :expiry_year => :ExpiryYear 
+        
+      }
+    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?(:BrandId) ||  attributes.has_key?(:brand_id)
+        self.brand_id = attributes[:BrandId] || attributes[:brand_id]
+      end
+      
+      if attributes.has_key?(:BrandName) ||  attributes.has_key?(:brand_name)
+        self.brand_name = attributes[:BrandName] || attributes[:brand_name]
+      end
+      
+      if attributes.has_key?(:BillingAddress) ||  attributes.has_key?(:billing_address)
+        self.billing_address = attributes[:BillingAddress] || attributes[:billing_address]
+      end
+      
+      if attributes.has_key?(:CardHolderName) ||  attributes.has_key?(:card_holder_name)
+        self.card_holder_name = attributes[:CardHolderName] || attributes[:card_holder_name]
+      end
+      
+      if attributes.has_key?(:ExpiryMonth) ||  attributes.has_key?(:expiry_month)
+        self.expiry_month = attributes[:ExpiryMonth] || attributes[:expiry_month]
+      end
+      
+      if attributes.has_key?(:ExpiryYear) ||  attributes.has_key?(:expiry_year)
+        self.expiry_year = attributes[:ExpiryYear] || attributes[:expiry_year]
+      end
+      
+    end
+    
+ 
+	
+
+    # Check equality by comparing each attribute.
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          brand_id == o.brand_id &&
+          brand_name == o.brand_name &&
+          billing_address == o.billing_address &&
+          card_holder_name == o.card_holder_name &&
+          expiry_month == o.expiry_month &&
+          expiry_year == o.expiry_year
+    end
+
+    # @see the `==` method
+    def eql?(o)
+      self == o
+    end
+
+    # Calculate hash code according to all attributes.
+    def hash
+      [brand_id, brand_name, billing_address, card_holder_name, expiry_month, expiry_year].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 =~ /^(true|t|yes|y|1)$/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 = MastercardMasterpassMerchant.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
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        next if value.nil?
+        hash[param] = _to_hash(value)
+      end
+      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
+      {
+        :brand_id => 'String',
+        :brand_name => 'String',
+        :billing_address => 'Address',
+        :card_holder_name => 'String',
+        :expiry_month => 'Integer',
+        :expiry_year => 'Integer'
+        
+      }
+    end
+  end
+
+
+end