google4r-checkout 0.1.0 → 1.0.0

data/CHANGES

@@ -1,9 +1,23 @@
 = google4r-checkout Changelog
 
-== HEAD
+== 1.0.0 (2007-08-04)
 
-== 0.1.0 (2007-05-12)
+* Added refund-amount-notification
+* Added chargeback-amount-notification
+* Added authorization-amount-notification
+* Added refund command
+* Added authorize command
+* Added add-merchant-number command
+* Added add-tracking-data command
+* Added send-buyer-message command
+* Added archive-order command
+* Added unarchive-order command
+* Refactored to_xml in the Command class
+* Added CommandXmlGenerator base class
+* Added ChargeOrderCommand, DeliverOrderCommand, CancelOrderCommand, ChargeAmountNotification and RiskInfoNotification (all contributed by Dan Dukeson).
+* Attributes are not retrieved via XPaths with "tag/@attribute" any more but with REXML's Element#attributes. This should fix problems with Ruby 1.8.6.
 
+== 0.1.0 (2007-05-12)
 * Added property "shipping_taxed" to TaxRule (contributed by Dan Dukeson).
 * Added XML generation for the tax tables in the shopping cart (contributed by Dan Dukeson).
 * Added Area subclasses WorldArea and PostalArea (contributed by Dan Dukeson).

data/README

@@ -8,16 +8,10 @@ google4r itself is distributed under an MIT style license.
 
 However, the library includes the cacert.pem:http://curl.haxx.se/ca/cacert.pem file from the Mozilla project. This file is distributed under the MPL:http://www.mozilla.org/MPL/.
 
-== Status
+== More Information
 
 You can find more information on the Google Checkout API here:http://code.google.com/apis/checkout/developer/index.html. Note that the API documentation assumes an understanding of the Google Checkout XML API.
 
-Google4R also contains a partial implementation of the level 2 of the Google Checkout API:
-
-* The <checkout-cart-command> tag and all of its subtags that are not related to the merchant calculation API can be generated.
-* The <new-order-notification> tag and all of its subtags which are not related to the merchant calculation API can be parsed.
-* The <order-state-change-notification> tag can be parsed.
-
 == Google Checkout Tests
 
 You have to place a file called 'frontend_configuration.rb' in the directory'test' with the configuration for the Google4R::Checkout::Frontend class to use for running the tests.
@@ -38,18 +32,6 @@ The file should contain content similar to:
       :use_sandbox => true
     }
 
-== TODO
-
-Notifications:
-
-* <risk-information-notification>
-* <charge-amount-notification>
-* <refund-amount-notification>
-* <chargeback-amount-notification>
-* <authorization-amount-notification>
-
-All of the Order Processing API.
-
 == Dependencies
 
 The unit tests use Mocha so you have to install the gem "mocha" to run the tests. You will also need the money gem library.

data/lib/google4r/checkout/commands.rb

@@ -55,6 +55,12 @@ module Google4R #:nodoc:
       # The Frontent class that was used to create this CheckoutCommand and whose
       # configuration will be used.
       attr_reader :frontend
+      
+      # The tag name of the command
+      attr_reader :command_tag_name
+      
+      # The google order number, required, String
+      attr_accessor :google_order_number
 
       # Initialize the frontend attribute with the value of the frontend parameter.
       def initialize(frontend)
@@ -100,22 +106,25 @@ module Google4R #:nodoc:
           
           case xml_doc.root.name
           when 'checkout-redirect'
-            serial_number = xml_doc.elements['/checkout-redirect/@serial-number'].value
+            serial_number = xml_doc.elements['/checkout-redirect'].attributes['serial-number']
             redirect_url = xml_doc.elements['/checkout-redirect/redirect-url/text()'].value
             return CheckoutRedirectResponse.new(serial_number, redirect_url)
