activemerchant 1.1.0 → 1.2.0

data/CHANGELOG

@@ -1,5 +1,231 @@
 # CHANGELOG
 # ---
+# * Update Linkpoint tests to remove useless pem file [cody]
+#
+# * Use symbols for CreditCard error messages, since errors have indifferent access [cody]
+#
+# * Improve CreditCard error messages [George Ogata]
+#
+# * Change deny to assert_false, and deny_success to assert_failure.  Remove Gateway.gateway, as it is available from Base [cody]
+#
+# * Improve documentation, and test coverage [James Herdman]
+#
+# * Refactor MonerisGateway, improve test coverage and documentation [James Herdman]
+#
+# * Add support for crediting to Moneris [James Herdman]
+#
+# * Send state N/A in Payflow when the state is blank.  Fixes UK PayPal Express payments when not providing a state [cody]
+#
+# * Load remote test credentials from a fixtures file.  ActiveMerchant will look for a custom file ~/.active_merchant/fixtures.yml.  If the file exists it will be loaded instead of the default fixtures provided by ActiveMerchant.  This makes development easier, and removes the risk of committing non-public test account credentials to subversion. [cody]
+#
+# * Add support for password protected pem files [cody]
+#
+# * Add support for Concord Efsnet payment gateway [snacktime]
+#
+# * Fix dependency loading for gateways that are subclasses [cody]
+#
+# * Add Braintree payment gateway [Michael J. Mangino]
+#
+# * Add support for PayPal API signatures [Benjamin Curtis, cody]
+#
+# * Add payment gateway Viaklix [Sal Scotto, cody]
+#
+# * Add Australian payment gateway NetRegistry [George Ogata]
+#
+# * Take order email from the options hash instead of the address for CyberSource [cody]
+#
+# * Use an array for LineItems when calculating tax in CyberSource gateway [cody]
+#
+# * Add CyberSource gateway [Matt Margolis]
+#
+# * Sanitize Protx order id [cody]
+#
+# * Fix support for electron in Protx [cody]
+#
+# * Add support for Protx [shiftx, cody]
+#
+# * Use undef_method with a single argument in SecurePay to prevent JRuby from choking on it. [jonathan.l.bartlett]
+#
+# * Default address_override to 0 for PayPal Website Payments Standard payments. [cody]
+#
+# * Enhance credit card error messages [manfred]
+#
+# * Use HashWithIndifferentAccess for CreditCard for compatibility with Rails applications [michael.j.mangino]
+#
+# * Fix nil exception when no response reason text is found in Authorize.net [cody]
+#
+# * Add support for PayJunction [Matt Sanders] 
+#
+# * Change billing_address to shipping_address in PayPal Integration helper, as billing_address was incorrect.  Addresses passed to billing_address for the PayPal helper will no longer be added to the form. This will break existing code, as the address will not be passed.
+#
+# * Remove switch patterns from card detection that were eliminated on July 1, 2007 [cody]
+#
+# * Format the issue number in Payflow requests to always be 2 digits [cody]
+#
+# * Move application_id to Gateway and Helper class respectively [cody]
+#
+# * Improve TrustCommerce documentation [cody]
+#
+# * Add credit to Payflow [cody]
+#
+# * Add support for the Plug 'N Pay gateway [ryan.norbauer, cody]
+#
+# * Add support for ItemTotal, Shipping, Handling, and Tax amounts in the PayPal Express and PayPal gateways [baldwindavid, cody]
+#
+# * Add page customization options to the PaypalExpress, and PayflowExpress gateways [ cpjolicoeur, cody]
+#
+# * Add Verifi gateway [Paul Hepworth]
+#
+# * Add a PayflowResponse object with a profile_id accessor method.  Return the correct authorization number on recurring actions [cody]
+#
+# * Add support for an initial transaction with recurring payments [findchris, cody]
+#
+# * Add support for email receipts to recurring Payflow Payments [Rick Olson]
+#
+# * Ensure the ButtonSource isn't too long [cody]
+#
+# * Add ButtonSource to Paypal and PaypalExpress gateways [cody]
+#
+# * Rename application to application_id and place it on Base, so it can be set once and forgotten about [cody]
+#
+# * Add ButtonSource field to PayflowExpress gateway [cody]
+#
+# * Add a field for the bn to the PayPal helper [cody]
+#
+# * Add remote secure pay test and correctly define test? [cody]
+#
+# * Undefine unsupported methods from SecurePay [cody]
+#
+# * Enhance the TransFirst error message for declined transactions [cody]
+#
+# * Add initial support for TransFirst gateway [cody]
+#
+# * Deprecate certification_id in Payflow gateways [cody]
+#
+# * Work around required PayPal state fields for countries that don't require states [cody]
+#
+# * Add metadata to SecurePay gateway [cody]
+#
+# * Add initial support for the SecurePay gateway using the Authorize.net translator [cody]
+#
+# * Add the homepage_url and display_name accessors to each gateway [cody]
+#
+# * Remove Money dependency from main gateways. Cleanup tests.  Add supported_countries class accessor which returns an array of 2 digit iso country codes for which countries the gateway supports accounts in [cody]
+#
+# * Add American Express card to Psigate [cody]
+#
+# * Send N/A to PayPal in the PayPal Helper when we don't know the UK county [cody]
+#
+# * Actually pass the amount of the capture through to Payflow [cody]
+#
+# * Update ExactGateway test and test mode [cody]
+#
+# * Remove unused method in PslCardGateway [cody]
+#
+# * Add updated credit card tests [cody]
+#
+# * Update and test PslCardGateway [cody]
+#
+# * Add Laser card type [cody]
+#
+# * Update Nochex documentation [cody]
+#
+# * Sanitize the Realex order_id [cody] 
+#
+# * Add support for Irish Realex payment gateway [John Ward, cody]
+#
+# * Move credit_card helper method to the test_helper [cody]
+#
+# * Update PayflowExpressResponse to match the interface of the PayflowExpressResponse.  Add :no_shipping and :address_override options to PayflowExpress [cody]
+#
+# * Add a currency option to the Payflow and Paypal gateways [cody]
+#
+# * PaypalExpress should use the shipping address, not the billing address [cody]
+#
+# * Allow overriding the user with Payflow so that a vendor and user can be provided when making requests [cody]
+#
+# * PayPal DirectPayment API requires a UK County to be sent as the state or province.  Return N/A as the state when one isn't provided to ensure that PayPal doesn't reject the payment [cody]
+#
+# * Add ability to perform reference transactions with Payflow [Al Evans, cody]
+#
+# * Enhance recurring Payflow tests and recurring_inquiry [Al Evans]
+#
+# * Add recurring payments to Payflow [Rick Olson]
+#
+# * Improve the error message generated by requires! [cody]
+#
+# * Update credit card regular expressions and update Quickpay gateway with tests for new cards [cody]
+#
+# * Add support for token based payments to PaymentExpress [Nik Wakelin]
+#
+# * Refactor default_currency to the base gateway class [cody]
+#
+# * Clean unsupported characters from the Quickpay ordernum [cody]
+#
+# * Call the :sale and :authorization in QuickpayGateway [cody]
+# 
+# * Add Danish gateway Quickpay [cody]
+#
+# * Remove redundant hash brackets from generator template [cody]
+#
+# * Add additional options to the PayPal Website Payments Standard Helper [Rick Olson]
+#
+# * Move generate_unique_id method to Gateway class so other gateways can also use it [cody]
+#
+# * Allow notification name / value pairs to have a . in the name like checkout.x = 400 [cody]
+#
+# * Fix PaypalExpressGateway#purchase to have the same method signature as other gateways [cody]
+#
+# * Cargo cult off the rails unique id generator instead of UUID library [cody]
+#
+# * Add uuid-1.0.3 for generating random request UUIDs [cody]
+#
+# * Remove mock_methods and http mock from the library [cody]
+#
+# * PaypalExpress cannot setup a payment for 0 dollars.  If the amount is zero then setup a payment for $1. [cody]
+#
+# * Small changes to PslCard gateway [cody]
+#
+# * Fix Money dependency with PslCard gateway [cody]
+#
+# * Add PslCard payment gateway [MoneySpyder http://moneyspyder.co.uk]
+#
+# * Scrub the card number, expiry, and CVV code from the response [cody]
+#
+# * Use test? query for checking test mode [cody]
+#
+# * Add support for the E-xact Payment Gateway [James Edward Gray II, cody]
+#
+# * Fix partially broken method of dealing with phone numbers in the PayPal Helper [cody]
+#
+# * Update remote tests for PaymentExpress [cody]
+#
+# * Add Content-Type header to PaymentExpress post [cody]
+#
+# * Use DECLINED as the message for declined transactions in the PaymentExpress remote tests [cody]
+#
+# * Add JCB as a supported card type for the PaymentExpressGateway [cody]
+#
+# * Rename DpsGateway to PaymentExpressGateway [cody]
+#
+# * Add DPS Payment Express gateway (NZ) [dgjones, cody]
+#
+# * Remove duplicate and incorrect expdate method from Authorize.net [cody]
+#
+# * Allow authorization and purchase using a billing_id retrieved from TrustCommerce citadel [jesse.c.scott]
+#
+# * Don't return a frozen string from CreditCard.type? [cody]
+#
+# * Update remote Psigate test to ensure using a verification value doesn't break anything [cody]
+#
+# * Update remote Moneris test to ensure using a verification value doesn't break anything [cody]
+#
+# * Fix Solo issue number with CardStream gateway and improve test coverage [cody]
+#
+# * Add CardStream gateway [Jonah Fox, Thomas Nichols, cody]
+#
+# * Verify Peer in PayPal notifications and add account method [cody]
+# 
 # * Mark 1.1.0 release 
 #
 # * Add unique_id option to PayPal mass payments [Haig]

