braintree 1.0.1 → 1.1.0

data/lib/braintree.rb

@@ -1,8 +1,10 @@
+require 'bigdecimal'
 require "cgi"
 require "digest/sha1"
 require "logger"
 require "net/http"
 require "net/https"
+require "openssl"
 require "stringio"
 require "time"
 require "zlib"
@@ -13,54 +15,42 @@ unless ::LibXML::XML.respond_to?(:default_keep_blanks=)
   raise LoadError, "The version of libxml that you're using is not compatible with the Braintree gem."
 end
 
-module Braintree # :nodoc:
-  # Super class for all Braintree exceptions.
-  class BraintreeError < ::StandardError; end
-
-  # Raised when authentication fails. This may be caused by an incorrect <tt>Braintree::Configuration</tt>
-  class AuthenticationError < BraintreeError; end
-
-  # Raised when the API key being used is not authorized to perform the attempted action according
-  # to the roles assigned to the user who owns the API key.
-  class AuthorizationError < BraintreeError; end
-
-  # Raised when the Braintree gem is not completely configured. See <tt>Braintree::Configuration</tt>.
-  class ConfigurationError < BraintreeError
-    def initialize(setting, message) # :nodoc:
-      super "Braintree::Configuration.#{setting} #{message}"
-    end
-  end
-
-  # Raised when the gateway is down for maintenance.
-  class DownForMaintenanceError < BraintreeError; end
-
-  # Raised from methods that confirm transparent request requests
-  # when the given query string cannot be verified. This may indicate
-  # an attempted hack on the merchant's transparent redirect
-  # confirmation URL.
-  class ForgedQueryString < BraintreeError; end
-
-  # Raised when a record could not be found.
-  class NotFoundError < BraintreeError; end
-
-  # Raised when an unexpected server error occurs.
-  class ServerError < BraintreeError; end
-
-  # Raised when the SSL certificate fails verification.
-  class SSLCertificateError < BraintreeError; end
-
-  # Raised when an error occurs that the client library is not built to handle.
-  # This shouldn't happen.
-  class UnexpectedError < BraintreeError; end
-
-  # Raised from bang methods when validations fail.
-  class ValidationsFailed < BraintreeError; end
+module Braintree
 end
 
+require "braintree/exceptions"
 require "braintree/base_module"
 
-Dir.glob("#{File.dirname(__FILE__)}/braintree/**/*.rb").sort.each do |file|
-  next if file =~ /base_module/
-  load file
-end
+require "braintree/address.rb"
+require "braintree/configuration.rb"
+require "braintree/credit_card.rb"
+require "braintree/credit_card_verification.rb"
+require "braintree/customer.rb"
+require "braintree/digest.rb"
+require "braintree/error_codes.rb"
+require "braintree/error_result.rb"
+require "braintree/errors.rb"
+require "braintree/http.rb"
+require "braintree/paged_collection.rb"
+require "braintree/ssl_expiration_check.rb"
+require "braintree/subscription"
+require "braintree/successful_result.rb"
+require "braintree/test/credit_card_numbers.rb"
+require "braintree/test/transaction_amounts.rb"
+require "braintree/transaction.rb"
+require "braintree/transaction/address_details.rb"
+require "braintree/transaction/credit_card_details.rb"
+require "braintree/transaction/customer_details.rb"
+require "braintree/transaction/status_details.rb"
+require "braintree/transparent_redirect.rb"
+require "braintree/util.rb"
+require "braintree/validation_error.rb"
+require "braintree/validation_error_collection.rb"
+require "braintree/version.rb"
+require "braintree/xml.rb"
+require "braintree/xml/generator.rb"
+require "braintree/xml/libxml.rb"
+require "braintree/xml/parser.rb"
+
 Braintree::SSLExpirationCheck.check_dates
+

data/lib/braintree/address.rb

@@ -4,10 +4,10 @@ module Braintree
   # as the shipping address when creating a Transaction.
   class Address
     include BaseModule # :nodoc:
-   
+
     attr_reader :company, :country_name, :created_at, :customer_id, :extended_address, :first_name, :id,
       :last_name, :locality, :postal_code, :region, :street_address, :updated_at