+          when 'request-received'
+            serial_number = xml_doc.elements['/request-received'].attributes['serial-number']
+            return serial_number
           else
             raise "Unknown response:\n--\n#{xml_doc.to_s}\n--"
           end
         when Net::HTTPClientError then
           xml_doc = REXML::Document.new(result.body)
           
-          if xml_doc.elements['/error/@serial-number'].nil? or xml_doc.elements['/error/error-message/text()'].nil? then
+          if xml_doc.elements['/error'].attributes['serial-number'].nil? or xml_doc.elements['/error/error-message/text()'].nil? then
             raise "Invalid response from Google:\n---\n#{result.body}\n---"
           end
           
           hash = 
             {
-              :serial_number => xml_doc.elements['/error/@serial-number'].value,
+              :serial_number => xml_doc.elements['/error'].attributes['serial-number'],
               :message       => xml_doc.elements['/error/error-message/text()'].value
             }
           
@@ -127,30 +136,33 @@ module Google4R #:nodoc:
         end
       end
       
-      # Abstract method that is to contain the command's XML representation.
-      #
-      # Raises a NotImplementedError by default, override to remove this.
+      # Class method to return the command's XML representation.
       def to_xml
-        raise NotImplementedError, "Command#to_xml is abstract and must be overridden in a subclass."
+        if self.class == Command then
+          raise NotImplementedError, "Command#to_xml has to be used in a subclass."
+        else
+          generator_class = Google4R::Command.get_const("#{self.class}XmlGenerator")
+          return generator_class.new(self).generate
+        end
       end
       
       protected
       
-        # Class method to return the OpenSSL::X509::Store instance for the
-        # CA certificates.
-        #--
-        # TODO: Is OpenSSL::X509::Store thread safe when reading only? This method most certainly is *not*. It must become so.
-        #++
-        def self.x509_store
-          return @@x509_store if defined?(@@x509_store)
-          
-          cacert_path = File.expand_path(File.dirname(__FILE__) + '/../../../var/cacert.pem')
-          
-          @@x509_store = OpenSSL::X509::Store.new
-          @@x509_store.add_file(cacert_path)
-          
-          return @@x509_store
-        end
+      # Class method to return the OpenSSL::X509::Store instance for the
+      # CA certificates.
+      #--
+      # TODO: Is OpenSSL::X509::Store thread safe when reading only? This method most certainly is *not*. It must become so.
+      #++
+      def self.x509_store
+        return @@x509_store if defined?(@@x509_store)
+        
+        cacert_path = File.expand_path(File.dirname(__FILE__) + '/../../../var/cacert.pem')
+        
+        @@x509_store = OpenSSL::X509::Store.new
+        @@x509_store.add_file(cacert_path)
+        
+        return @@x509_store
+      end
     end
 
     # The CheckoutCommand represents a <checkout-shopping-cart> command sent
@@ -207,7 +219,6 @@ module Google4R #:nodoc:
       # to create CheckoutCommand objects.
       def initialize(frontend)
         super(frontend)
-        
         @shopping_cart = ShoppingCart.new(self)
         @tax_tables = frontend.tax_table_factory.effective_tax_tables_at(Time.new)
         @shipping_methods = Array.new
@@ -256,5 +267,179 @@ module Google4R #:nodoc:
         @redirect_url = redirect_url
       end
     end
