tanga_activemerchant 1.37.0

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

@@ -0,0 +1,44 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+
+      # Documentation:
+      # https://www.paxum.com/payment_docs/page.php?name=apiIntroduction
+      module Paxum
+        autoload :Helper, File.dirname(__FILE__) + '/paxum/helper.rb'
+        autoload :Notification, File.dirname(__FILE__) + '/paxum/notification.rb'
+        autoload :Return, File.dirname(__FILE__) + '/paxum/return.rb'
+        autoload :Common, File.dirname(__FILE__) + '/paxum/common.rb'
+
+        mattr_accessor :test_url
+        self.test_url = 'https://paxum.com/payment/phrame.php?action=displayProcessPaymentLogin'
+
+        mattr_accessor :production_url
+        self.production_url = 'https://paxum.com/payment/phrame.php?action=displayProcessPaymentLogin'
+
+        mattr_accessor :signature_parameter_name
+        self.signature_parameter_name = 'key'
+
+        def self.service_url
+          mode = ActiveMerchant::Billing::Base.integration_mode
+          case mode
+          when :production
+            self.production_url
+          when :test
+            self.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
+      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

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/payflow_link/helper.rb

@@ -0,0 +1,116 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module PayflowLink
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          include PostsData
+
+          def initialize(order, account, options = {})
+            super
+            add_field('login', account)
+            add_field('echodata', 'True')
+            add_field('user2', self.test?)
+            add_field('invoice', order)
+            add_field('vendor', account)
+            add_field('user', options[:credential4].presence || account)
+            add_field('trxtype', options[:transaction_type] || 'S')
+          end
+
+          mapping :account, 'login'
+          mapping :credential2, 'pwd'
+          mapping :credential3, 'partner'
+          mapping :order, 'user1'
+
+          mapping :amount, 'amt'
+
+
+          mapping :billing_address,  :city    => 'city',
+                                     :address => 'address',
+                                     :state   => 'state',
+                                     :zip     => 'zip',
+                                     :country => 'country',
+                                     :phone   => 'phone',
+                                     :name    => 'name'
+
+          mapping :customer, { :first_name => 'first_name', :last_name => 'last_name' }
+
+          def description(value)
+            add_field('description', normalize("#{value}").delete("#"))
+          end
+
+          def customer(params = {})
+            add_field(mappings[:customer][:first_name], params[:first_name])
+            add_field(mappings[:customer][:last_name], params[:last_name])
+          end
+
+          def billing_address(params = {})
+            # Get the country code in the correct format
+            # Use what we were given if we can't find anything
+            country_code = lookup_country_code(params.delete(:country))
+            add_field(mappings[:billing_address][:country], country_code)
+
+            add_field(mappings[:billing_address][:address], [params.delete(:address1), params.delete(:address2)].compact.join(' '))
+
+            province_code = params.delete(:state)
+            add_field(mappings[:billing_address][:state], province_code.blank? ? 'N/A' : province_code.upcase)
+
+            # Everything else
+            params.each do |k, v|
+              field = mappings[:billing_address][k]
+              add_field(field, v) unless field.nil?
+            end
+          end
+
+          def form_fields
+            token, token_id = request_secure_token
+
+            {"securetoken" => token, "securetokenid" => token_id, "mode" => test? ? "test" : "live"}
+          end
+
+          private
+
+          def secure_token_id
+            @secure_token_id ||= Utils.generate_unique_id
+          end
+
+          def secure_token_url
+            test? ? "https://pilot-payflowpro.paypal.com" : "https://payflowpro.paypal.com"
+          end
+
+          def request_secure_token
+            @fields["securetokenid"] = secure_token_id
+            @fields["createsecuretoken"] = "Y"
+
+            fields = @fields.collect {|key, value| "#{key}[#{value.length}]=#{value}" }.join("&")
+
+            response = ssl_post(secure_token_url, fields)
+
+            parse_response(response)
+          end
+
+          def parse_response(response)
+            response = response.split("&").inject({}) do |hash, param|
+              key, value = param.split("=")
+              hash[key] = value
+              hash
+            end
+
+            [response['SECURETOKEN'], response['SECURETOKENID']] if response['RESPMSG'] && response['RESPMSG'].downcase == "approved"
+          end
+
+          def normalize(text)
+            return unless text
+
+            if ActiveSupport::Inflector.method(:transliterate).arity == -2
+              ActiveSupport::Inflector.transliterate(text,'')
+            elsif RUBY_VERSION >= '1.9'
+              text.gsub(/[^\x00-\x7F]+/, '')
+            else
+              ActiveSupport::Inflector.transliterate(text).to_s
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,78 @@
+require 'net/http'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module PayflowLink
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+          
+          # Was the transaction complete?
+          def complete?
+            status == "Completed"
+          end
+
+          # When was this payment received by the client. 
+          # sometimes it can happen that we get the notification much later. 
+          # One possible scenario is that our web application was down. In this case paypal tries several 
+          # times an hour to inform us about the notification
+          def received_at
+            DateTime.parse(params['TRANSTIME']) if params['TRANSTIME']
+          rescue ArgumentError
+            nil
+          end
+
+          def status
+            params['RESPMSG']
+          end
+
+          # Id of this transaction (paypal number)
+          def transaction_id
+            params['PNREF']
+          end
+
+          # What type of transaction are we dealing with? 
+          def type
+            params['TYPE']
+          end
+
+          # the money amount we received in X.2 decimal.
+          def gross
+            params['AMT']
+          end
+
+          # What currency have we been dealing with
+          def currency
+            nil
+          end
+
+          def status
+            params['RESULT'] == '0' ? 'Completed' : 'Failed'
+          end
+
+          # This is the item number which we submitted to paypal 
+          def item_id
+            params['USER1']
+          end
+
+          # This is the invoice which you passed to paypal 
+          def invoice
+            params['INVNUM']
+          end   
+
+          # Was this a test transaction?
+          def test?
+            params['USER2'] == 'true'
+          end
+          
+          def account
+            params["ACCT"]
+          end
+
+          def acknowledge
+            true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module PayflowLink
+        autoload :Helper, 'active_merchant/billing/integrations/payflow_link/helper.rb'
+        autoload :Notification, 'active_merchant/billing/integrations/payflow_link/notification.rb'
+
+        mattr_accessor :service_url
+        self.service_url = 'https://payflowlink.paypal.com'
+
+        def self.notification(post, options = {})
+          Notification.new(post)
+        end
+
+        def self.return(query_string, options = {})
+          ActiveMerchant::Billing::Integrations::Return.new(query_string)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,119 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Paypal
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+         CANADIAN_PROVINCES = {  'AB' => 'Alberta',
+                                 'BC' => 'British Columbia',
+                                 'MB' => 'Manitoba',
+                                 'NB' => 'New Brunswick',
+                                 'NL' => 'Newfoundland',
+                                 'NS' => 'Nova Scotia',
+                                 'NU' => 'Nunavut',
+                                 'NT' => 'Northwest Territories',
+                                 'ON' => 'Ontario',
+                                 'PE' => 'Prince Edward Island',
+                                 'QC' => 'Quebec',
+                                 'SK' => 'Saskatchewan',
+                                 'YT' => 'Yukon'
+                               } 
+          # See https://www.paypal.com/IntegrationCenter/ic_std-variable-reference.html for details on the following options.
+          mapping :order, [ 'item_number', 'custom' ]
+
+          def initialize(order, account, options = {})
+            super
+            add_field('cmd', '_ext-enter')
+            add_field('redirect_cmd', '_xclick')
+            add_field('quantity', 1)
+            add_field('item_name', 'Store purchase')
+            add_field('no_shipping', '1')
+            add_field('no_note', '1')
+            add_field('charset', 'utf-8')
+            add_field('address_override', '0')
+            add_field('bn', application_id.to_s.slice(0,32)) unless application_id.blank?
+          end
+
+          mapping :amount, 'amount'
+          mapping :account, 'business'
+          mapping :currency, 'currency_code'
+          mapping :notify_url, 'notify_url'
+          mapping :return_url, 'return'
+          mapping :cancel_return_url, 'cancel_return'
+          mapping :invoice, 'invoice'
+          mapping :item_name, 'item_name'
+          mapping :quantity, 'quantity'
+          mapping :no_shipping, 'no_shipping'
+          mapping :no_note, 'no_note'
+          mapping :address_override, 'address_override'
+
+          mapping :application_id, 'bn'
+
+          mapping :customer, :first_name => 'first_name',
+                             :last_name  => 'last_name',
+                             :email      => 'email'
+
+          mapping :shipping_address,  :city    => 'city',
+                                      :address1 => 'address1',
+                                      :address2 => 'address2',
+                                      :state   => 'state',
+                                      :zip     => 'zip',
+                                      :country => 'country'
+          
+          def shipping_address(params = {})
+
+            # Get the country code in the correct format
+            # Use what we were given if we can't find anything
+            country_code = lookup_country_code(params.delete(:country))
+            add_field(mappings[:shipping_address][:country], country_code)
+            
+            if params.has_key?(:phone)
+              phone = params.delete(:phone).to_s
+          
+              # Whipe all non digits
+              phone.gsub!(/\D+/, '')
+              
+              if ['US', 'CA'].include?(country_code) && phone =~ /(\d{3})(\d{3})(\d{4})$/
+                add_field('night_phone_a', $1) 
+                add_field('night_phone_b', $2) 
+                add_field('night_phone_c', $3) 
+              else
+                add_field('night_phone_b', phone)                
+              end
+            end
+              
+            province_code = params.delete(:state)
+                       
+            case country_code
+            when 'CA'
+              add_field(mappings[:shipping_address][:state], CANADIAN_PROVINCES[province_code.upcase]) unless province_code.nil?
+            when 'US'
+              add_field(mappings[:shipping_address][:state], province_code)
+            else
+              add_field(mappings[:shipping_address][:state], province_code.blank? ? 'N/A' : province_code)
+            end
+              
+            # Everything else 
+            params.each do |k, v|
+              field = mappings[:shipping_address][k]
+              add_field(field, v) unless field.nil?
+            end
+          end
+          
+          mapping :tax, 'tax'
+          mapping :shipping, 'shipping'
+          mapping :cmd, 'cmd'
+          mapping :custom, 'custom'
+          mapping :src, 'src'
+          mapping :sra, 'sra'
+          %w(a p t).each do |l|
+            (1..3).each do |i|
+              mapping "#{l}#{i}".to_sym, "#{l}#{i}"
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+