authorizenet 1.8.7 → 1.8.8

data/lib/authorize_net/sim/transaction.rb

@@ -1,138 +1,138 @@
-module AuthorizeNet::SIM
-
-  # The SIM transaction class. Handles building the transaction payload and
-  # generating a set of hidden form fields to be POSTed to the gateway.
-  class Transaction < AuthorizeNet::KeyValueTransaction
-    
-    RANDOM_SEQUENCE_MAX = (1 << 32) - 1
-    
-    # Our MD5 digest generator.
-    @@digest  = OpenSSL::Digest.new('md5')
-
-    # The default options for the constructor.
-    @@option_defaults = {
-      :sequence => nil,
-      :timestamp => nil,
-      :test => false,
-      :hosted_payment_form => false,
-      :relay_response => true,
-      :relay_url => nil,
-      :transaction_type => Type::AUTHORIZE_AND_CAPTURE
-    }
-    
-    # Constructs a SIM transaction. You can use the new SIM transaction object
-    # to build the hidden field payload needed to process a SIM transaction with
-    # the gateway. In particular, this class handles generating the MD5 fingerprint
-    # used to authenticate transactions at the gateway. Since the fingerprint includes
-    # the amount to charge, you should not construct this object until you know EXACTLY
-    # how much you want to charge (or authorize).
-    # 
-    # +api_login_id+:: Your API login ID, as a string.
-    # +api_transaction_key+:: Your API transaction key, as a string.
-    # +amount+:: The amount of the transaction, as a string, Float or BigDecimal.
-    # +options+:: A hash of options. See below for values.
-    # 
-    # Options
-    # +sequence+:: The sequence number of the transaction as a string or Fixnum. This is usually something like an invoice number. If none is provided, the SDK generates one at random.
-    # +timestamp+:: The time the transaction was initiated as a string or Fixnum. This needs to be within 15 minutes of when the gateway receives the transaction. If no value is provided, the SDK defaults it to Time.now().
-    # +test+:: A boolean indicating if the transaction should be run in test mode or not (defaults to false).
-    # +hosted_payment_form+:: A boolean indicating if the transaction should use a hosted payment form (defaults to false).
-    # +relay_response+:: A boolean indicating if the transaction should use the relay response feature to return a receipt to the customer (defaults to true). Direct Post Method requires using a relay response.
-    # +relay_url+:: A string of the URL that the gateway should hit to get the relay response (defaults to nil).
-    # +transaction_type+:: The type of transaction to perform. Defaults to AuthorizeNet::Type::AUTHORIZE_AND_CAPTURE. This value is only used if run is called directly.
-    # 
-    def initialize(api_login_id, api_transaction_key, amount, options = {})
-      super()
-      @api_transaction_key = api_transaction_key
-      @api_login_id = api_login_id
-      @amount = decimal_to_value(amount)
-      options = @@option_defaults.merge(options)
-      @sequence = options[:sequence]
-      @timestamp = options[:timestamp]
-      @test_mode = options[:test]
-      @hosted_payment_form = options[:hosted_payment_form]
-      @relay_url = options[:relay_url]
-      @type = options[:transaction_type]
-      unless @relay_url.nil?
-        @relay_response = true
-      else
-        @relay_response = !!options[:relay_response]
-      end
-      @delim_data = !@relay_response
-    end
-    
-    # Calculates and returns the HMAC-MD5 fingerprint needed to authenticate the transaction
-    # with the SIM gateway.
-    def fingerprint
-      if @timestamp.nil?
-        @timestamp = Time.now.to_i
-      end
-      
-      if @sequence.nil?
-        @sequence = rand(RANDOM_SEQUENCE_MAX)
-      end
-      OpenSSL::HMAC.hexdigest(@@digest, @api_transaction_key, "#{@api_login_id.to_s.rstrip}^#{@sequence.to_s.rstrip}^#{@timestamp.to_s.rstrip}^#{@amount.to_s.rstrip}^")
-    end
-    
-    # Returns all the fields needed for the fingerprint. These must all be passed to the SIM
-    # exactly as returned. And these values are time sensitive.
-    def fingerprint_fields
-      {
-        :login => @api_login_id,
-        :fp_hash => fingerprint,
-        :fp_sequence => @sequence,
-        :fp_timestamp => @timestamp,
-        :amount => @amount
-      }
-    end
-    
-    # Returns all the fields (including custom) exactly as they should be named
-    # in the SIM form. Fields with multiple values are returned with an array
-    # for the key's value.
-    def form_fields
-      form_fields = {}
-      form_fields[:x_test_request] = boolean_to_value(@test_mode)
-      if @hosted_payment_form
-        form_fields[:x_show_form] = 'PAYMENT_FORM'
-      end
-      if @relay_response && !@relay_url.nil?
-        form_fields[:x_relay_url] = @relay_url
-      end
-      fields.merge(:type => @type, :version => @version, :delim_data => boolean_to_value(@delim_data), :relay_response => boolean_to_value(@relay_response)).each do |k, v|
-        form_fields[to_external_field(k)] = v
-      end
-      fingerprint_fields.each do |k, v|
-        form_fields[to_external_field(k)] = v
-      end
-      form_fields.merge(custom_fields)
-    end
-    
-    
-    # Takes an instance of AuthorizeNet::SIM::HostedPaymentForm and adds it to the transaction. Note that
-    # many of the fields in AuthorizeNet::SIM::HostedPaymentForm are shared with those in
-    # AuthorizeNet::SIM::HostedReceiptPage. For the duplicate fields, which ever value
-    # is added to the transaction last will be the one used.
-    def set_hosted_payment_form(form)
-      @fields.merge!(form.to_hash)
-      @hosted_payment_form = true
-    end
-    
-    # Takes an instance of AuthorizeNet::SIM::HostedReceiptPage and adds it to the transaction. Note that
-    # many of the fields in AuthorizeNet::SIM::HostedReceiptPage are shared with those in
-    # AuthorizeNet::SIM::HostedPaymentForm. For the duplicate fields, which ever value
-    # is added to the transaction last will be the one used. If you set a hosted payment receipt,
-    # the relay response will be disabled.
-    def set_hosted_payment_receipt(form)
-      @fields.merge!(form.to_hash)
-      @relay_response = false
-      @delim_data = true
-    end
-    
-    # An alias for form_fields.
-    def run
-      form_fields
-    end
-  
-  end
-
+module AuthorizeNet::SIM
+
+  # The SIM transaction class. Handles building the transaction payload and
+  # generating a set of hidden form fields to be POSTed to the gateway.
+  class Transaction < AuthorizeNet::KeyValueTransaction
+    
+    RANDOM_SEQUENCE_MAX = (1 << 32) - 1
+    
+    # Our MD5 digest generator.
+    @@digest  = OpenSSL::Digest.new('md5')
+
+    # The default options for the constructor.
+    @@option_defaults = {
+      :sequence => nil,
+      :timestamp => nil,
+      :test => false,
+      :hosted_payment_form => false,
+      :relay_response => true,
+      :relay_url => nil,
+      :transaction_type => Type::AUTHORIZE_AND_CAPTURE
+    }
+    
+    # Constructs a SIM transaction. You can use the new SIM transaction object
+    # to build the hidden field payload needed to process a SIM transaction with
+    # the gateway. In particular, this class handles generating the MD5 fingerprint
+    # used to authenticate transactions at the gateway. Since the fingerprint includes
+    # the amount to charge, you should not construct this object until you know EXACTLY
+    # how much you want to charge (or authorize).
+    # 
+    # +api_login_id+:: Your API login ID, as a string.
+    # +api_transaction_key+:: Your API transaction key, as a string.
+    # +amount+:: The amount of the transaction, as a string, Float or BigDecimal.
+    # +options+:: A hash of options. See below for values.
+    # 
+    # Options
+    # +sequence+:: The sequence number of the transaction as a string or Fixnum. This is usually something like an invoice number. If none is provided, the SDK generates one at random.
+    # +timestamp+:: The time the transaction was initiated as a string or Fixnum. This needs to be within 15 minutes of when the gateway receives the transaction. If no value is provided, the SDK defaults it to Time.now().
+    # +test+:: A boolean indicating if the transaction should be run in test mode or not (defaults to false).
+    # +hosted_payment_form+:: A boolean indicating if the transaction should use a hosted payment form (defaults to false).
+    # +relay_response+:: A boolean indicating if the transaction should use the relay response feature to return a receipt to the customer (defaults to true). Direct Post Method requires using a relay response.
+    # +relay_url+:: A string of the URL that the gateway should hit to get the relay response (defaults to nil).
+    # +transaction_type+:: The type of transaction to perform. Defaults to AuthorizeNet::Type::AUTHORIZE_AND_CAPTURE. This value is only used if run is called directly.
+    # 
+    def initialize(api_login_id, api_transaction_key, amount, options = {})
+      super()
+      @api_transaction_key = api_transaction_key
+      @api_login_id = api_login_id
+      @amount = decimal_to_value(amount)
+      options = @@option_defaults.merge(options)
+      @sequence = options[:sequence]
+      @timestamp = options[:timestamp]
+      @test_mode = options[:test]
+      @hosted_payment_form = options[:hosted_payment_form]
+      @relay_url = options[:relay_url]
+      @type = options[:transaction_type]
+      unless @relay_url.nil?
+        @relay_response = true
+      else
+        @relay_response = !!options[:relay_response]
+      end
+      @delim_data = !@relay_response
+    end
+    
+    # Calculates and returns the HMAC-MD5 fingerprint needed to authenticate the transaction
+    # with the SIM gateway.
+    def fingerprint
+      if @timestamp.nil?
+        @timestamp = Time.now.to_i
+      end
+      
+      if @sequence.nil?
+        @sequence = rand(RANDOM_SEQUENCE_MAX)
+      end
+      OpenSSL::HMAC.hexdigest(@@digest, @api_transaction_key, "#{@api_login_id.to_s.rstrip}^#{@sequence.to_s.rstrip}^#{@timestamp.to_s.rstrip}^#{@amount.to_s.rstrip}^")
+    end
+    
+    # Returns all the fields needed for the fingerprint. These must all be passed to the SIM
+    # exactly as returned. And these values are time sensitive.
+    def fingerprint_fields
+      {
+        :login => @api_login_id,
+        :fp_hash => fingerprint,
+        :fp_sequence => @sequence,
+        :fp_timestamp => @timestamp,
+        :amount => @amount
+      }
+    end
+    
+    # Returns all the fields (including custom) exactly as they should be named
+    # in the SIM form. Fields with multiple values are returned with an array
+    # for the key's value.
+    def form_fields
+      form_fields = {}
+      form_fields[:x_test_request] = boolean_to_value(@test_mode)
+      if @hosted_payment_form
+        form_fields[:x_show_form] = 'PAYMENT_FORM'
+      end
+      if @relay_response && !@relay_url.nil?
+        form_fields[:x_relay_url] = @relay_url
+      end
+      fields.merge(:type => @type, :version => @version, :delim_data => boolean_to_value(@delim_data), :relay_response => boolean_to_value(@relay_response)).each do |k, v|
+        form_fields[to_external_field(k)] = v
+      end
+      fingerprint_fields.each do |k, v|
+        form_fields[to_external_field(k)] = v
+      end
+      form_fields.merge(custom_fields)
+    end
+    
+    
+    # Takes an instance of AuthorizeNet::SIM::HostedPaymentForm and adds it to the transaction. Note that
+    # many of the fields in AuthorizeNet::SIM::HostedPaymentForm are shared with those in
+    # AuthorizeNet::SIM::HostedReceiptPage. For the duplicate fields, which ever value
+    # is added to the transaction last will be the one used.
+    def set_hosted_payment_form(form)
+      @fields.merge!(form.to_hash)
+      @hosted_payment_form = true
+    end
+    
+    # Takes an instance of AuthorizeNet::SIM::HostedReceiptPage and adds it to the transaction. Note that
+    # many of the fields in AuthorizeNet::SIM::HostedReceiptPage are shared with those in
+    # AuthorizeNet::SIM::HostedPaymentForm. For the duplicate fields, which ever value
+    # is added to the transaction last will be the one used. If you set a hosted payment receipt,
+    # the relay response will be disabled.
+    def set_hosted_payment_receipt(form)
+      @fields.merge!(form.to_hash)
+      @relay_response = false
+      @delim_data = true
+    end
+    
+    # An alias for form_fields.
+    def run
+      form_fields
+    end
+  
+  end
+
 end