-      
+
     def self.create(attributes)
       Util.verify_keys(_create_signature, attributes)
       unless attributes[:customer_id]
@@ -25,17 +25,17 @@ module Braintree
         raise UnexpectedError, "expected :address or :api_error_response"
       end
     end
-    
+
     def self.create!(attributes)
       return_object_or_raise(:address) { create(attributes) }
     end
-    
+
     def self.delete(customer_or_customer_id, address_id)
       customer_id = _determine_customer_id(customer_or_customer_id)
       Http.delete("/customers/#{customer_id}/addresses/#{address_id}")
       SuccessfulResult.new
     end
-    
+
     # Finds the address with the given +address_id+ that is associated to the given +customer_or_customer_id+.
     # If the address cannot be found, a NotFoundError will be raised.
     def self.find(customer_or_customer_id, address_id)
@@ -45,7 +45,7 @@ module Braintree
     rescue NotFoundError
       raise NotFoundError, "address for customer #{customer_id.inspect} with id #{address_id.inspect} not found"
     end
-    
+
     def self.update(customer_or_customer_id, address_id, attributes)
       Util.verify_keys(_update_signature, attributes)
       customer_id = _determine_customer_id(customer_or_customer_id)
@@ -58,20 +58,20 @@ module Braintree
         raise UnexpectedError, "expected :address or :api_error_response"
       end
     end
-    
+
     def self.update!(customer_or_customer_id, address_id, attributes)
       return_object_or_raise(:address) { update(customer_or_customer_id, address_id, attributes) }
     end
-    
+
     def initialize(attributes) # :nodoc:
       set_instance_variables_from_hash(attributes)
     end
-    
+
     def ==(other) # :nodoc:
       return false unless other.is_a?(Address)
       id == other.id && customer_id == other.customer_id
     end
-    
+
     # Deletes the address.
     def delete
       Address.delete(customer_id, self.id)
@@ -89,7 +89,7 @@ module Braintree
         raise UnexpectedError, "expected :address or :api_error_response"
       end
     end
-   
+
     def update!(attributes)
       return_object_or_raise(:address) { update(attributes) }
     end
@@ -97,12 +97,12 @@ module Braintree
     class << self
       protected :new
     end
-    
+
     def self._create_signature # :nodoc:
       [:company, :country_name, :customer_id, :extended_address, :first_name,
         :last_name, :locality, :postal_code, :region, :street_address]
     end
-    
+
     def self._determine_customer_id(customer_or_customer_id) # :nodoc:
       customer_id = customer_or_customer_id.is_a?(Customer) ? customer_or_customer_id.id : customer_or_customer_id
       unless customer_id =~ /\A[\w_-]+\z/
@@ -114,7 +114,7 @@ module Braintree
     def self._new(*args) # :nodoc:
       self.new *args
     end
-    
+
     def self._update_signature # :nodoc:
       _create_signature
     end

data/lib/braintree/base_module.rb

@@ -6,7 +6,7 @@ module Braintree
         if result.success?
           result.send object_to_return
         else
-          raise ValidationsFailed
+          raise ValidationsFailed.new(result)
         end
       end
 
@@ -15,12 +15,12 @@ module Braintree
           instance_variable_set "@#{key}", value
         end
       end
-  
+
       def singleton_class
         class << self; self; end
       end
     end
-    
+
     def self.included(klass)
       klass.extend Methods
     end

data/lib/braintree/configuration.rb

@@ -14,7 +14,7 @@ module Braintree
       attr_accessor :logger
       attr_writer :merchant_id, :public_key, :private_key
     end
-  
+
     def self.expectant_reader(*attributes) # :nodoc:
       attributes.each do |attribute|
         (class << self; self; end).send(:define_method, attribute) do
@@ -25,11 +25,11 @@ module Braintree
       end
     end
     expectant_reader :environment, :merchant_id, :public_key, :private_key
-  
+
     def self.base_merchant_url # :nodoc:
       "#{protocol}://#{server}:#{port}#{base_merchant_path}"
     end