+
+    #
+    # The ChargeOrderCommand instructs Google Checkout to charge the buyer for a
+    # particular order.
+    #
+    class ChargeOrderCommand < Command
+      # The amount to charge, optional, Money
+      attr_accessor :amount
+
+      # frontend, required
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      # Generates the XML for this ChargeOrderCommand
+      def to_xml
+        ChargeOrderCommandXmlGenerator.new(self).generate
+      end
+    end
+
+    # The RefundOrderCommand instructs Google Checkout to refund an order
+    class RefundOrderCommand < Command
+      # The amount to refund, optional, Money
+      attr_accessor :amount
+      
+      # The reason that the order is to be refunded, String of maximum 140 characters, required
+      attr_accessor :reason
+      
+      # A comment related to the refunded order, String of maximum 140 characters, optional
+      attr_accessor :comment
+
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        RefundOrderCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    # The CancelOrderCommand instructs Google Checkout to cancel an order
+    class CancelOrderCommand < Command
+      # The reason that the order is to be cancelled, String of maximum 140 characters, required
+      attr_accessor :reason
+      
+      # A comment related to the cancelled order, String of maximum 140 characters, optional
+      attr_accessor :comment
+
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        CancelOrderCommandXmlGenerator.new(self).generate
+      end
+    end
+
+    # The AuthorizeOrderCommand instructs Google Checkout to explicitly reauthorize
+    # a customer's credit card for the uncharged balance of an order to verify that
+    # funds for the order are available
+    class AuthorizeOrderCommand < Command
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        AuthorizeOrderCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    # The ProcessOrderCommand instructs Google Checkout to to update
+    # an order's fulfillment state from NEW to PROCESSING
+    class ProcessOrderCommand < Command
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        ProcessOrderCommandXmlGenerator.new(self).generate
+      end
+    end
+
+    # The AddMerchantOrderCommand instructs Google Checkout to associate a 
+    # merchant-assigned order number with an order
+    class AddMerchantOrderNumberCommand < Command
+      # The merchant-assigned order number associated with an order
+      attr_accessor :merchant_order_number
+      
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        AddMerchantOrderNumberCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    # The DeliverOrderCommand indicates that Google should update an order's fulfillment order state to DELIVERED
+    class DeliverOrderCommand < Command
+      # if google checkout should email buyer to ssay order is dispatched
+      attr_accessor :send_email
+      
+      # The name of the company responsible for shipping the item. Valid values
+      # for this tag are DHL, FedEx, UPS, USPS and Other.
+      attr_accessor :carrier
+      
+      # The shipper's tracking number that is associated with an order
+      attr_accessor :tracking_number
+      
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        DeliverOrderCommandXmlGenerator.new(self).generate
+      end        
+    end
+    
+    # The AddTrackingDataCommand instructs Google Checkout to associate a shipper's tracking number with an order.
+    class AddTrackingDataCommand < Command
+      # The name of the company responsible for shipping the item. Valid values
+      # for this tag are DHL, FedEx, UPS, USPS and Other.
+      attr_accessor :carrier
+      
+      # The shipper's tracking number that is associated with an order
+      attr_accessor :tracking_number
+      
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        AddTrackingDataCommandXmlGenerator.new(self).generate
+      end        
+    end
+    
+    # The SendBuyerMessageCommand instructs Google Checkout to place a message in the customer's Google Checkout account.
+    class SendBuyerMessageCommand < Command
+      # The message to the customer
+      attr_accessor :message
+      
+      # if google checkout should email buyer to ssay order is dispatched
+      attr_accessor :send_email
+      
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        SendBuyerMessageCommandXmlGenerator.new(self).generate
+      end        
+    end
+    
+    # The ArchiveOrderCommand instructs Google Checkout to remove an order from your Merchant Center Inbox.
+    class ArchiveOrderCommand < Command
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        ArchiveOrderCommandXmlGenerator.new(self).generate
+      end
+    end
+      
+    # The UnarchiveOrderCommand instructs Google Checkout to return a previously archived order to your Merchant Center Inbox.
+    class UnarchiveOrderCommand < Command
+      def initialize(frontend)
+        super(frontend)
+      end
+
+      def to_xml
+        UnarchiveOrderCommandXmlGenerator.new(self).generate
+      end
+    end
   end
 end

data/lib/google4r/checkout/frontend.rb

@@ -70,7 +70,7 @@ module Google4R #:nodoc:
     #   frontend = Google4R::Checkout::Frontend.new(configuration)
     #   frontend.tax_table_factory = TaxTableFactory.new
     #