data/lib/authorize_net/transaction.rb

@@ -1,66 +1,66 @@
-module AuthorizeNet
-  
-  # The core, API agnostic transaction class. You shouldn't instantiate this one.
-  # Instead you should use AuthorizeNet::AIM::Transaction, AuthorizeNet::SIM::Transaction or AuthorizeNet::ARB::Transaction.
-  class Transaction
-    
-    include AuthorizeNet::TypeConversions
-    
-    # Fields to convert to/from booleans.
-    @@boolean_fields = []
-    
-    # Fields to convert to/from BigDecimal.
-    @@decimal_fields = []
-    
-    # DO NOT USE. Instantiate AuthorizeNet::AIM::Transaction, AuthorizeNet::SIM::Transaction or AuthorizeNet::ARB::Transaction instead.
-    def initialize()
-      @fields ||= {}
-    end
-    
-    # Sets arbitrary API fields, overwriting existing values if they exist. Takes a hash of key/value pairs, 
-    # where the keys are the field names without the "x_" prefix. You can set a field to Nil to unset it. If
-    # the value is an array, each value in the array will be added. For example, set_fields({:line_item => 
-    # ["item1<|>golf balls<|><|>2<|>18.95<|>Y", "item2<|>golf bag<|>Wilson golf carry bag, red<|>1<|>39.99<|>"]})
-    # would generate two x_line_item fields in the transaction. One for each value in the array.
-    def set_fields(fields = {})
-      @fields.merge!(fields)
-      @fields.reject! {|k, v| v.nil?}
-      @fields
-    end
-    
-    # Returns the current hash of API fields.
-    def fields
-      @fields
-    end
-        
-    # Takes an instance of AuthorizeNet::Address and adds it to the transaction.
-    def set_address(address)
-      @fields.merge!(address.to_hash)
-    end
-    
-    # Takes an instance of AuthorizeNet::ShippingAddress and adds it to the transaction.
-    def set_shipping_address(address)
-      @fields.merge!(address.to_hash)
-    end
-    
-    # Takes an instance of AuthorizeNet::Customer and adds it to the transaction.
-    def set_customer(customer)
-      @fields.merge!(customer.to_hash)
-    end
-    
-    #:enddoc:
-    protected
-    
-    # Internal method to handle multiple types of payment arguments.
-    def handle_payment_argument(payment)
-      case payment
-      when AuthorizeNet::CreditCard, AuthorizeNet::ECheck
-        set_fields(payment.to_hash)
-      else
-        set_fields(:card_num => payment)
-      end
-    end
-    
-  end
-  
+module AuthorizeNet
+  
+  # The core, API agnostic transaction class. You shouldn't instantiate this one.
+  # Instead you should use AuthorizeNet::AIM::Transaction, AuthorizeNet::SIM::Transaction or AuthorizeNet::ARB::Transaction.
+  class Transaction
+    
+    include AuthorizeNet::TypeConversions
+    
+    # Fields to convert to/from booleans.
+    @@boolean_fields = []
+    
+    # Fields to convert to/from BigDecimal.
+    @@decimal_fields = []
+    
+    # DO NOT USE. Instantiate AuthorizeNet::AIM::Transaction, AuthorizeNet::SIM::Transaction or AuthorizeNet::ARB::Transaction instead.
+    def initialize()
+      @fields ||= {}
+    end
+    
+    # Sets arbitrary API fields, overwriting existing values if they exist. Takes a hash of key/value pairs, 
+    # where the keys are the field names without the "x_" prefix. You can set a field to Nil to unset it. If
+    # the value is an array, each value in the array will be added. For example, set_fields({:line_item => 
+    # ["item1<|>golf balls<|><|>2<|>18.95<|>Y", "item2<|>golf bag<|>Wilson golf carry bag, red<|>1<|>39.99<|>"]})
+    # would generate two x_line_item fields in the transaction. One for each value in the array.
+    def set_fields(fields = {})
+      @fields.merge!(fields)
+      @fields.reject! {|k, v| v.nil?}
+      @fields
+    end
+    
+    # Returns the current hash of API fields.
+    def fields
+      @fields
+    end
+        
+    # Takes an instance of AuthorizeNet::Address and adds it to the transaction.
+    def set_address(address)
+      @fields.merge!(address.to_hash)
+    end
+    
+    # Takes an instance of AuthorizeNet::ShippingAddress and adds it to the transaction.
+    def set_shipping_address(address)
+      @fields.merge!(address.to_hash)
+    end
+    
+    # Takes an instance of AuthorizeNet::Customer and adds it to the transaction.
+    def set_customer(customer)
+      @fields.merge!(customer.to_hash)
+    end
+    
+    #:enddoc:
+    protected
+    
+    # Internal method to handle multiple types of payment arguments.
+    def handle_payment_argument(payment)
+      case payment
+      when AuthorizeNet::CreditCard, AuthorizeNet::ECheck
+        set_fields(payment.to_hash)
+      else
+        set_fields(:card_num => payment)
+      end
+    end
+    
+  end
+  
 end

