activemerchant 1.28.0 → 1.29.0

data/lib/active_merchant/billing/integrations/liqpay/return.rb

@@ -0,0 +1,83 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Liqpay
+        class Return < ActiveMerchant::Billing::Integrations::Return
+          def self.recognizes?(params)
+            params.has_key?('amount') && params.has_key?('order_id')
+          end
+
+          def initialize(post)
+            super
+            xml = Base64.decode64(@params["operation_xml"])
+            @params.merge!(Hash.from_xml(xml)["response"])
+          end
+
+          def complete?
+            status == 'success'
+          end
+
+          def account
+            params['merchant_id']
+          end
+
+          def amount
+            BigDecimal.new(gross)
+          end
+
+          def item_id
+            params['order_id']
+          end
+
+          def transaction_id
+            params['transaction_id']
+          end
+
+          def action_name
+            params['action_name'] # either 'result_url' or 'server_url'
+          end
+
+          def version
+            params['version']
+          end
+
+          def sender_phone
+            params['sender_phone']
+          end
+
+          def security_key
+            params[ActiveMerchant::Billing::Integrations::Liqpay.signature_parameter_name]
+          end
+
+          def gross
+            params['amount']
+          end
+
+          def currency
+            params['currency']
+          end
+
+          def status
+            params['status'] # 'success', 'failure' or 'wait_secure'
+          end
+
+          def code
+            params['code']
+          end
+
+          def generate_signature_string
+            ['', version, @options[:secret], action_name, sender_phone, account, gross, currency, item_id, transaction_id, status, code, ''].flatten.compact.join('|')
+          end
+
+          def generate_signature
+            Base64.encode64(Digest::SHA1.digest(generate_signature_string)).gsub(/\n/, '')
+          end
+
+          def acknowledge
+            security_key == generate_signature
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/moneybookers/helper.rb

@@ -26,6 +26,17 @@ module ActiveMerchant #:nodoc:
           mapping :return_url, 'return_url'
           mapping :cancel_return_url, 'cancel_url'
           mapping :description, 'detail1_text'
+
+          MAPPED_COUNTRY_CODES = {
+            'SE' => 'SV', 
+            'DK' => 'DA'
+          }
+
+          SUPPORTED_COUNTRY_CODES = [
+            'FI', 'DE', 'ES', 'FR', 
+            'IT','PL', 'GR', 'RO', 
+            'RU', 'TR', 'CN', 'CZ', 'NL'
+          ]
           
           def initialize(order, account, options = {})
             super
@@ -34,7 +45,6 @@ module ActiveMerchant #:nodoc:
             add_seller_details(options)
           end
 
-
           private
           
           def add_tracking_token
@@ -51,6 +61,12 @@ module ActiveMerchant #:nodoc:
           def add_seller_details(options)
             add_field('recipient_description', options[:account_name]) if options[:account_name]
             add_field('country', lookup_country_code(options[:country], :alpha3)) if options[:country]
+            add_field('language', locale_code(options[:country])) if options[:country]
+          end
+
+          def locale_code(country_code)
+            return country_code if SUPPORTED_COUNTRY_CODES.include?(country_code)
+            MAPPED_COUNTRY_CODES[country_code] || 'EN'
           end
         end
       end

data/lib/active_merchant/billing/integrations/notification.rb

@@ -45,6 +45,10 @@ module ActiveMerchant #:nodoc:
           return true if ActiveMerchant::Billing::Base.integration_mode == :test || production_ips.blank?
           production_ips.include?(ip)
         end
+
+        def test?
+          false
+        end
         
         private
 

data/lib/active_merchant/billing/integrations/pay_fast.rb

