maedana-activemerchant 1.9.1.1

data/lib/active_merchant/billing/gateways/paypal/paypal_payment_details_response.rb

@@ -0,0 +1,70 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class PaypalPaymentDetailsResponse < Response
+      def action_type
+        @params['action_type']
+      end 
+      
+      def cancel_url
+        @params['cancel_url']
+      end
+
+      def currency_code
+        @params['currency_code']
+      end
+
+      def fees_payer
+        @params['fees_payer']
+      end
+
+      def ipn_notification_url
+        @params['ipn_notification_url']
+      end
+
+      def memo
+        @params['memo']
+      end
+
+      def payment_list
+        @params['payment_list']
+      end
+
+      def return_url
+        @params['return_url']
+      end
+
+      def ipn_notification_url
+        @params['ipn_notifcation_url']
+      end
+
+      def sender_email
+        @params['sender_email']
+      end
+
+      def status
+        @params['status']
+      end
+
+      def tracking_id
+        @params['tracking_id']
+      end
+
+      def fees_payer
+        @params['fees_payer']
+      end
+
+      def reverse_all_parallel_payments_on_error
+        @params['reverse_all_parallel_payments_on_error'] == 'true'
+      end
+
+      def log_default_shipping_address
+        @params['log_default_shipping_address'] == 'true'
+      end
+
+      def preapproval_key
+        @params['preapproval_key']
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,298 @@
+require File.dirname(__FILE__) + '/paypal/paypal_payment_details_response'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class PaypalAdaptivePaymentGateway < Gateway
+      include PaypalExpressCommon
+
+      TEST_URL = 'https://svcs.sandbox.paypal.com/AdaptivePayments'
+      LIVE_URL = 'https://svcs.paypal.com/AdaptivePayments'
+
+      self.test_redirect_url = 'https://www.sandbox.paypal.com/cgi-bin/webscr?cmd='
+      self.live_redirect_url = 'https://www.paypal.com/cgi-bin/webscr?cmd='
+
+
+      API_VERSION = '1.1.0'
+      
+      SUCCESS_CODES = [ 'Success', 'SuccessWithWarning' ]
+
+      PAYMENT_PERIODS = ['DAILY', 'WEEKLY', 'BIWEEKLY', 'SEMIMONTHLY', 'MONTHLY', 'ANNUALLY']
+
+      FEES_PAYER_OPTIONS = ['SENDER', 'PRIMARYRECEIVER', 'EACHRECEIVER', 'SECONDARYONLY']
+ 
+      # The countries the gateway supports merchants from as 2 digit ISO country codes
+      self.supported_countries = ['US']
+      
+      # The card types supported by the payment gateway
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+      
+      # The homepage URL of the gateway
+      self.homepage_url = 'http://x.com/'
+      
+      # The name of the gateway
+      self.display_name = 'Paypal Adaptive Payments'
+
+      self.default_currency = 'USD'
+      
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        @options = options
+        super
+      end  
+
+      # Pay money to one or more recievers
+      #
+      #   gateway.pay 1000, 'bob@example.com',
+      #     :sender_email => "john@example.com", :return_url => "http://example.com/return", :cancel_url => "http://example.com/cancel"
+      #
+      #   gateway.pay [1000, 'fred@example.com'],
+      #     [2450, 'wilma@example.com', :primary => true],
+      #     [2000, 'barney@example.com'],
+      #     :sender_email => "john@example.com", :return_url => "http://example.com/return", :cancel_url => "http://example.com/cancel"
+      #
+      def pay(*args)
+        commit('Pay', build_pay_request(*args))
+      end
+
+      def payment_details(token, options = {})
+        commit('PaymentDetails', build_payment_details_request(token, options))
+      end
+
+      def preapproval(options)
+        requires!(options, :return_url, :cancel_url, :ending_date)
+        commit('Preapproval', build_preapproval_request(options))
+      end
+
+      def preapproval_details(token, options = {})
+        commit('PreapprovalDetails', build_preapproval_details_request(token, options))
+      end
+
+      def refund(*args)
+        commit('Refund', build_refund_request(*args))
+      end
+
+      def redirect_url_for(token, options = {})
+        if token =~ /AP\-/
+          "#{redirect_url}_ap-payment&payKey=#{token}"
+        elsif token =~ /PA\-/
+          "#{redirect_url}_ap-preapproval&preapprovalkey=#{token}"
+        end
+      end
+
+      private                       
+
+      def endpoint_url
+        test? ? TEST_URL : LIVE_URL
+      end
+
+      def build_pay_request(*args)
+        default_options = args.last.is_a?(Hash) ? args.pop : {}
+        receivers = args.first.is_a?(Array) ? args : [args]
+
+        requires!(default_options, :return_url, :cancel_url)
+
+        currency = options[:currency] || currency(receivers.first[0])
+
+        xml = Builder::XmlMarkup.new
+        add_client_details(xml, default_options)
+        xml.tag! 'actionType', 'PAY'
+        xml.tag! 'feesPayer', fees_payer_option(default_options[:fees_payer]) unless default_options[:fees_payer].blank?
+        xml.tag! 'cancelUrl', default_options[:cancel_url]
+        xml.tag! 'currencyCode', currency
+        xml.tag! 'ipnNotificationUrl', default_options[:ipn_notification_url] unless default_options[:ipn_notification_url].blank?
+        xml.tag! 'logDefaultShippingAddress', true if default_options[:log_default_shipping_address]
+        xml.tag! 'memo', default_options[:memo] unless default_options[:memo].blank?
+        xml.tag! 'pin', default_options[:pin] unless default_options[:pin].blank?
+        xml.tag! 'preapprovalKey', default_options[:preapproval_key] unless default_options[:preapproval_key].blank?
+        xml.tag! 'receiverList' do
+          receivers.each do |money, receiver, options|
+            options ||= default_options
+            xml.tag! 'receiver' do
+              xml.tag! 'amount', amount(money)
+              xml.tag! 'email', receiver
+              xml.tag! 'primary', true if options[:primary]
+            end
+          end
+        end
+        xml.tag! 'reverseAllParallelPaymentsOnError', true if default_options[:reverse_all_parallel_payments_on_error]
+        xml.tag! 'senderEmail', default_options[:sender_email] unless default_options[:sender_email].blank?
+        xml.tag! 'returnUrl', default_options[:return_url]
+        xml.tag! 'trackingId', default_options[:tracking_id] unless default_options[:tracking_id].blank?
+        xml.target!
+      end
+
+      def build_payment_details_request(token, options)
+        xml = Builder::XmlMarkup.new
+        add_client_details(xml, options)
+        xml.tag! 'payKey', token unless token.blank?
+        xml.tag! 'transactionId', options[:transaction_id] unless options[:transaction_id].blank?
+        xml.tag! 'trackingId', options[:tracking_id] unless options[:tracking_id].blank?
+        xml.target!
+      end
+
+      def build_preapproval_request(options)
+        xml = Builder::XmlMarkup.new
+        add_client_details(xml, options)
+        xml.tag! 'cancelUrl', options[:cancel_url]
+        xml.tag! 'currencyCode', options[:currency] || self.default_currency
+        xml.tag! 'dateOfMonth', options[:date_of_month] unless options[:date_of_month].blank?
+        xml.tag! 'dayOfWeek', day_of_week(options[:date_of_week]) unless options[:date_of_week].blank?
+        xml.tag! 'endingDate', options[:ending_date]
+        xml.tag! 'maxAmountPerPayment', money(options[:max_amount_per_payment]) unless options[:max_amount_per_payment].blank?
+        xml.tag! 'maxNumberOfPayments', options[:max_number_of_payments] unless options[:max_number_of_payments].blank?
+        xml.tag! 'maxNumberOfPaymentsPerPeriod', options[:max_number_of_payments_per_period] unless options[:max_number_of_payments_per_period].blank?
+        xml.tag! 'paymentPeriod', payment_period(options[:payment_period]) unless options[:payment_period].blank?
+        xml.tag! 'senderEmail', options[:sender_email] unless options[:sender_email].blank?
+        xml.tag! 'returnUrl', options[:return_url]
+        xml.target!
+      end
+
+      def build_preapproval_details_request(token, options)
+        xml = Builder::XmlMarkup.new
+        add_client_details(xml, options)
+        xml.tag! 'preapprovalKey', token
+        xml.target!
+      end
+
+      def build_refund_request(*args)
+        default_options = args.last.is_a?(Hash) ? args.pop : {}
+        receivers = if args.first
+                     args.first.is_a?(Array) ? args : [args]
+                   else
+                     []
+                   end
+
+        currency = options[:currency] || (currency(receivers.first[0]) unless receivers.empty?) || self.default_currency
+
+        xml = Builder::XmlMarkup.new
+        add_client_details(xml, default_options)
+        xml.tag! 'currencyCode', currency
+        xml.tag! 'payKey', default_options[:pay_key] unless default_options[:pay_key].blank?
+        xml.tag! 'trackingId', default_options[:tracking_id] unless default_options[:tracking_id].blank?
+        xml.tag! 'transactionId', default_options[:transaction_id] unless default_options[:transaction_id].blank?
+        xml.tag! 'receivers' do
+          receivers.each do |money, receiver, options|
+            options ||= default_options
+            xml.tag! 'receiver' do
+              xml.tag! 'amount', amount(money)
+              xml.tag! 'email', receiver
+              xml.tag! 'primary', true if options[:primary]
+            end
+          end
+        end
+        xml.target!
+      end
+
+      def headers
+        {
+          "X-PAYPAL-REQUEST-DATA-FORMAT" => "XML",
+          "X-PAYPAL-RESPONSE-DATA-FORMAT" => "JSON",
+          "X-PAYPAL-SECURITY-USERID" => @options[:login],
+          "X-PAYPAL-SECURITY-PASSWORD" => @options[:password],
+          "X-PAYPAL-SECURITY-SIGNATURE" => @options[:signature],
+          "X-PAYPAL-SERVICE-VERSION" => API_VERSION,
+          "X-PAYPAL-APPLICATION-ID" => self.application_id
+        }
+      end
+
+      def day_of_week(d)
+        if d
+          if Date::DAYNAMES.include?(d.to_s.upcase)
+            d.to_s.upcase
+          elsif Date::DAYNAMES[d.to_i]
+            Date::DAYNAMES[d.to_i].upcase
+          end
+        end
+      end
+
+      def payment_period(p)
+        if p && PAYMENT_PERIODS.include?(p.to_s.upcase)
+          p.to_s.upcase
+        end
+      end
+
+      def fees_payer_option(o)
+        if o & FEES_PAYER_OPTIONS.include?(o.to_s.gsub('_', '').upcase)
+          o.to_s.gsub('_', '').upcase
+        end
+      end
+
+      def add_client_details(xml, options)
+        xml.clientDetails do
+          xml.ipAddress options[:remote_ip]
+          xml.deviceId options[:device_id] unless options[:device_id].blank?
+          xml.applicationId self.application_id
+          xml.partnerName options[:partner_name] unless options[:partner_name].blank?
+        end
+      end
+
+      def build_url(action)
+        "#{endpoint_url}/#{action}"
+      end
+
+      def successful?(response)
+        SUCCESS_CODES.include?(response[:ack])
+      end
+
+      def message_from(response)
+        response[:message] || response[:status] || response[:payment_exec_status] || response[:ack]
+      end
+
+      def authorization_from(response)
+        response[:pay_key] || response[:preapproval_key]
+      end
+
+      def build_response(action, success, message, response, options = {})
+         case action
+         when 'PaymentDetails'
+           PaypalPaymentDetailsResponse.new(success, message, response, options)
+         else
+           Response.new(success, message, response, options)
+         end
+      end
+
+      def build_request(action, body)
+        xml = Builder::XmlMarkup.new
+        xml.instruct!
+        xml.tag! "#{action}Request" do
+          xml.tag! 'requestEnvelope' do
+            xml.tag! 'detailLevel', 'ReturnAll'
+          end
+          xml << body
+        end
+        xml.target!
+      end
+
+      def parse(action, json)
+        result = ActiveSupport::JSON.decode(json)
+        response = {}
+        result.each do |k,v|
+          response[k.underscore.to_sym] = v if v.is_a?(String)
+        end
+        if result['responseEnvelope']
+          result['responseEnvelope'].each do |k,v|
+            response[k.underscore.to_sym] = v if v.is_a?(String)
+          end
+        end
+        if result['paymentInfoList']
+          response[:payment_list] = result['paymentInfoList']['paymentInfo']
+        end
+        if result['error']
+          response[:message] = result['error'].collect{|e| e['message'] }.uniq.join('. ')
+          response[:error_codes] = result['error'].collect{|e| e['errorId'] }.uniq.join(', ')
+        end
+        response
+      end
+
+      def commit(action, request)
+        response = parse(action, ssl_post(build_url(action), build_request(action,request), headers))
+        build_response(action, successful?(response), message_from(response), response, 
+          :test => test?,
+    	    :authorization => authorization_from(response)
+        )
+      end
+
+    end
+  end
+end
+

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