-    #   checkout_command = frontent.create_checkout_command
+    #   checkout_command = frontend.create_checkout_command
     #   # ...
     #   handler = frontend.create_notification_handler
     class Frontend
@@ -91,6 +91,18 @@ module Google4R #:nodoc:
         
         @configuration = configuration.dup.freeze
       end
+
+      # Factory method to create a new DeliverOrderCommand object. Use this method to create
+      # your DeliverOrderCommand instances.
+      def create_deliver_order_command
+        return DeliverOrderCommand.new(self)
+      end
+
+      # Factory method to create a new ChargeOrderCommand object. Use this method to create
+      # your ChargeOrderCommand instances.
+      def create_charge_order_command
+        return ChargeOrderCommand.new(self)
+      end
       
       # Factory method that creates a new CheckoutCommand object. Use this method to create 
       # your CheckoutCommand instances.
@@ -103,6 +115,54 @@ module Google4R #:nodoc:
       def create_notification_handler
         return NotificationHandler.new(self)
       end
+
+      # Factory method to create a new CancelOrderCommand object. Use this method to create
+      # your CancelOrderCommand instances.
+      def create_cancel_order_command
+        return CancelOrderCommand.new(self)
+      end
+      
+      # Factory method to create a new RefundOrderCommand object. Use this method to create
+      # your RefundOrderCommand instances.
+      def create_refund_order_command
+        return RefundOrderCommand.new(self)
+      end
+      
+      # Factory method to create a new SendBuyerMessageCommand object. Use this method to create
+      # your SendBuyerMessageCommand instances.
+      def create_send_buyer_message_command
+        return SendBuyerMessageCommand.new(self)
+      end
+      
+      # Factory method to create a new AuthorizeOrderCommand object. Use this method to create
+      # your AuthorizeOrderCommand instances.
+      def create_authorize_order_command
+        return AuthorizeOrderCommand.new(self)
+      end
+
+      # Factory method to create a new AddMerchantOrderNumberCommand object. Use this method to create
+      # your AddMerchantOrderNumberCommand instances.
+      def create_add_merchant_order_number_command
+        return AddMerchantOrderNumberCommand.new(self)
+      end
+      
+      # Factory method to create a new AddTrackingDataCommand object. Use this method to create
+      # your AddTrackingDataCommand instances.
+      def create_add_tracking_data_command
+        return AddTrackingDataCommand.new(self)
+      end
+
+      # Factory method to create a new ArchiveOrderCommand object. Use this method to create
+      # your ArchiveOrderCommand instances.
+      def create_archive_order_command
+        return ArchiveOrderCommand.new(self)
+      end
+      
+      # Factory method to create a new UnarchiveOrderCommand object. Use this method to create
+      # your UnarchiveOrderCommand instances.
+      def create_unarchive_order_command
+        return UnarchiveOrderCommand.new(self)
+      end
     end
   end
-end
+end

data/lib/google4r/checkout/notifications.rb

@@ -107,6 +107,16 @@ module Google4R #:nodoc:
           NewOrderNotification.create_from_element(root, frontend)
         when 'order-state-change-notification' then
           OrderStateChangeNotification.create_from_element(root, frontend)
+        when 'risk-information-notification' then
+          RiskInformationNotification.create_from_element(root, frontend)
+        when 'charge-amount-notification' then
+          ChargeAmountNotification.create_from_element(root, frontend)
+        when 'refund-amount-notification' then
+          RefundAmountNotification.create_from_element(root, frontend)
+        when 'chargeback-amount-notification' then
+          ChargebackAmountNotification.create_from_element(root, frontend)
+        when 'authorization-amount-notification' then
+          AuthorizationAmountNotification.create_from_element(root, frontend)
         else
           raise UnknownNotificationType, "Unknown notification type: #{root.name}"
         end
