n8_activemerchant 1.9.3

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

@@ -0,0 +1,13 @@
+require File.dirname(__FILE__) + '/paypal'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    # The PayPal gateway for PayPal Website Payments Pro Canada only supports Visa and MasterCard
+    class PaypalCaGateway < PaypalGateway
+      self.supported_cardtypes = [:visa, :master]
+      self.supported_countries = ['CA']
+      self.homepage_url = 'https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside'
+      self.display_name = 'PayPal Website Payments Pro (CA)'
+    end
+  end
+end

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

@@ -0,0 +1,145 @@
+require File.dirname(__FILE__) + '/paypal/paypal_common_api'
+require File.dirname(__FILE__) + '/paypal/paypal_express_response'
+require File.dirname(__FILE__) + '/paypal_express_common'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class PaypalExpressGateway < Gateway
+      include PaypalCommonAPI
+      include PaypalExpressCommon
+      
+      self.test_redirect_url = 'https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token='
+      self.supported_countries = ['US']
+      self.homepage_url = 'https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside'
+      self.display_name = 'PayPal Express Checkout'
+      
+      def setup_authorization(money, options = {})
+        requires!(options, :return_url, :cancel_return_url)
+        
+        commit 'SetExpressCheckout', build_setup_request('Authorization', money, options)
+      end
+      
+      def setup_purchase(money, options = {})
+        requires!(options, :return_url, :cancel_return_url)
+        
+        commit 'SetExpressCheckout', build_setup_request('Sale', money, options)
+      end
+
+      def details_for(token)
+        commit 'GetExpressCheckoutDetails', build_get_details_request(token)
+      end
+
+      def authorize(money, options = {})
+        requires!(options, :token, :payer_id)
+      
+        commit 'DoExpressCheckoutPayment', build_sale_or_authorization_request('Authorization', money, options)
+      end
+
+      def purchase(money, options = {})
+        requires!(options, :token, :payer_id)
+        
+        commit 'DoExpressCheckoutPayment', build_sale_or_authorization_request('Sale', money, options)
+      end
+
+      private
+      def build_get_details_request(token)
+        xml = Builder::XmlMarkup.new :indent => 2
+        xml.tag! 'GetExpressCheckoutDetailsReq', 'xmlns' => PAYPAL_NAMESPACE do
+          xml.tag! 'GetExpressCheckoutDetailsRequest', 'xmlns:n2' => EBAY_NAMESPACE do
+            xml.tag! 'n2:Version', API_VERSION
+            xml.tag! 'Token', token
+          end
+        end
+
+        xml.target!
+      end
+      
+      def build_sale_or_authorization_request(action, money, options)
+        currency_code = options[:currency] || currency(money)
+        
+        xml = Builder::XmlMarkup.new :indent => 2
+        xml.tag! 'DoExpressCheckoutPaymentReq', 'xmlns' => PAYPAL_NAMESPACE do
+          xml.tag! 'DoExpressCheckoutPaymentRequest', 'xmlns:n2' => EBAY_NAMESPACE do
+            xml.tag! 'n2:Version', API_VERSION
+            xml.tag! 'n2:DoExpressCheckoutPaymentRequestDetails' do
+              xml.tag! 'n2:PaymentAction', action
+              xml.tag! 'n2:Token', options[:token]
+              xml.tag! 'n2:PayerID', options[:payer_id]
+              xml.tag! 'n2:PaymentDetails' do
+                xml.tag! 'n2:OrderTotal', localized_amount(money, currency_code), 'currencyID' => currency_code
+                
+                # All of the values must be included together and add up to the order total
+                if [:subtotal, :shipping, :handling, :tax].all?{ |o| options.has_key?(o) }
+                  xml.tag! 'n2:ItemTotal', localized_amount(options[:subtotal], currency_code), 'currencyID' => currency_code
+                  xml.tag! 'n2:ShippingTotal', localized_amount(options[:shipping], currency_code),'currencyID' => currency_code
+                  xml.tag! 'n2:HandlingTotal', localized_amount(options[:handling], currency_code),'currencyID' => currency_code
+                  xml.tag! 'n2:TaxTotal', localized_amount(options[:tax], currency_code), 'currencyID' => currency_code
+                end
+                
+                xml.tag! 'n2:NotifyURL', options[:notify_url]
+                xml.tag! 'n2:ButtonSource', application_id.to_s.slice(0,32) unless application_id.blank?
+              end
+            end
+          end
+        end
+
+        xml.target!
+      end
+
+      def build_setup_request(action, money, options)
+        currency_code = options[:currency] || currency(money)
+        
+        xml = Builder::XmlMarkup.new :indent => 2
+        xml.tag! 'SetExpressCheckoutReq', 'xmlns' => PAYPAL_NAMESPACE do
+          xml.tag! 'SetExpressCheckoutRequest', 'xmlns:n2' => EBAY_NAMESPACE do
+            xml.tag! 'n2:Version', API_VERSION
+            xml.tag! 'n2:SetExpressCheckoutRequestDetails' do
+              xml.tag! 'n2:PaymentAction', action
+              xml.tag! 'n2:OrderTotal', amount(money).to_f.zero? ? localized_amount(100, currency_code) : localized_amount(money, currency_code), 'currencyID' => currency_code
+              if options[:max_amount]
+                xml.tag! 'n2:MaxAmount', localized_amount(options[:max_amount], currency_code), 'currencyID' => currency_code
+              end
+              add_address(xml, 'n2:Address', options[:shipping_address] || options[:address])
+              xml.tag! 'n2:AddressOverride', options[:address_override] ? '1' : '0'
+              xml.tag! 'n2:NoShipping', options[:no_shipping] ? '1' : '0'
+              xml.tag! 'n2:ReturnURL', options[:return_url]
+              xml.tag! 'n2:CancelURL', options[:cancel_return_url]
+              xml.tag! 'n2:IPAddress', options[:ip] unless options[:ip].blank?
+              xml.tag! 'n2:OrderDescription', options[:description]
+              xml.tag! 'n2:BuyerEmail', options[:email] unless options[:email].blank?
+              xml.tag! 'n2:InvoiceID', options[:order_id]
+              
+              if options[:billing_agreement]
+                xml.tag! 'n2:BillingAgreementDetails' do
+                  xml.tag! 'n2:BillingType', options[:billing_agreement][:type]
+                  xml.tag! 'n2:BillingAgreementDescription', options[:billing_agreement][:description]
+                  xml.tag! 'n2:PaymentType', options[:billing_agreement][:payment_type] || 'InstantOnly'
+                end
+              end
+        
+              # Customization of the payment page
+              xml.tag! 'n2:PageStyle', options[:page_style] unless options[:page_style].blank?
+              xml.tag! 'n2:cpp-image-header', options[:header_image] unless options[:header_image].blank?
+              xml.tag! 'n2:cpp-header-back-color', options[:header_background_color] unless options[:header_background_color].blank?
+              xml.tag! 'n2:cpp-header-border-color', options[:header_border_color] unless options[:header_border_color].blank?
+              xml.tag! 'n2:cpp-payflow-color', options[:background_color] unless options[:background_color].blank?
+              
+              if options[:allow_guest_checkout]
+                xml.tag! 'n2:SolutionType', 'Sole'
+                xml.tag! 'n2:LandingPage', 'Billing'
+              end
+              
+              xml.tag! 'n2:LocaleCode', options[:locale] unless options[:locale].blank?
+            end
+          end
+        end
+
+        xml.target!
+      end
+      
+      def build_response(success, message, response, options = {})
+        PaypalExpressResponse.new(success, message, response, options)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+module ActiveMerchant
+  module Billing
+    module PaypalExpressCommon
+      def self.included(base)
+        base.cattr_accessor :test_redirect_url
+        base.cattr_accessor :live_redirect_url
+        base.live_redirect_url = 'https://www.paypal.com/cgibin/webscr?cmd=_express-checkout&token='
+      end
+      
+      def redirect_url
+        test? ? test_redirect_url : live_redirect_url
+      end
+      
+      def redirect_url_for(token, options = {})
+        options = {:review => true}.update(options)
+        options[:review] ? "#{redirect_url}#{token}" : "#{redirect_url}#{token}&useraction=commit"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,333 @@
+require 'rubygems'
+gem 'soap4r', '>= 1.5.7' # 1.5.7 or higher
+require 'soap/wsdlDriver' 
+require 'digest/sha1'
+
+# [PaySimple](http://www.paysimple.com) is a payment gateway providing credit card
+# processing, check processing and recurring / subscription billing services.
+#
+# This library provides a simple interface to find, create, edit, delete, and query subscriptions
+# and single transactions using the PaySimple SOAP API. [PaySimple API](https://www.usaepay.com/developer/docs/beta6)
+#
+# == Installation
+#
+# The simple way:
+#   $ sudo gem install paysimple
+#
+# Directly from repository:
+#   $ ./script/plugin install svn://svn.roundhaus.com/daikini/plugins/paysimple
+#
+# Directly from repository using piston:
+#   $ piston import svn://svn.roundhaus.com/daikini/plugins/paysimple vendor/plugins/paysimple
+#
+# == Configuration
+#
+# When you signup for a PaySimple account you can setup a source key and optionally a pin and client ip address.
+# These are your credentials when using the PaySimple API.
+#
+#   PaySimple.source = "My API Source Key Name"
+#   PaySimple.key = "123456"
+#   PaySimple.pin = "topsecret"
+#   PaySimple.client_ip = "192.168.0.1"
+#
+class PaySimple
+  VERSION = "1.1.0"
+  WSDL_URL = File.dirname(__FILE__) + '/usaepay.wsdl'
+  
+  class << self
+    attr_accessor :source, :key, :pin, :client_ip
+  end
+  self.key = "Spreedly"
+  
+  class Subscription
+    class << self
+      # # Bill Jennifer $12.00 monthly
+      # begin
+      #   customer_number = PaySimple::Subscription.create(
+      #     :CustomerID => 12345,
+      #     :BillingAddress => {
+      #       :FirstName => "Jennifer",
+      #       :LastName => "Smith"
+      #     },
+      #     :CreditCardData => {
+      #       :CardNumber => "4444555566667779",
+      #       :CardExpiration => "0908"
+      #     },
+      #     :Schedule => :monthly,
+      #     :Next => "2008-09-05",
+      #     :Amount => 12.00
+      #   )
+      # 
+      #   puts "Subscription created with Customer Number: #{customer_number}"
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def create(options)
+        PaySimple.send_request(:addCustomer, { :Source => PaySimple.source, :NumLeft => 0, :Enabled => true }.merge(options))
+      end
+      
+      # # Update subscription to use new credit card
+      # begin
+      #   customer_number = 12345
+      #   response = PaySimple::Subscription.update(
+      #     customer_number,
+      #     :CreditCardData => {
+      #       :CardNumber => "4444555566667779",
+      #       :CardExpiration => "0908"
+      #     }
+      #   )
+      #     
+      #   puts "Subscription updated"
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def update(customer_number, options)
+        customer = find(customer_number)
+        options = PaySimple.symbolize_hash(options)
+        
+        # Add the existing customer properties to the options hash unless they already exist
+        [
+          :CustomerID,
+          :SendReceipt, 
+          :ReceiptNote, 
+          :Notes, 
+          :User, 
+          :Source, 
+          :Schedule, 
+          :Next,
+          :NumLeft, 
+          :Amount, 
+          :Enabled, 
+          :CustomData, 
+          :Description, 
+          :OrderID
+        ].each do |property|
+          options[property] = customer[property.to_s] unless options.has_key?(property)
+        end
+        
+        # Add the existing customer address properties to the options hash unless they already exist
+        options[:BillingAddress] ||= {}
+        [
+          :FirstName,
+          :LastName,
+          :Company,
+          :Street,
+          :Street2,
+          :City,
+          :State,
+          :Zip,
+          :Country,
+          :Phone,
+          :Fax,
+          :Email
+        ].each do |property|
+          options[:BillingAddress][property] = customer["BillingAddress"][property.to_s] unless options[:BillingAddress].has_key?(property)
+        end
+        
+        # Add the existing customer credit card properties to the options hash unless they already exist
+        options[:CreditCardData] ||= {}
+        [
+          :CardNumber,
+          :CardExpiration,
+          :CardCode,
+          :AvsStreet,
+          :AvsZip,
+          :CardPresent,
+          :MagStripe,
+          :TermType,
+          :MagSupport,
+          :XID,
+          :CAVV,
+          :ECI,
+          :InternalCardAuth,
+          :Pares
+        ].each do |property|
+          options[:CreditCardData][property] = customer["CreditCardData"][property.to_s] unless options[:CreditCardData].has_key?(property)
+        end
+        
+        # Add the existing customer check properties to the options hash unless they already exist
+        options[:CheckData] ||= {}
+        [
+          :CheckNumber,
+          :Routing,
+          :Account,
+          :SSN,
+          :DriversLicense,
+          :DriversLicenseState
+        ].each do |property|
+          options[:CheckData][property] = customer["CheckData"][property.to_s] unless options[:CheckData].has_key?(property)
+        end
+        
+        PaySimple.send_request(:updateCustomer, customer_number, { :Source => PaySimple.source, :NumLeft => 0 }.merge(options))
+      end
+      
+      # # Delete subscription
+      # begin
+      #   customer_number = 12345
+      #   response = PaySimple::Subscription.delete(customer_number)
+      # 
+      #   puts "Subscription removed from active use."
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def delete(customer_number)
+        PaySimple.send_request(:deleteCustomer, customer_number)
+      end
+    
+      # # Find an existing subscription
+      # begin
+      #   customer_number = 12345
+      #   customer = PaySimple::Subscription.find(customer_number)
+      # 
+      #   puts "Found subscription for #{customer["BillingAddress"]["FirstName"], customer["BillingAddress"]["LastName"]].join(" ")}"
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def find(customer_number)
+        PaySimple.send_request(:getCustomer, customer_number)
+      end
+      
+      # # Process one-time sale against existing subscription
+      # begin
+      #   customer_number = 12345
+      #   response = PaySimple::Subscription.charge(customer_number, :Amount => 34.56)
+      # 
+      #   if response["Response"] == "Approved"
+      #     puts "One-time charge successful."
+      #   else
+      #     puts "An error occurred: #{response["Error"]}"
+      #   end
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def charge(customer_number, options, command = "", payment_method_id = 0)
+        PaySimple.send_request(:runCustomerTransaction, customer_number, options, command, payment_method_id)
+      end
+      
+      # # Search for transactions
+      # begin
+      #   response = PaySimple::Subscription.query(
+      #     [ 
+      #       { :Field => "amount", :Type => "gt", :Value => "5.0" }
+      #     ]
+      #   )
+      # 
+      #   response.transactions.each do |transaction|
+      #     puts "CustomerID = #{transaction["CustomerID"]}, Amount = #{transaction["Details"]["Amount"]}"
+      #   end
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def query(options)
+        match_all = options.delete(:match_all)
+        start = options.delete(:start) || 0
+        limit = options.delete(:limit) || 100
+        PaySimple.send_request(:searchTransactions, options, match_all, start, limit)
+      end
+    end
+  end
+  
+  class Transaction
+    class << self
+      # # Bill Jennifer $12.00
+      # begin
+      #   transaction = PaySimple::Transaction.create(
+      #     :CustomerID => 12345,
+      #     :AccountHolder => "Jennifer Smith",
+      #     :CreditCardData => {
+      #       :CardNumber => "4444555566667779",
+      #       :CardExpiration => "0908"
+      #     },
+      #     :Details => {
+      #       :Amount => 12.00
+      #     }
+      #   )
+      # 
+      #   puts "Sale transaction created with Reference Number: #{transaction["RefNum"]}"
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      #
+      # # Credit Jennifer $12.00
+      # begin
+      #   transaction = PaySimple::Transaction.create(
+      #     :CustomerID => 12345,
+      #     :AccountHolder => "Jennifer Smith",
+      #     :CreditCardData => {
+      #       :CardNumber => "4444555566667779",
+      #       :CardExpiration => "0908"
+      #     },
+      #     :Details => {
+      #       :Amount => -12.00
+      #     }
+      #   )
+      # 
+      #   puts "Credit transaction created with Reference Number: #{transaction["RefNum"]}"
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def create(options)
+        options = PaySimple.symbolize_hash(options)
+        options[:Command] ||= (options[:Details][:Amount] > 0.0 ? :sale : :credit)
+        options[:Details][:Amount] = options[:Details][:Amount].abs
+        PaySimple.send_request(:runTransaction, { :Source => PaySimple.source }.merge(options))
+      end
+      
+      # # Void an unsettled transaction 
+      # begin
+      #   reference_number = 12345
+      #   result = PaySimple::Transaction.void(reference_number)
+      #   
+      #   if result
+      #     puts "Transaction was voided"
+      #   else
+      #     puts "Unable to void transaction"
+      #   end
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def void(reference_number)
+        PaySimple.send_request(:voidTransaction, reference_number)
+      end
+      
+      # # Find an existing transaction 
+      # begin
+      #   reference_number = 12345
+      #   transaction = PaySimple::Transaction.find(reference_number)
+      #   
+      #   puts "Found transaction"
+      # rescue Exception => e
+      #   puts "An error occurred: #{e.message}"
+      # end
+      def find(reference_number)
+        PaySimple.send_request(:getTransaction, reference_number)
+      end
+    end
+  end
+  
+  class << self
+    def symbolize_hash(hash)
+      hash.inject({}) { |h,(k,v)| h[k.to_sym] = v; h }
+    end
+    
+    def token
+      seed = "#{Time.now.to_i}#{rand(999999)}"
+      hash = Digest::SHA1.hexdigest([key, seed, pin].join)
+      { 
+        'SourceKey' => key,
+        'PinHash' => {
+          'Type' => "sha1",
+          'Seed' => seed,
+          'HashValue' => hash
+        },
+        'ClientIP' => client_ip
+      }
+    end
+    
+    def send_request(request, *args)
+      @driver ||= SOAP::WSDLDriverFactory.new(WSDL_URL).create_rpc_driver
+      @driver.send(request, token, *args)
+    end
+  end
+
+end