data/CONTRIBUTERS

@@ -0,0 +1,52 @@
+Protx Gateway
+
+* Contributed by shiftx (Vincent)
+
+Verifi Gateway
+
+* Contributed by Paul Hepworth on 2007-05-12.
+* Portions of Verifi Gateway Copyright (c) 2007 Paul Hepworth
+
+Plug 'N Pay Gateway
+
+* Contributed by Ryan Norbauer
+
+PayJunction Gateway
+
+* Contributed by Matt Sanders
+
+E-xact Gateway
+
+* Contributed by James Edward Gray II
+
+Linkpoint Gateway
+
+* Portions of the LinkPoint Gateway by Ryan Heneise
+
+eWay Gateway
+
+* Originally contributed by Lucas Carlson  (mailto:lucas@rufy.com)
+
+CardStream Gateway
+
+* Portions of the Cardstream gateway by Jonah Fox and Thomas Nichols
+
+CyberSource Gateway
+
+* Contributed by Matt Margolis (matt@mattmargolis.net)
+
+NetRegistry Gateway
+
+* Originally contributed by George Ogata (mailto: george.ogata@gmail.com)
+
+Viaklix Gateway (Sep 3, 2007)
+
+* Originally contributed by Sal Scotto
+
+Braintree Gateway (Sep 4, 2007)
+
+* Originally contributed by Michael J. Mangino
+
+Concord Efsnet Gateway (Sep 7, 2007)
+
+* Originally contributed by snacktime