-  
+
     def self.base_merchant_path # :nodoc:
       "/merchants/#{Braintree::Configuration.merchant_id}"
     end
@@ -42,19 +42,19 @@ module Braintree
         File.expand_path(File.join(File.dirname(__FILE__), "..", "ssl", "securetrust_ca.crt"))
       end
     end
- 
-    # Sets the Braintree environment to use. Valid values are <tt>:sandbox</tt> and <tt>:production</tt> 
+
+    # Sets the Braintree environment to use. Valid values are <tt>:sandbox</tt> and <tt>:production</tt>
     def self.environment=(env)
       unless [:development, :qa, :sandbox, :production].include?(env)
         raise ArgumentError, "#{env.inspect} is not a valid environment"
       end
       @environment = env
     end
-  
+
     def self.logger # :nodoc:
       @logger ||= _default_logger
     end
-  
+
     def self.port # :nodoc:
       case environment
       when :development
@@ -63,11 +63,11 @@ module Braintree
         443
       end
     end
-  
+
     def self.protocol # :nodoc:
       ssl? ? "https" : "http"
     end
-  
+
     def self.server # :nodoc:
       case environment
       when :development
@@ -75,25 +75,25 @@ module Braintree
       when :production
         "www.braintreegateway.com"
       when :qa
-        "qa.braintreegateway.com"
+        "qa-master.braintreegateway.com"
       when :sandbox
         "sandbox.braintreegateway.com"
-      end    
-    end  
-    
+      end
+    end
+
     def self.ssl? # :nodoc:
       case environment
       when :development
         false
       when :production, :qa, :sandbox
         true
-      end    
+      end
     end
-  
+
     def self._default_logger # :nodoc:
       logger = Logger.new(STDOUT)
       logger.level = Logger::INFO
       logger
-    end  
+    end
   end
 end

data/lib/braintree/credit_card.rb

@@ -1,10 +1,10 @@
 module Braintree
   class CreditCard
     include BaseModule # :nodoc:
-    
+
     attr_reader :billing_address, :bin, :card_type, :cardholder_name, :created_at, :customer_id, :expiration_month,
       :expiration_year, :last_4, :token, :updated_at
-     
+
     def self.create(attributes)
       if attributes.has_key?(:expiration_date) && (attributes.has_key?(:expiration_month) || attributes.has_key?(:expiration_year))
         raise ArgumentError.new("create with both expiration_month and expiration_year or only expiration_date")
@@ -12,31 +12,31 @@ module Braintree
       Util.verify_keys(_create_signature, attributes)
       _do_create("/payment_methods", :credit_card => attributes)
     end
-    
+
     def self.create!(attributes)
       return_object_or_raise(:credit_card) { create(attributes) }
     end
-   
+
     # The transparent redirect URL to use to create a credit card.
     def self.create_credit_card_url
       "#{Braintree::Configuration.base_merchant_url}/payment_methods/all/create_via_transparent_redirect_request"
     end
- 
+
     def self.create_from_transparent_redirect(query_string)
       params = TransparentRedirect.parse_and_validate_query_string query_string
       _do_create("/payment_methods/all/confirm_transparent_redirect_request", :id => params[:id])
     end
-    
+
     def self.credit(token, transaction_attributes)
       Transaction.credit(transaction_attributes.merge(
         :payment_method_token => token
       ))
     end
-    
+
     def self.credit!(token, transaction_attributes)
       return_object_or_raise(:transaction) { credit(token, transaction_attributes) }
     end
-    
+
     # Returns a PagedCollection of expired credit cards.
     def self.expired(options = {})
       page_number = options[:page] || 1
@@ -47,7 +47,7 @@ module Braintree
       end
       PagedCollection.new(attributes) { |page_number| CreditCard.expired(:page => page_number) }
     end
-    
+
     # Returns a PagedCollection of credit cards expiring between +start_date+ and +end_date+ inclusive.
     # Only the month and year of the start and end dates are used.
     def self.expiring_between(start_date, end_date, options = {})