@@ -185,7 +195,7 @@ module Google4R #:nodoc:
         result = NewOrderNotification.new(frontend)
         
         result.timestamp = Time.parse(element.elements['timestamp'].text)
-        result.serial_number = element.elements['@serial-number'].value
+        result.serial_number = element.attributes['serial-number']
         result.google_order_number = element.elements['google-order-number'].text
         result.buyer_billing_address = Address.create_from_element(element.elements['buyer-billing-address'])
         result.buyer_shipping_address = Address.create_from_element(element.elements['buyer-shipping-address'])
@@ -197,7 +207,7 @@ module Google4R #:nodoc:
         result.shopping_cart = ShoppingCart.create_from_element(element.elements['shopping-cart'], result)
 
         amount = element.elements['order-total'].text.to_s.gsub(/[^0-9]/, '').to_i rescue nil
-        currency = element.elements['order-total/@currency'].value rescue nil
+        currency = element.elements['order-total'].attributes['currency'] rescue nil
         result.order_total = Money.new(amount, currency)
         
         return result
@@ -250,7 +260,7 @@ module Google4R #:nodoc:
         @frontend = frontend
       end
       
-      # Factory methdo that creates a new OrderStateChangeNotification from an REXML::Element instance.
+      # Factory method that creates a new OrderStateChangeNotification from an REXML::Element instance.
       # Use this to create instances of OrderStateChangeNotification.
       #
       # Raises NoMethodError and RuntimeError exceptions if the given element misses required
@@ -259,8 +269,7 @@ module Google4R #:nodoc:
         result = OrderStateChangeNotification.new(frontend)
 
         result.timestamp = Time.parse(element.elements['timestamp'].text)
-
-        result.serial_number = element.elements['@serial-number'].value
+        result.serial_number = element.attributes['serial-number']
         result.google_order_number = element.elements['google-order-number'].text
         result.new_financial_order_state = element.elements['new-financial-order-state'].text
         result.previous_financial_order_state = element.elements['previous-financial-order-state'].text
@@ -272,6 +281,288 @@ module Google4R #:nodoc:
       end
     end
 