data/lib/authorize_net/xml_response.rb

@@ -1,172 +1,172 @@
-module AuthorizeNet
-
-  # The core, xml response class. You shouldn't instantiate this one.
-  # Instead you should use AuthorizeNet::ARB::Response.
-  class XmlResponse < AuthorizeNet::Response
-    
-    # DO NOT USE. Instantiate AuthorizeNet::ARB::Response or AuthorizeNet::CIM::Response instead.
-    def initialize(raw_response, transaction)
-      @raw_response = raw_response
-      @transaction = transaction
-      unless connection_failure?
-        begin
-          xml = Nokogiri::XML(@raw_response.body) do |config|
-            # confirm noent is the right flag
-            config.recover.noent.nonet
-          end
-          @root = xml.children[0]
-          @result_code = node_content_unless_nil(@root.at_css('messages resultCode'))
-          @message_code = node_content_unless_nil(@root.at_css('messages message code'))
-          @message_text = node_content_unless_nil(@root.at_css('messages message text'))
-          @reference_id = node_content_unless_nil(@root.at_css('refId'))
-        rescue
-          @raw_response = $!
-        end
-      end
-    end
-    
-    # Check to see if the response indicated success. Success is defined as a 200 OK response with a resultCode
-    # of 'Ok'.
-    def success?
-      !connection_failure? && @result_code == 'Ok'
-    end
-    
-    # Returns true if we failed to open a connection to the gateway or got back a non-200 OK HTTP response.
-    def connection_failure?
-      !@raw_response.kind_of?(Net::HTTPOK)
-    end
-    
-    # Returns the underlying Net::HTTPResponse object. This has the original response body along with
-    # headers and such. Note that if an exception is generated while making the request (which happens
-    # if there is no internet connection for example), you will get the exception object here instead of
-    # a Net::HTTPResponse object.
-    def raw
-      @raw_response
-    end
-    
-    # Returns a deep-copy of the XML object received from the payment gateway. Or nil if there was no XML payload.
-    def xml
-      @root.dup unless @root.nil?
-    end
-    
-    # Returns the resultCode from the XML response. resultCode will be either 'Ok' or 'Error'.
-    def result_code
-      @result_code
-    end
-    
-    # Returns the messageCode from the XML response. This is a code indicating the details of an error
-    # or success.
-    def message_code
-      @message_code
-    end
-    
-    # Returns the messageText from the XML response. This is a text description of the message_code.
-    def message_text
-      @message_text
-    end
-    
-    # Alias for result_code.
-    def response_code
-      result_code
-    end
-    
-    # Alias for message_code.
-    def response_reason_code
-      message_code
-    end
-    
-    # Alias for message_text.
-    def response_reason_text
-      message_text
-    end
-    
-    # Returns the refId from the response if there is one. Otherwise returns nil.
-    def reference_id
-      @reference_id
-    end
-    
-    #:enddoc:
-    protected
-    
-    def node_content_unless_nil(node)
-      if node.nil?
-        nil
-      else
-        node.content
-      end
-    end
-    
-    def node_child_content_unless_nil(node)
-      if node.nil?
-        nil
-      else
-        if node.children.length > 0
-          node.children.collect(&:content)
-        else
-          nil
-        end
-      end
-    end
-    
-    # Transforms a block of XML into a model Object defined by entity_desc.
-    def build_entity(xml, entity_desc)
-      args = {}
-      entity_desc.node_structure.each do |node_desc|
-        node_name = (node_desc.keys.reject {|k| k.to_s[0..0] == '_' }).first
-        args.merge!(handle_node_type(xml, node_desc, node_name, args, ''))
-      end
-      
-      if args.length == 0
-        return nil
-      end
-      
-      if entity_desc.arg_mapping.nil?
-        return entity_desc.entity_class.new(args)
-      else
-        args_list = []
-        entity_desc.arg_mapping.each do |arg|
-          args_list <<= args[arg]
-          args.delete(arg)
-        end
-        args_list <<= args
-        return entity_desc.entity_class.new(*args_list)
-      end
-    end
-    
-    # Parses an XML fragment into an internal representation.
-    def handle_node_type(xml, node_desc, node_name, args, base_name)
-      case node_desc[node_name]
-      when Symbol
-        node = xml.at_css(base_name + node_name.to_s)
-        unless node.nil?
-          content = node.content
-          case node_desc[:_converter]
-          when Method, Proc
-            content = node_desc[:_converter].call(content)
-          when Symbol
-            content = self.send(node_desc[:_converter], content)
-          end
-          args[node_desc[node_name]] = content unless content.nil?
-        end
-      when AuthorizeNet::EntityDescription
-        unless node_desc[:_multivalue].nil?
-          xml.css(base_name + node_name.to_s).each do |node|
-            entity = build_entity(node, node_desc[node_name])
-            args[node_desc[:_multivalue]] = args[node_desc[:_multivalue]].to_a + entity.to_a unless entity.nil?
-          end
-        else
-          entity = build_entity(xml.css(base_name + node_name.to_s), node_desc[node_name])
-          args[node_desc[:_value]] = entity unless entity.nil?
-        end
-      when Array
-        node_desc[node_name].each do |inner_node|
-          inner_node_name = (inner_node.keys.reject {|k| k.to_s[0..0] == '_' }).first
-          args.merge!(handle_node_type(xml, inner_node, inner_node_name, args, node_name.to_s + ' '))
-        end
-      end
-      return args
-    end
-      
-  end
-  
+module AuthorizeNet
+
+  # The core, xml response class. You shouldn't instantiate this one.
+  # Instead you should use AuthorizeNet::ARB::Response.
+  class XmlResponse < AuthorizeNet::Response
+    
+    # DO NOT USE. Instantiate AuthorizeNet::ARB::Response or AuthorizeNet::CIM::Response instead.
+    def initialize(raw_response, transaction)
+      @raw_response = raw_response
+      @transaction = transaction
+      unless connection_failure?
+        begin
+          xml = Nokogiri::XML(@raw_response.body) do |config|
+            # confirm noent is the right flag
+            config.recover.noent.nonet
+          end
+          @root = xml.children[0]
+          @result_code = node_content_unless_nil(@root.at_css('messages resultCode'))
+          @message_code = node_content_unless_nil(@root.at_css('messages message code'))
+          @message_text = node_content_unless_nil(@root.at_css('messages message text'))
+          @reference_id = node_content_unless_nil(@root.at_css('refId'))
+        rescue
+          @raw_response = $!
+        end
+      end
+    end
+    
+    # Check to see if the response indicated success. Success is defined as a 200 OK response with a resultCode
+    # of 'Ok'.
+    def success?
+      !connection_failure? && @result_code == 'Ok'
+    end
+    
+    # Returns true if we failed to open a connection to the gateway or got back a non-200 OK HTTP response.
+    def connection_failure?
+      !@raw_response.kind_of?(Net::HTTPOK)
+    end
+    
+    # Returns the underlying Net::HTTPResponse object. This has the original response body along with
+    # headers and such. Note that if an exception is generated while making the request (which happens
+    # if there is no internet connection for example), you will get the exception object here instead of
+    # a Net::HTTPResponse object.
+    def raw
+      @raw_response
+    end
+    
+    # Returns a deep-copy of the XML object received from the payment gateway. Or nil if there was no XML payload.
+    def xml
+      @root.dup unless @root.nil?
+    end
+    
+    # Returns the resultCode from the XML response. resultCode will be either 'Ok' or 'Error'.
+    def result_code
+      @result_code
+    end
+    
+    # Returns the messageCode from the XML response. This is a code indicating the details of an error
+    # or success.
+    def message_code
+      @message_code
+    end
+    
+    # Returns the messageText from the XML response. This is a text description of the message_code.
+    def message_text
+      @message_text
+    end
+    
+    # Alias for result_code.
+    def response_code
+      result_code
+    end
+    
+    # Alias for message_code.
+    def response_reason_code
+      message_code
+    end
+    
+    # Alias for message_text.
+    def response_reason_text
+      message_text
+    end
+    
+    # Returns the refId from the response if there is one. Otherwise returns nil.
+    def reference_id
+      @reference_id
+    end
+    
+    #:enddoc:
+    protected
+    
+    def node_content_unless_nil(node)
+      if node.nil?
+        nil
+      else
+        node.content
+      end
+    end
+    
+    def node_child_content_unless_nil(node)
+      if node.nil?
+        nil
+      else
+        if node.children.length > 0
+          node.children.collect(&:content)
+        else
+          nil
+        end
+      end
+    end
+    
+    # Transforms a block of XML into a model Object defined by entity_desc.
+    def build_entity(xml, entity_desc)
+      args = {}
+      entity_desc.node_structure.each do |node_desc|
+        node_name = (node_desc.keys.reject {|k| k.to_s[0..0] == '_' }).first
+        args.merge!(handle_node_type(xml, node_desc, node_name, args, ''))
+      end
+      
+      if args.length == 0
+        return nil
+      end
+      
+      if entity_desc.arg_mapping.nil?
+        return entity_desc.entity_class.new(args)
+      else
+        args_list = []
+        entity_desc.arg_mapping.each do |arg|
+          args_list <<= args[arg]
+          args.delete(arg)
+        end
+        args_list <<= args
+        return entity_desc.entity_class.new(*args_list)
+      end
+    end
+    
+    # Parses an XML fragment into an internal representation.
+    def handle_node_type(xml, node_desc, node_name, args, base_name)
+      case node_desc[node_name]
+      when Symbol
+        node = xml.at_css(base_name + node_name.to_s)
+        unless node.nil?
+          content = node.content
+          case node_desc[:_converter]
+          when Method, Proc
+            content = node_desc[:_converter].call(content)
+          when Symbol
+            content = self.send(node_desc[:_converter], content)
+          end
+          args[node_desc[node_name]] = content unless content.nil?
+        end
+      when AuthorizeNet::EntityDescription
+        unless node_desc[:_multivalue].nil?
+          xml.css(base_name + node_name.to_s).each do |node|
+            entity = build_entity(node, node_desc[node_name])
+            args[node_desc[:_multivalue]] = args[node_desc[:_multivalue]].to_a + entity.to_a unless entity.nil?
+          end
+        else
+          entity = build_entity(xml.css(base_name + node_name.to_s), node_desc[node_name])
+          args[node_desc[:_value]] = entity unless entity.nil?
+        end
+      when Array
+        node_desc[node_name].each do |inner_node|
+          inner_node_name = (inner_node.keys.reject {|k| k.to_s[0..0] == '_' }).first
+          args.merge!(handle_node_type(xml, inner_node, inner_node_name, args, node_name.to_s + ' '))
+        end
+      end
+      return args
+    end
+      
+  end
+  
 end