activemerchant 1.24.0 → 1.25.0

data/CHANGELOG

@@ -1,5 +1,25 @@
 = ActiveMerchant CHANGELOG
 
+== Version 1.25.0 (July 3, 2012)
+
+* eWAY gateway: Add support for Diners Club cards [Soleone]
+* Orbital gateway: Never send country code for orders outside of US, CA and GB [Soleone]
+* Add EasyPay integration [nashby]
+* Updating LitleOnline requirement to 8.13.2 to take advantage of better validation and get bugfix for Username [GregDrake]
+* USAepay gateway: Add description support [ntalbott]
+* Add Paypal Payments Advanced integration [csaunders]
+* Authorize.Net gateway: Improve #refund docs [neerajdotname]
+* Wirecard gateway: Fix for missing address hash [ntalbott]
+* Clean up requires of RubyGems and JSON gems. Rename remote Litle test to match naming conventions [codyfauser]
+* Cybersource gateway: Fix updating address only [fabiokr]
+* Cybersource gateway: Move email requirement [fabiokr]
+* Add the Metrics Global gateway [DanKnox]
+* Braintree Blue gateway: Support wiredump_device [moklett]
+* Add Fat Zebra gateway [amasses]
+* Braintree Blue gateway: Always pass CVV on update [shayfrendt]
+* eWAY gateway: Update docs. Require address [juggler]
+* Cybersource gateway: Add support for subscriptions [fabiokr]
+
 == Version 1.24.0 (June 8, 2012)
 
 * PayPal gateway: Support for incomplete captures [mbulat]
@@ -9,6 +29,17 @@
 * Paybox Direct: treat all response codes besides '00000' as failures
 [Soleone]
 * Deprecate CreditCard#type method in favor of CreditCard#brand [jduff]
+* Cybersource gateway: Add subscriptions support [fabiokr, jaredmoody]
+* eWay gateway: Improved docs, and more accurate required parameters [juggler]
+* Braintree Blue gateway: Always pass CVV on card update [shayfrendt]
+* Add Fat Zebra gateway [amasses]
+* Braintree Blue gateway: Add support for wiredump_device [moklett]
+* Add Metrics Global gateway [DanKnox]
+* Cybersource gateway: Do not require email address for subscription operations [fabiokr]
+* Cybersource gateway: Fix passing only an address when updating a subscription [fabiokr]
+* Wirecard gateway: Fix for missing address; general cleanup [ntalbott]
+* Authorize.Net gateway: Document ability to just pass the last four to #refund [neerajdotname]
+* Add EasyPay integration [nashby]
 
 == Version 1.23.0 (May 23, 2012)
 

data/CONTRIBUTORS

@@ -305,3 +305,15 @@ ePay integration (April 2012)
 Litle gateway (May 2012)
 
 * Gregory Drake (GregDrake)
+
+Fat Zebra gateway (June 2012)
+
+* Matthew Savage (amasses)
+
+Metrics Global gateway (June 2012)
+
+* Dan Knox (DanKnox)
+
+EasyPay integration (July 2012)
+
+* Vasiliy Ermolovich (nashby)

data/README.md