+    # Google Checkout sends <charge-amount-notification> messages to the web service when the
+    # to confirm that the charge was successfully executed.
+    class ChargeAmountNotification
+           
+      # The serial number of the notification (String).
+      attr_accessor :serial_number
+
+      # The order number in Google's database (String).
+      attr_accessor :google_order_number
+
+      # The timestamp of the notification
+      attr_accessor :timestamp
+      
+      # The amount most recently charged for an order (Money)
+      attr_accessor :latest_charge_amount
+      
+      # The total amount charged for an order (Money)
+      attr_accessor :total_charge_amount
+
+      # The Frontend instance for this Notification
+      attr_accessor :frontend
+      
+      # Initializes the ChargeAmountNotification instance with the given Frontend instance.
+      def initialize(frontend)
+        @frontend = frontend
+      end
+
+      # Factory method that creates a new ChargeAmountNotification from an REXML::Element instance.
+      # Use this to create instances of ChargeAmountNotification.
+      #
+      # Raises NoMethodError and RuntimeError exceptions if the given element misses required
+      # elements.
+      def self.create_from_element(element, frontend)
+        charge = ChargeAmountNotification.new(frontend)
+        
+        charge.serial_number = element.attributes['serial-number']
+        charge.google_order_number = element.elements['google-order-number'].text        
+        
+        currency = element.elements['latest-charge-amount'].attributes['currency']
+        amount = element.elements['latest-charge-amount'].text.to_f*100.round
+        charge.latest_charge_amount = Money.new(amount, currency)
+        
+        currency = element.elements['total-charge-amount'].attributes['currency']
+        amount = element.elements['total-charge-amount'].text.to_f*100.round
+        charge.total_charge_amount = Money.new(amount, currency)  
+        
+        charge.timestamp = Time.parse(element.elements['timestamp'].text)
+
+        return charge
+      end
+    end
+
+    # Google Checkout sends a <refund-amount-notification> after successfully executing 
+    # a <refund-order> order processing command.  See the Google Checkout documentation for more details:
+    # http://code.google.com/apis/checkout/developer/index.html#refund_amount_notification
+    class RefundAmountNotification
+      # The serial number of the notification (String).
+      attr_accessor :serial_number
+
+      # The order number in Google's database (String).
+      attr_accessor :google_order_number
+
+      # The timestamp of the notification
+      attr_accessor :timestamp
+      
+      # The amount most recently refunded for an order (Money)
+      attr_accessor :latest_refund_amount
+      
+      # The total amount refunded for an order (Money)
+      attr_accessor :total_refund_amount
+
+      # The Frontend instance for this Notification
+      attr_accessor :frontend
+      
+      # Initializes the RefundAmountNotification instance with the given Frontend instance.
+      def initialize(frontend)
+        @frontend = frontend
+      end
+
+      # Factory method that creates a new RefundAmountNotification from an REXML::Element instance.
+      # Use this to create instances of RefundAmountNotification.
+      #
+      # Raises NoMethodError and RuntimeError exceptions if the given element misses required
+      # elements.
+      def self.create_from_element(element, frontend)
+        refund = RefundAmountNotification.new(frontend)
+        
+        refund.serial_number = element.attributes['serial-number']
+        refund.google_order_number = element.elements['google-order-number'].text
+        
+        currency = element.elements['latest-refund-amount'].attributes['currency']
+        amount = element.elements['latest-refund-amount'].text.to_f*100.round
+        refund.latest_refund_amount = Money.new(amount, currency)
+
+        currency = element.elements['total-refund-amount'].attributes['currency']
+        amount = element.elements['total-refund-amount'].text.to_f*100.round
+        refund.total_refund_amount = Money.new(amount, currency)
+        
+        refund.timestamp = Time.parse(element.elements['timestamp'].text)
+
+        return refund
+      end
+    end
+
+    # Google Checkout sends a <chargeback-amount-notification> when a customer initiates a 
+    # chargeback against the order and Google approves the chargeback.
+    # See the Google Checkout documentation for more details:
+    # http://code.google.com/apis/checkout/developer/index.html#chargeback_amount_notification
+    class ChargebackAmountNotification
+      # The serial number of the notification (String).
+      attr_accessor :serial_number
+
+      # The order number in Google's database (String).
+      attr_accessor :google_order_number
+
+      # The timestamp of the notification
+      attr_accessor :timestamp
+      
+      # The amount most recently charged back for an order (Money)
+      attr_accessor :latest_chargeback_amount
+      
+      # The total amount charged back for an order (Money)
+      attr_accessor :total_chargeback_amount
+
+      # The Frontend instance for this Notification
+      attr_accessor :frontend
+      
+      # Initializes the ChargebackAmountNotification instance with the given Frontend instance.
+      def initialize(frontend)
+        @frontend = frontend
+      end
+
+      # Factory method that creates a new ChargebackAmountNotification from an REXML::Element instance.
+      # Use this to create instances of ChargebackAmountNotification.
+      #
+      # Raises NoMethodError and RuntimeError exceptions if the given element misses required
+      # elements.
+      def self.create_from_element(element, frontend)
+        chargeback = ChargebackAmountNotification.new(frontend)
+        
+        chargeback.serial_number = element.attributes['serial-number']
+        chargeback.google_order_number = element.elements['google-order-number'].text
+        
+        currency = element.elements['latest-chargeback-amount'].attributes['currency']
+        amount = element.elements['latest-chargeback-amount'].text.to_f*100.round
+        chargeback.latest_chargeback_amount = Money.new(amount, currency)
+
+        currency = element.elements['total-chargeback-amount'].attributes['currency']
+        amount = element.elements['total-chargeback-amount'].text.to_f*100.round
+        chargeback.total_chargeback_amount = Money.new(amount, currency)
+        
+        chargeback.timestamp = Time.parse(element.elements['timestamp'].text)
+
+        return chargeback
+      end
+    end
+    
+    # Google Checkout sends an <authorization-amount-notification> in response to a successful
+    # request for an explicit credit card reauthorization.
+    # See the Google Checkout documentation for more details:
+    # http://code.google.com/apis/checkout/developer/index.html#authorization_amount_notification
+    class AuthorizationAmountNotification
+      # The serial number of the notification (String).
+      attr_accessor :serial_number
+
+      # The order number in Google's database (String).
+      attr_accessor :google_order_number
+
+      # The timestamp of the notification
+      attr_accessor :timestamp
+      
+      # The amount that is reauthorized to be charged to the customer's credit card (Money)
+      attr_accessor :authorization_amount
+      
+      # The time that a credit card authorization for an order expires.
+      attr_accessor :authorization_expiration_date
+      
+      # The address verification response (String)
+      attr_accessor :avs_response
+      
+      # Credit verification value for the order (String)
+      attr_accessor :cvn_response
+      
+      # The Frontend instance for this Notification
+      attr_accessor :frontend
+      
+      # Initializes the AuthorizationAmountNotification instance with the given Frontend instance.
+      def initialize(frontend)
+        @frontend = frontend
+      end
+
+      # Factory method that creates a new AuthorizationAmountNotification from an REXML::Element instance.
+      # Use this to create instances of AuthorizationAmountNotification.
+      #
+      # Raises NoMethodError and RuntimeError exceptions if the given element misses required
+      # elements.
+      def self.create_from_element(element, frontend)
+        authorization = AuthorizationAmountNotification.new(frontend)
+        
+        authorization.serial_number = element.attributes['serial-number']
+        authorization.google_order_number = element.elements['google-order-number'].text
+        
+        currency = element.elements['authorization-amount'].attributes['currency']
+        amount = element.elements['authorization-amount'].text.to_f*100.round
+        authorization.authorization_amount = Money.new(amount, currency)
+
+        authorization.authorization_expiration_date = Time.parse(element.elements['authorization-expiration-date'].text)
+        
+        authorization.avs_response = element.elements['avs-response'].text
+        authorization.cvn_response = element.elements['cvn-response'].text
+        
+        authorization.timestamp = Time.parse(element.elements['timestamp'].text)
+
+        return authorization
+      end
+    end
+    
+    # Google Checkout sends out <risk-information-notification> messages for fraud detection
+    # related information. See the Google Checkout documentation for more details:
+    # http://code.google.com/apis/checkout/developer/index.html#risk_information_notification
+    class RiskInformationNotification
+      # The serial number of the notification (String).
+      attr_accessor :serial_number
+
+      # The order number in Google's database (String).
+      attr_accessor :google_order_number
+
+      # Is the order eligible for Google Checkout's payment guarantee policy (boolean).
+      attr_accessor :eligible_for_protection
+      
+      # The buyer's billing address (Address).
+      attr_accessor :buyer_billing_address
+
+      # The address verification response (String)
+      attr_accessor :avs_response
+      
+      # Credit verification value for the order (String)
+      attr_accessor :cvn_response
+
+      # The last 4 digits of the credit card used to pay for the order (integer)
+      attr_accessor :partial_card_number
+
+      # The buyer's IP address (String)
+      attr_accessor :ip_address
+
+      # The age of the buyer's google checkout account in days
+      attr_accessor :buyer_account_age
+
+      # The timestamp of the notification
+      attr_accessor :timestamp
+      
+      # The Frontend instance for this Notification
+      attr_accessor :frontend
+      
+      # Initializes the RiskInformationNotification instance with the given Frontend instance.
+      def initialize(frontend)
+        @frontend = frontend
+      end
+
+      # Factory method that creates a new RiskInformationNotification from an REXML::Element instance.
+      # Use this to create instances of RiskInformationNotification
+      #
+      # Raises NoMethodError and RuntimeError exceptions if the given element misses required
+      # elements.
+      def self.create_from_element(element, frontend)
+        risk = RiskInformationNotification.new(frontend)
+        
+        risk.serial_number = element.attributes['serial-number']
+        risk.timestamp = Time.parse(element.elements['timestamp'].text)       
+        risk.partial_card_number = element.elements['risk-information/partial-cc-number'].text
+        risk.ip_address = element.elements['risk-information/ip-address'].text
+        risk.google_order_number = element.elements['google-order-number'].text
+        risk.eligible_for_protection = element.elements['risk-information/eligible-for-protection'].text == 'true'
+        risk.cvn_response = element.elements['risk-information/cvn-response'].text
+        risk.buyer_billing_address = Address.create_from_element(element.elements['risk-information/billing-address'])
+        risk.buyer_account_age = element.elements['risk-information/buyer-account-age'].text.to_i
+        risk.avs_response = element.elements['risk-information/avs-response'].text
+
+        return risk
+      end
+    end
+    
     # Container for the valid financial order states as defined in the 
     # Google Checkout API.
     module FinancialOrderState