@@ -0,0 +1,70 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+
+      # Documentation:
+      # https://www.payfast.co.za/s/std/integration-guide
+      module PayFast
+        autoload :Return, File.dirname(__FILE__) + '/pay_fast/return.rb'
+        autoload :Helper, File.dirname(__FILE__) + '/pay_fast/helper.rb'
+        autoload :Notification, File.dirname(__FILE__) + '/pay_fast/notification.rb'
+        autoload :Common, File.dirname(__FILE__) + '/pay_fast/common.rb'
+
+        # Overwrite this if you want to change the PayFast sandbox url
+        mattr_accessor :process_test_url
+        self.process_test_url = 'https://sandbox.payfast.co.za/eng/process'
+
+        # Overwrite this if you want to change the PayFast production url
+        mattr_accessor :process_production_url
+        self.process_production_url = 'https://www.payfast.co.za/eng/process'
+
+        # Overwrite this if you want to change the PayFast sandbox url
+        mattr_accessor :validate_test_url
+        self.validate_test_url = 'https://sandbox.payfast.co.za/eng/query/validate'
+
+        # Overwrite this if you want to change the PayFast production url
+        mattr_accessor :validate_production_url
+        self.validate_production_url = 'https://www.payfast.co.za/eng/query/validate'
+
+        mattr_accessor :signature_parameter_name
+        self.signature_parameter_name = 'signature'
+
+        def self.service_url
+          mode = ActiveMerchant::Billing::Base.integration_mode
+          case mode
+          when :production
+            self.process_production_url
+          when :test
+            self.process_test_url
+          else
+            raise StandardError, "Integration mode set to an invalid value: #{mode}"
+          end
+        end
+
+        def self.validate_service_url
+          mode = ActiveMerchant::Billing::Base.integration_mode
+          case mode
+          when :production
+            self.validate_production_url
+          when :test
+            self.validate_test_url
+          else
+            raise StandardError, "Integration mode set to an invalid value: #{mode}"
+          end
+        end
+
+        def self.helper(order, account, options = {})
+          Helper.new(order, account, options)
+        end
+
+        def self.notification(query_string, options = {})
+          Notification.new(query_string, options)
+        end
+        
+        def self.return(post, options = {})
+          Return.new(post, options)
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/pay_fast/common.rb

@@ -0,0 +1,42 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module PayFast
+        module Common
+          def generate_signature(type)
+            string = case type
+            when :request
+              request_signature_string
+            when :notify
+              notify_signature_string
+            end
+
+            Digest::MD5.hexdigest(string)
+          end
+
+          def request_attributes
+            [:merchant_id, :merchant_key, :return_url, :cancel_url,
+             :notify_url, :name_first, :name_last, :email_address,
+             :payment_id, :amount, :item_name, :item_description,
+             :custom_str1, :custom_str2, :custom_str3, :custom_str4,
+             :custom_str5, :custom_int1, :custom_int2, :custom_int3,
+             :custom_int4, :custom_int5, :email_confirmation,
+             :confirmation_address]
+          end
+
+          def request_signature_string
+            request_attributes.map do |attr|
+              "#{mappings[attr]}=#{CGI.escape(@fields[mappings[attr]])}" if @fields[mappings[attr]].present?
+            end.compact.join('&')
+          end
+
+          def notify_signature_string
+            params.map do |key, value|
+              "#{key}=#{CGI.escape(value)}" unless key == PayFast.signature_parameter_name
+            end.compact.join('&')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/pay_fast/helper.rb

@@ -0,0 +1,50 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module PayFast
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          include Common
+
+          def initialize(order, account, options = {})
+            super
+            add_field('merchant_id', account)
+            add_field('merchant_key', options.delete(:credential2))
+            add_field('m_payment_id', order)
+          end
+
+          def form_fields
+            @fields
+          end
+
+          def params
+            @fields
+          end
+
+          mapping :merchant_id, 'merchant_id'
+          mapping :merchant_key, 'merchant_key'
+          mapping :return_url, 'return_url'
+          mapping :cancel_return_url, 'cancel_url'
+          mapping :notify_url, 'notify_url'
+          mapping :name_first, 'name_first'
+          mapping :name_last, 'name_last'
+          mapping :email_address, 'email_address'
+          mapping :payment_id, 'm_payment_id'
+          mapping :amount, 'amount'
+          mapping :item_name, 'item_name'
+          mapping :description, 'item_name'
+          
+          mapping :customer, :first_name => 'name_first',
+                             :last_name  => 'name_last',
+                             :email      => 'email_address',
+                             :phone      => 'phone'
+
+          5.times { |i| mapping :"custom_str#{i}", "custom_str#{i}" }
+          5.times { |i| mapping :"custom_int#{i}", "custom_int#{i}" }
+
+          mapping :email_confirmation, 'email_confirmation'
+          mapping :confirmation_address, 'confirmation_address'
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/pay_fast/notification.rb