@@ -99,6 +99,7 @@ The [ActiveMerchant Wiki](http://github.com/Shopify/active_merchant/wikis) conta
 * [ePay](http://www.epay.dk/) - DK, SE, NO
 * [eWAY](http://www.eway.com.au/) - AU
 * [E-xact](http://www.e-xact.com) - CA, US
+* [Fat Zebra](https://www.fatzebra.com.au) - AU
 * [Federated Canada](http://www.federatedcanada.com/) - CA
 * [FirstPay](http://www.first-pay.com) - US
 * [Garanti Sanal POS](https://ccpos.garanti.com.tr/ccRaporlar/garanti/ccReports) - US, TR

data/lib/active_merchant/billing/base.rb

@@ -5,12 +5,12 @@ module ActiveMerchant #:nodoc:
       #
       #   ActiveMerchant::Billing::Base.gateway_mode = :test
       mattr_accessor :gateway_mode
-      
+
       # Set ActiveMerchant integrations in test mode.
       #
       #   ActiveMerchant::Billing::Base.integration_mode = :test
       mattr_accessor :integration_mode
-      
+
       # Set both the mode of both the gateways and integrations
       # at once
       mattr_reader :mode
@@ -22,36 +22,35 @@ module ActiveMerchant #:nodoc:
       end
 
       self.mode = :production
-                                                                
+
       # Return the matching gateway for the provider
       # * <tt>bogus</tt>: BogusGateway - Does nothing (for testing)
       # * <tt>moneris</tt>: MonerisGateway
       # * <tt>authorize_net</tt>: AuthorizeNetGateway
       # * <tt>trust_commerce</tt>: TrustCommerceGateway
-      # 
+      #
       #   ActiveMerchant::Billing::Base.gateway('moneris').new
       def self.gateway(name)
         Billing.const_get("#{name.to_s.downcase}_gateway".camelize)
       end
-      
 
       # Return the matching integration module
       # You can then get the notification from the module
-      # * <tt>bogus</tt>: Bogus - Does nothing (for testing)      
+      # * <tt>bogus</tt>: Bogus - Does nothing (for testing)
       # * <tt>chronopay</tt>: Chronopay - Does nothing (for testing)
       # * <tt>paypal</tt>: Chronopay - Does nothing (for testing)
-      #   
+      #
       #   chronopay = ActiveMerchant::Billing::Base.integration('chronopay')
       #   notification = chronopay.notification(raw_post)
       #
       def self.integration(name)
         Billing::Integrations.const_get("#{name.to_s.downcase}".camelize)
       end
-      
+
       # A check to see if we're in test mode
       def self.test?
         self.gateway_mode == :test
       end
-    end             
+    end
   end
 end

data/lib/active_merchant/billing/gateway.rb

@@ -4,12 +4,12 @@ require 'active_merchant/billing/response'
 
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
-    # 
+    #
     # == Description
-    # The Gateway class is the base class for all ActiveMerchant gateway implementations. 
-    # 
+    # The Gateway class is the base class for all ActiveMerchant gateway implementations.
+    #
     # The standard list of gateway functions that most concrete gateway subclasses implement is:
-    # 
+    #
     # * <tt>purchase(money, creditcard, options = {})</tt>
     # * <tt>authorize(money, creditcard, options = {})</tt>
     # * <tt>capture(money, authorization, options = {})</tt>
@@ -24,7 +24,7 @@ module ActiveMerchant #:nodoc:
     #
     # * <tt>store(creditcard, options = {})</tt>
     # * <tt>unstore(identification, options = {})</tt>
-    # 
+    #
     # === Gateway Options
     # The options hash consists of the following options:
     #
@@ -38,9 +38,9 @@ module ActiveMerchant #:nodoc:
     # * <tt>:currency</tt> - The currency of the transaction.  Only important when you are using a currency that is not the default with a gateway that supports multiple currencies.
     # * <tt>:billing_address</tt> - A hash containing the billing address of the customer.
     # * <tt>:shipping_address</tt> - A hash containing the shipping address of the customer.
-    # 
+    #
     # The <tt>:billing_address</tt>, and <tt>:shipping_address</tt> hashes can have the following keys:
-    # 
+    #
     # * <tt>:name</tt> - The full name of the customer.
     # * <tt>:company</tt> - The company name of the customer.
     # * <tt>:address1</tt> - The primary street address of the customer.
@@ -60,78 +60,78 @@ module ActiveMerchant #:nodoc:
       include RequiresParameters
       include CreditCardFormatting
       include Utils
-      
+
       DEBIT_CARDS = [ :switch, :solo ]
       CURRENCIES_WITHOUT_FRACTIONS = [ 'JPY' ]
       CREDIT_DEPRECATION_MESSAGE = "Support for using credit to refund existing transactions is deprecated and will be removed from a future release of ActiveMerchant. Please use the refund method instead."
-            
+
       cattr_reader :implementations
       @@implementations = []
-      
+
       def self.inherited(subclass)
         super
         @@implementations << subclass
       end
-    
+
       # The format of the amounts used by the gateway
       # :dollars => '12.50'
       # :cents => '1250'
       class_attribute :money_format
       self.money_format = :dollars
-      
+
       # The default currency for the transactions if no currency is provided
       class_attribute :default_currency
-      
+
       # The countries of merchants the gateway supports
       class_attribute :supported_countries
       self.supported_countries = []
-      
+
       # The supported card types for the gateway
       class_attribute :supported_cardtypes
       self.supported_cardtypes = []
-      
+
       class_attribute :homepage_url
       class_attribute :display_name
-      
+
       # The application making the calls to the gateway
       # Useful for things like the PayPal build notation (BN) id fields
       superclass_delegating_accessor :application_id
       self.application_id = 'ActiveMerchant'
-      
+
       attr_reader :options
-      
+
       # Use this method to check if your gateway of interest supports a credit card of some type
       def self.supports?(card_type)
         supported_cardtypes.include?(card_type.to_sym)
       end
-      
+
       def self.card_brand(source)
         result = source.respond_to?(:brand) ? source.brand : source.type
         result.to_s.downcase
       end
-    
+
       def card_brand(source)
         self.class.card_brand(source)
       end
-    
+
       # Initialize a new gateway.
-      # 
-      # See the documentation for the gateway you will be using to make sure there are no other 
+      #
+      # See the documentation for the gateway you will be using to make sure there are no other
       # required options.
       def initialize(options = {})
       end
-                                     
+
       # Are we running in test mode?
       def test?
         Base.gateway_mode == :test
       end
-            
+
       private # :nodoc: all
 
-      def name 
+      def name
         self.class.name.scan(/\:\:(\w+)Gateway/).flatten.first
       end
-      
+
       def amount(money)
         return nil if money.nil?
         cents = if money.respond_to?(:cents)
@@ -141,8 +141,8 @@ module ActiveMerchant #:nodoc:
           money
         end
 
-        if money.is_a?(String) 
-          raise ArgumentError, 'money amount must be a positive Integer in cents.' 
+        if money.is_a?(String)
+          raise ArgumentError, 'money amount must be a positive Integer in cents.'
         end
 
         if self.money_format == :cents
@@ -156,11 +156,11 @@ module ActiveMerchant #:nodoc:
         amount = amount(money)
         CURRENCIES_WITHOUT_FRACTIONS.include?(currency.to_s) ? amount.split('.').first : amount
       end
-      
+
       def currency(money)
         money.respond_to?(:currency) ? money.currency : self.default_currency
       end
-      
+
       def requires_start_date_or_issue_number?(credit_card)
         return false if card_brand(credit_card).blank?
         DEBIT_CARDS.include?(card_brand(credit_card).to_sym)

data/lib/active_merchant/billing/gateways/authorize_net.rb

@@ -2,11 +2,11 @@ module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
     # For more information on the Authorize.Net Gateway please visit their {Integration Center}[http://developer.authorize.net/]
     #
-    # The login and password are not the username and password you use to 
-    # login to the Authorize.Net Merchant Interface. Instead, you will 
-    # use the API Login ID as the login and Transaction Key as the 
+    # The login and password are not the username and password you use to
+    # login to the Authorize.Net Merchant Interface. Instead, you will
+    # use the API Login ID as the login and Transaction Key as the
     # password.
-    # 
+    #
     # ==== How to Get Your API Login ID and Transaction Key
     #
     # 1. Log into the Merchant Interface
@@ -14,13 +14,13 @@ module ActiveMerchant #:nodoc:
     # 3. Click on API Login ID and Transaction Key in the Security section
     # 4. Type in the answer to the secret question configured on setup
     # 5. Click Submit
-    # 
+    #
     # ==== Automated Recurring Billing (ARB)
-    # 
+    #
     # Automated Recurring Billing (ARB) is an optional service for submitting and managing recurring, or subscription-based, transactions.
-    # 
+    #
     # To use recurring, update_recurring, cancel_recurring and status_recurring ARB must be enabled for your account.
-    # 
+    #
     # Information about ARB is available on the {Authorize.Net website}[http://www.authorize.net/solutions/merchantsolutions/merchantservices/automatedrecurringbilling/].
     # Information about the ARB API is available at the {Authorize.Net Integration Center}[http://developer.authorize.net/]
     class AuthorizeNetGateway < Gateway
@@ -33,7 +33,7 @@ module ActiveMerchant #:nodoc:
 
       self.arb_test_url = 'https://apitest.authorize.net/xml/v1/request.api'
       self.arb_live_url = 'https://api.authorize.net/xml/v1/request.api'
-      
+
       class_attribute :duplicate_window
 
       APPROVED, DECLINED, ERROR, FRAUD_REVIEW = 1, 2, 3, 4
@@ -68,7 +68,7 @@ module ActiveMerchant #:nodoc:
       #
       # * <tt>:login</tt> -- The Authorize.Net API Login ID (REQUIRED)
       # * <tt>:password</tt> -- The Authorize.Net Transaction Key. (REQUIRED)
-      # * <tt>:test</tt> -- +true+ or +false+. If true, perform transactions against the test server. 
+      # * <tt>:test</tt> -- +true+ or +false+. If true, perform transactions against the test server.
       #   Otherwise, perform transactions against the production server.
       def initialize(options = {})
         requires!(options, :login, :password)
@@ -150,6 +150,7 @@ module ActiveMerchant #:nodoc:
       # ==== Options
       #
       # * <tt>:card_number</tt> -- The credit card number the refund is being issued to. (REQUIRED)
+      #   You can either pass the last four digits of the card number or the full card number.
       # * <tt>:first_name</tt> -- The first name of the account being refunded.
       # * <tt>:last_name</tt> -- The last name of the account being refunded.
       # * <tt>:zip</tt> -- The postal code of the account being refunded.
@@ -257,7 +258,7 @@ module ActiveMerchant #:nodoc:
       end
 
       private
-      
+
       def commit(action, money, parameters)
         parameters[:amount] = amount(money) unless action == 'VOID'
 
@@ -278,8 +279,8 @@ module ActiveMerchant #:nodoc:
         #   (TESTMODE) Successful Sale
         test_mode = test? || message =~ /TESTMODE/
 
-        Response.new(success?(response), message, response, 
-          :test => test_mode, 
+        Response.new(success?(response), message, response,
+          :test => test_mode,
           :authorization => response[:transaction_id],
           :fraud_review => fraud_review?(response),
           :avs_result => { :code => response[:avs_result_code] },
@@ -300,7 +301,7 @@ module ActiveMerchant #:nodoc:
 
         results = {
           :response_code => fields[RESPONSE_CODE].to_i,
-          :response_reason_code => fields[RESPONSE_REASON_CODE], 
+          :response_reason_code => fields[RESPONSE_REASON_CODE],
           :response_reason_text => fields[RESPONSE_REASON_TEXT],
           :avs_result_code => fields[AVS_RESULT_CODE],
           :transaction_id => fields[TRANSACTION_ID],
@@ -353,7 +354,7 @@ module ActiveMerchant #:nodoc:
           post[:customer_ip] = options[:ip]
         end
       end
-      
+
       # x_duplicate_window won't be sent by default, because sending it changes the response.
       # "If this field is present in the request with or without a value, an enhanced duplicate transaction response will be sent."
       # (as of 2008-12-30) http://www.authorize.net/support/AIM_guide_SCC.pdf
@@ -373,7 +374,7 @@ module ActiveMerchant #:nodoc:
           post[:country] = address[:country].to_s
           post[:state]   = address[:state].blank?  ? 'n/a' : address[:state]
         end
-        
+
         if address = options[:shipping_address]
           post[:ship_to_first_name] = address[:first_name].to_s
           post[:ship_to_last_name] = address[:last_name].to_s
@@ -398,11 +399,11 @@ module ActiveMerchant #:nodoc:
         end
       end
 
-      def message_from(results)  
+      def message_from(results)
         if results[:response_code] == DECLINED
           return CVVResult.messages[ results[:card_code] ] if CARD_CODE_ERRORS.include?(results[:card_code])
           if AVS_REASON_CODES.include?(results[:response_reason_code]) && AVS_ERRORS.include?(results[:avs_result_code])
-            return AVSResult.messages[ results[:avs_result_code] ] 
+            return AVSResult.messages[ results[:avs_result_code] ]
           end
         end
 
@@ -484,7 +485,7 @@ module ActiveMerchant #:nodoc:
           xml.tag!('name', options[:subscription_name]) if options[:subscription_name]
           # Contains information about the payment schedule
           add_arb_payment_schedule(xml, options)
-          # The amount to be billed to the customer 
+          # The amount to be billed to the customer
           # for each payment in the subscription
           xml.tag!('amount', amount(options[:amount])) if options[:amount]
           if trial = options[:trial]
@@ -523,7 +524,7 @@ module ActiveMerchant #:nodoc:
       def add_arb_duration(xml, options)
         duration = options[:duration]
         return unless duration
-        # The date the subscription begins 
+        # The date the subscription begins
         # (also the date the initial billing occurs)
         xml.tag!('startDate', duration[:start_date]) if duration[:start_date]
         # Number of billing occurrences or payments for the subscription
@@ -569,7 +570,7 @@ module ActiveMerchant #:nodoc:
       end
 
       # Adds customer’s bank account information
-      # Note: This element should only be included 
+      # Note: This element should only be included
       # when the payment method is bank account.
       def add_arb_bank_account(xml, options)
         bank_account = options[:bank_account]
@@ -581,10 +582,10 @@ module ActiveMerchant #:nodoc:
           xml.tag!('routingNumber', bank_account[:routing_number])
           # The bank account number used for payment of the subscription
           xml.tag!('accountNumber', bank_account[:account_number])
-          # The full name of the individual associated 
+          # The full name of the individual associated
           # with the bank account number
           xml.tag!('nameOfAccount', bank_account[:name_of_account])
-          # The full name of the individual associated 
+          # The full name of the individual associated
           # with the bank account number (optional)
           xml.tag!('bankName', bank_account[:bank_name]) if bank_account[:bank_name]
           # The type of electronic check transaction used for the subscription
@@ -655,7 +656,7 @@ module ActiveMerchant #:nodoc:
       def recurring_commit(action, request)
         url = test? ? arb_test_url : arb_live_url
         xml = ssl_post(url, request, "Content-Type" => "text/xml")
-        
+
         response = recurring_parse(action, xml)
 
         message = response[:message] || response[:text]