@@ -351,7 +642,7 @@ module Google4R #:nodoc:
     
     # The marketing preferences of a customer.
     class MarketingPreferences
-      # Boolean, true iff the customer wants to receive emails.
+      # Boolean, true if the customer wants to receive emails.
       attr_accessor :email_allowed
       
       # Creates a new MarketingPreferences object from a given REXML::Element instance.
@@ -404,11 +695,11 @@ module Google4R #:nodoc:
         result.code = element.elements['code'].text
         
         amount = element.elements['calculated-amount'].text.to_s.gsub(/[^0-9]/, '').to_i rescue nil
-        currency = element.elements['calculated-amount/@currency'].value rescue nil
+        currency = element.elements['calculated-amount'].attributes['currency'] rescue nil
         result.calculated_amount = Money.new(amount, currency) unless amount.nil?
         
         amount = element.elements['applied-amount'].text.to_s.gsub(/[^0-9]/, '').to_i
-        currency = element.elements['applied-amount/@currency'].value
+        currency = element.elements['applied-amount'].attributes['currency']
         result.applied_amount = Money.new(amount, currency)
         
         result.message = element.elements['message'].text rescue nil
@@ -454,7 +745,7 @@ module Google4R #:nodoc:
         result.name = element.elements['shipping-name'].text
         
         amount = element.elements['shipping-cost'].text.to_s.gsub(/[^0-9]/, '').to_i
-        currency = element.elements['shipping-cost/@currency'].value
+        currency = element.elements['shipping-cost'].attributes['currency']
         result.cost = Money.new(amount, currency)
         
         return result
@@ -486,7 +777,7 @@ module Google4R #:nodoc:
         result = OrderAdjustment.new
         
         amount = element.elements['total-tax'].text.to_s.gsub(/[^0-9]/, '').to_i rescue nil
-        currency = element.elements['total-tax/@currency'].value rescue nil
+        currency = element.elements['total-tax'].attributes['currency'] rescue nil
         result.total_tax = Money.new(amount, currency) unless amount.nil?
         
         shipping_element = element.elements["shipping/*"]
@@ -498,7 +789,7 @@ module Google4R #:nodoc:
         result.merchant_calculation_successful = (element.elements['merchant-calculation-successful'].text.downcase == 'true') rescue nil
         
         amount = element.elements['adjustment-total'].text.to_s.gsub(/[^0-9]/, '').to_i rescue nil
-        currency = element.elements['adjustment-total/@currency'].value rescue nil
+        currency = element.elements['adjustment-total'].attributes['currency'] rescue nil
         result.adjustment_total = Money.new(amount, currency) unless amount.nil?
         
         return result