@@ -0,0 +1,134 @@
+require 'net/http'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module PayFast
+        # Parser and handler for incoming ITN from PayFast.
+        # The Example shows a typical handler in a rails application.
+        #
+        # Example
+        #
+        #   class BackendController < ApplicationController
+        #     include ActiveMerchant::Billing::Integrations
+        #
+        #     def pay_fast_itn
+        #       notify = PayFast::Notification.new(request.raw_post)
+        #
+        #       order = Order.find(notify.item_id)
+        #
+        #       if notify.acknowledge
+        #         begin
+        #
+        #           if notify.complete? and order.total == notify.amount
+        #             order.status = 'success'
+        #
+        #             shop.ship(order)
+        #           else
+        #             logger.error("Failed to verify Paypal's notification, please investigate")
+        #           end
+        #
+        #         rescue => e
+        #           order.status = 'failed'
+        #           raise
+        #         ensure
+        #           order.save
+        #         end
+        #       end
+        #
+        #       render :nothing
+        #     end
+        #   end
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+          include PostsData
+          include Common
+
+          # Was the transaction complete?
+          def complete?
+            status == "Completed"
+          end
+
+          # Status of transaction. List of possible values:
+          # <tt>COMPLETE</tt>::
+          def status
+            if params['payment_status'] == "COMPLETE"
+              "Completed"
+            else
+              "Failed"
+            end
+          end
+
+          # Id of this transaction (uniq PayFast transaction id)
+          def transaction_id
+            params['pf_payment_id']
+          end
+
+          # Id of this transaction (uniq Shopify transaction id)
+          def item_id
+            params['m_payment_id']
+          end
+
+          # The total amount which the payer paid.
+          def gross
+            params['amount_gross']
+          end
+
+          # The total in fees which was deducated from the amount.
+          def fee
+            params['amount_fee']
+          end
+
+          # The net amount credited to the receiver's account.
+          def amount
+            params['amount_net']
+          end
+
+          # The name of the item being charged for.
+          def item_name
+            params['item_name']
+          end
+
+          # The Merchant ID as given by the PayFast system. Used to uniquely identify the receiver's account.
+          def merchant_id
+            params['merchant_id']
+          end
+          
+          def currency
+            nil
+          end
+          # Generated hash depends on params order so use OrderedHash instead of Hash
+          def empty!
+            super
+            @params  = ActiveSupport::OrderedHash.new
+          end
+
+          # Acknowledge the transaction to PayFast. This method has to be called after a new
+          # ITN arrives. PayFast will verify that all the information we received are correct and will return a
+          # VERIFIED or INVALID status.
+          #
+          # Example:
+          #
+          #   def pay_fast_itn
+          #     notify = PayFastNotification.new(request.raw_post)
+          #
+          #     if notify.acknowledge
+          #       ... process order ... if notify.complete?
+          #     else
+          #       ... log possible hacking attempt ...
+          #     end
+          def acknowledge
+            if params[PayFast.signature_parameter_name] == generate_signature(:notify)
+              response = ssl_post(PayFast.validate_service_url, notify_signature_string,
+                'Content-Type' => "application/x-www-form-urlencoded",
+                'Content-Length' => "#{notify_signature_string.size}"
+              )
+              raise StandardError.new("Faulty PayFast result: #{response}") unless ['VALID', 'INVALID'].include?(response)
+
+              response == "VALID"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/pay_fast/return.rb

@@ -0,0 +1,10 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module PayFast
+        class Return < ActiveMerchant::Billing::Integrations::Return
+	      end
+      end
+    end
+  end
+end