data/README

@@ -8,30 +8,38 @@ This library is the foundation of commerce for http://www.shopify.com.
 Please visit the {ActiveMerchant homepage}[http://activemerchant.org] for more resources, tutorials and other information about this project. 
 
 == Supported Direct Payment Gateways
- 
-* Bogus -- your trusty test gateway which does nothing. Great for testing your app!
-
-==== Australia
-
-* eWay[http://www.eway.com.au] 
-
-==== Canada
-
-* Moneris[http://www.moneris.com]
-* Psigate[http://www.psigate.com]
-
-==== United Kingdom
-
-* {PayPal Website Payments Pro UK}[https://www.paypal.com/uk/cgi-bin/webscr?cmd=_wp-pro-overview-outside]
-
-==== USA
 
-* Authorize.net[http://www.authorize.net]
-* LinkPoint[http://www.linkpoint.com]
-* {PayPal Payflow Pro}[https://www.paypal.com/cgi-bin/webscr?cmd=_payflow-gateway-overview-outside]
-* {PayPal Website Payments Pro US}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside]
-* TrustCommerce[http://www.trustcommerce.com] - Requires the tclink ruby library from http://www.trustcommerce.com/tclink.html. Otherwise it will not be loaded.
-* {USA ePay}[www.usaepay.com/]
+* {Authorize.net}[http://www.authorize.net/] - US
+* {Braintree}[http://www.braintreepaymentsolutions.com] - US
+* {CardStream}[http://www.cardstream.com/] - GB
+* {CyberSource}[http://www.cybersource.com] - US
+* {DataCash}[http://www.datacash.com/] - GB
+* {Efsnet}[http://www.concordefsnet.com/] - US
+* {eWAY}[http://www.eway.com.au/] - AU
+* {E-xact}[http://www.e-xact.com] - CA, US
+* {LinkPoint}[http://www.linkpoint.com/] - US
+* {Moneris}[http://www.moneris.com/] - CA
+* {NetRegistry}[http://www.netregistry.com.au] - AU
+* {PayJunction}[http://www.payjunction.com/] - US
+* {PayPal Express Checkout}[https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside] - US, CA, SG, AU
+* {PayPal Express Checkout (UK)}[https://www.paypal.com/uk/cgi-bin/webscr?cmd=_additional-payment-overview-outside] - GB
+* {PayPal Payflow Pro}[https://www.paypal.com/cgi-bin/webscr?cmd=_payflow-pro-overview-outside] - US, CA, SG, AU
+* {PayPal Website Payments Pro (UK)}[https://www.paypal.com/uk/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - GB
+* {PaymentExpress}[http://www.paymentexpress.com/] - AU, MY, NZ, SG, ZA, GB, US
+* {PayPal Express Checkout}[https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside] - US
+* {PayPal Website Payments Pro (US)}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - US
+* {Plug'n Pay}[http://www.plugnpay.com/] - US
+* {Protx}[http://www.protx.com] - GB
+* {Psigate}[http://www.psigate.com/] - CA
+* {PSL Payment Solutions}[http://www.paymentsolutionsltd.com/] - GB
+* {Quickpay}[http://quickpay.dk/] - DK
+* {Realex}[http://www.realexpayments.com/] - IE, GB
+* {SecurePay}[http://www.securepay.com/] - US
+* {TransFirst}[http://www.transfirst.com/] - US
+* {TrustCommerce}[http://www.trustcommerce.com/] - US
+* {USA ePay}[http://www.usa_epay.com/] - US
+* {Verifi}[http://www.verifi.com/] - US
+* {ViaKLIX}[http://viaklix.com] - US
 
 == Supported Offsite Payment Gateways
  
@@ -39,6 +47,7 @@ Please visit the {ActiveMerchant homepage}[http://activemerchant.org] for more r
 * Chronopay[http://www.chronopay.com]
 * Nochex[http://www.nochex.com]
 * {Banca Sella GestPay}[https://www.sella.it/banca/ecommerce/gestpay/gestpay.jsp]
+* {2 Checkout}[http://www.2checkout.com]
  
 == Download
 
@@ -68,7 +77,8 @@ Installation from RubyGems
 
 == Sample Usage
 
-  ten_dollars = Money.new(1000, 'USD')
+  # 10 dollars in cents
+  ten_dollars = 1000
 
   credit_card = CreditCard.new(
     :number => '4242424242424242',

data/Rakefile

@@ -0,0 +1,152 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+require File.dirname(__FILE__) + '/lib/tasks/cia'
+require File.dirname(__FILE__) + '/lib/support/gateway_support'
+
+
+PKG_VERSION = "1.2.0"
+PKG_NAME = "activemerchant"
+PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
+
+PKG_FILES = FileList[
+    "lib/**/*", "test/**/*", "script/**/*", "[a-zA-Z]*"
+].exclude(/\.svn$/)
+
+
+desc "Default Task"
+task :default => 'test:units'
+
+# Run the unit tests
+namespace :test do
+
+  Rake::TestTask.new(:units) do |t|
+    t.pattern = 'test/unit/**/*_test.rb'
+    t.ruby_opts << '-rubygems'
+    t.verbose = true
+  end
+
+  Rake::TestTask.new(:remote) do |t|
+    t.pattern = 'test/remote_tests/*_test.rb'
+    t.ruby_opts << '-rubygems'
+    t.verbose = true
+  end
+
+end
+
+# Genereate the RDoc documentation
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = "ActiveMerchant library"
+  rdoc.options << '--line-numbers' << '--inline-source' << '--main=README'
+  rdoc.rdoc_files.include('README', 'CHANGELOG')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.exclude('lib/tasks')
+end
+
+task :install => [:package] do
+  `gem install pkg/#{PKG_FILE_NAME}.gem`
+end
+
+task :lines do
+  lines = 0
+  codelines = 0
+  Dir.foreach("lib") { |file_name| 
+    next unless file_name =~ /.*rb/
+
+    f = File.open("lib/" + file_name)
+
+    while line = f.gets
+      lines += 1
+      next if line =~ /^\s*$/
+      next if line =~ /^\s*#/
+      codelines += 1
+    end
+  }
+  puts "Lines #{lines}, LOC #{codelines}"
+end
+
+desc "Delete tar.gz / zip / rdoc"
+task :cleanup => [ :clobber_package, :clobber_rdoc ]
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.summary = "Framework and tools for dealing with credit card transactions."
+  s.has_rdoc = true
+
+  s.files = PKG_FILES
+
+  s.require_path = 'lib'
+  s.autorequire  = 'active_merchant'
+  s.author = "Tobias Luetke"
+  s.email = "tobi@leetsoft.com"
+  s.homepage = "http://activemerchant.org/"
+  
+  s.add_dependency('activesupport', '>= 1.4.1')
+  s.add_dependency('builder', '>= 2.0.0')
+  
+  s.signing_key = ENV['GEM_PRIVATE_KEY']
+  s.cert_chain  = ['gem-public_cert.pem']
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+desc "Continuously watch unit tests"
+task :watch do
+  system("clear")
+  system("stakeout \"rake\" `find . -name '*.rb'`")
+end
+
+desc "Release the gems and docs to RubyForge"
+task :release => [ :publish, :upload_rdoc ]
+
+desc "Publish the release files to RubyForge."
+task :publish => [ :package ] do
+  require 'rubyforge'
+  
+  packages = %w( gem tgz zip ).collect{ |ext| "pkg/#{PKG_NAME}-#{PKG_VERSION}.#{ext}" }
+  
+  rubyforge = RubyForge.new
+  rubyforge.login
+  rubyforge.add_release(PKG_NAME, PKG_NAME, "REL #{PKG_VERSION}", *packages)
+end
+
+desc 'Upload RDoc to RubyForge'
+task :upload_rdoc => :rdoc do
+  user = ENV['RUBYFORGE_USER'] 
+  project = "/var/www/gforge-projects/#{PKG_NAME}"
+  local_dir = 'doc'
+  pub = Rake::SshDirPublisher.new user, project, local_dir
+  pub.upload
+end
+
+namespace :gateways do
+  desc 'Print the currently supported gateways in RDoc format'
+  task :print_support_rdoc do
+    support = GatewaySupport.new
+    support.to_rdoc
+  end
+  
+  desc 'Print the currently supported gateways'
+  task :print_support do
+    support = GatewaySupport.new
+    support.to_s
+  end
+  
+  desc 'Print the currently supported gateways'
+  task :print_support_textile do
+    support = GatewaySupport.new
+    support.to_textile
+  end
+end
+  
+  
+