@@ -59,7 +59,7 @@ module Braintree
       end
       PagedCollection.new(attributes) { |page_number| CreditCard.expiring_between(start_date, end_date, :page => page_number) }
     end
-    
+
     # Finds the credit card with the given +token+. Raises a NotFoundError if it cannot be found.
     def self.find(token)
       response = Http.get "/payment_methods/#{token}"
@@ -67,17 +67,26 @@ module Braintree
     rescue NotFoundError
       raise NotFoundError, "payment method with token #{token.inspect} not found"
     end
-    
+
     def self.sale(token, transaction_attributes)
       Transaction.sale(transaction_attributes.merge(
         :payment_method_token => token
       ))
     end
-    
+
     def self.sale!(token, transaction_attributes)
       return_object_or_raise(:transaction) { sale(token, transaction_attributes) }
     end
 
+    def self.update(token, attributes)
+      Util.verify_keys(_update_signature, attributes)
+      _do_update(:put, "/payment_methods/#{token}", :credit_card => attributes)
+    end
+
+    def self.update!(token, attributes)
+      return_object_or_raise(:credit_card) { update(token, attributes) }
+    end
+
     def self.update_from_transparent_redirect(query_string)
       params = TransparentRedirect.parse_and_validate_query_string query_string
       _do_update(:post, "/payment_methods/all/confirm_transparent_redirect_request", :id => params[:id])
@@ -87,7 +96,7 @@ module Braintree
     def self.update_credit_card_url
       "#{Braintree::Configuration.base_merchant_url}/payment_methods/all/update_via_transparent_redirect_request"
     end
-    
+
     def initialize(attributes) # :nodoc:
       _init attributes
     end
@@ -98,33 +107,33 @@ module Braintree
         :payment_method_token => self.token
       ))
     end
-    
+
     def credit!(transaction_attributes)
       return_object_or_raise(:transaction) { credit(transaction_attributes) }
     end
-    
+
     def delete
       Http.delete("/payment_methods/#{token}")
     end
-    
+
     # Returns true if this credit card is the customer's default.
     def default?
       @default
     end
-    
+
     # Expiration date formatted as MM/YYYY
     def expiration_date
       "#{expiration_month}/#{expiration_year}"
     end
-   
-    # Returns true if the credit card is expired. 
+
+    # Returns true if the credit card is expired.
     def expired?
       if expiration_year.to_i == Time.now.year
         return expiration_month.to_i < Time.now.month
       end
-      expiration_year.to_i < Time.now.year  
+      expiration_year.to_i < Time.now.year
     end
-    
+
     def inspect # :nodoc:
       first = [:token]
       order = first + (self.class._attributes - first)
@@ -133,20 +142,20 @@ module Braintree
       end
       "#<#{self.class} #{nice_attributes.join(', ')}>"
     end
-    
+
     def masked_number
       "#{bin}******#{last_4}"
     end
-   
-    # Creates a sale transaction for this credit card. 
+
+    # Creates a sale transaction for this credit card.
     def sale(transaction_attributes)
       CreditCard.sale(self.token, transaction_attributes)
     end
-    
+
     def sale!(transaction_attributes)
       return_object_or_raise(:transaction) { sale(transaction_attributes) }
     end
-    
+
     def update(attributes)
       Util.verify_keys(self.class._update_signature, attributes)
       response = Http.put "/payment_methods/#{token}", :credit_card => attributes
@@ -157,9 +166,9 @@ module Braintree
         ErrorResult.new(response[:api_error_response])
       else
         raise UnexpectedError, "expected :credit_card or :api_error_response"
-      end      
+      end
     end
-    
+
     def update!(attributes)
       return_object_or_raise(:credit_card) { update(attributes) }
     end
@@ -191,7 +200,7 @@ module Braintree
 
     def self._new(*args) # :nodoc:
       self.new *args
-    end    
+    end
 
     def self._do_create(url, params) # :nodoc:
       response = Http.post url, params
@@ -228,4 +237,4 @@ module Braintree
       @billing_address = attributes[:billing_address] ? Address._new(attributes[:billing_address]) : nil
     end
   end
-end  
+end