tlconnor-activemerchant 1.20.4

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

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

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

@@ -0,0 +1,113 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      class Helper #:nodoc:
+        attr_reader :fields
+        class_attribute :service_url
+        class_attribute :mappings
+        class_attribute :country_format
+        self.country_format = :alpha2
+        
+        # The application making the calls to the gateway
+        # Useful for things like the PayPal build notation (BN) id fields
+        class_attribute :application_id
+        self.application_id = 'ActiveMerchant'
+
+        def initialize(order, account, options = {})
+          options.assert_valid_keys([:amount, :currency, :test, :credential2, :credential3, :credential4, :country, :account_name, :transaction_type])
+          @fields          = {}
+          @raw_html_fields = []
+          @test            = options[:test]
+          self.order       = order
+          self.account     = account
+          self.amount      = options[:amount]
+          self.currency    = options[:currency]
+          self.credential2 = options[:credential2]
+          self.credential3 = options[:credential3]
+          self.credential4 = options[:credential4]
+        end
+
+        def self.mapping(attribute, options = {})
+          self.mappings ||= {}
+          self.mappings[attribute] = options
+        end
+
+        def add_field(name, value)
+          return if name.blank? || value.blank?
+          @fields[name.to_s] = value.to_s
+        end
+
+        def add_fields(subkey, params = {})
+          params.each do |k, v|
+            field = mappings[subkey][k]
+            add_field(field, v) unless field.blank?
+          end
+        end
+
+        # Add a field that has characters that CGI::escape would mangle. Allows
+        # for multiple fields with the same name (e.g., to support line items).
+        def add_raw_html_field(name, value)
+          return if name.blank? || value.blank?
+          @raw_html_fields << [name, value]
+        end
+        
+        def raw_html_fields
+          @raw_html_fields
+        end
+
+        def billing_address(params = {})
+          add_address(:billing_address, params)
+        end
+        
+        def shipping_address(params = {})
+          add_address(:shipping_address, params)
+        end
+        
+        def form_fields
+          @fields
+        end
+
+        def test?
+          @test_mode ||= ActiveMerchant::Billing::Base.integration_mode == :test || @test
+        end
+
+        private
+        
+        def add_address(key, params)
+          return if mappings[key].nil?
+          
+          code = lookup_country_code(params.delete(:country))
+          add_field(mappings[key][:country], code) 
+          add_fields(key, params)
+        end
+        
+        def lookup_country_code(name_or_code, format = country_format)
+          country = Country.find(name_or_code)
+          country.code(format).to_s
+        rescue InvalidCountryCodeError
+          name_or_code
+        end
+
+        def method_missing(method_id, *args)
+          method_id = method_id.to_s.gsub(/=$/, '').to_sym
+          # Return and do nothing if the mapping was not found. This allows 
+          # For easy substitution of the different integrations
+          return if mappings[method_id].nil?
+
+          mapping = mappings[method_id]
+
+          case mapping
+          when Array
+            mapping.each{ |field| add_field(field, args.last) }
+          when Hash
+            options = args.last.is_a?(Hash) ? args.pop : {}
+
+            mapping.each{ |key, field| add_field(field, options[key]) }
+          else
+            add_field(mapping, args.last)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module HiTrust 
+        autoload :Helper, File.dirname(__FILE__) + '/hi_trust/helper.rb'
+        autoload :Return, File.dirname(__FILE__) + '/hi_trust/return.rb'
+        autoload :Notification, File.dirname(__FILE__) + '/hi_trust/notification.rb'
+
+        TEST_URL = 'https://testtrustlink.hitrust.com.tw/TrustLink/TrxReq'
+        LIVE_URL = 'https://trustlink.hitrust.com.tw/TrustLink/TrxReq'
+        
+        def self.service_url
+          ActiveMerchant::Billing::Base.integration_mode == :test ? TEST_URL : LIVE_URL
+        end
+
+        def self.notification(post, options = {})
+          Notification.new(post)
+        end
+        
+        def self.return(query_string, options = {})
+          Return.new(query_string)
+        end  
+      end
+    end
+  end
+end

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

@@ -0,0 +1,58 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module HiTrust
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          
+          # Transaction types
+          # * Auth
+          # * AuthRe
+          # * Capture
+          # * CaptureRe
+          # * Refund
+          # * RefundRe
+          # * Query
+          def initialize(order, account, options = {})
+            super  
+            # Perform an authorization by default
+            add_field('Type', 'Auth')
+            
+            # Capture the payment right away
+            add_field('depositflag', '1')
+            
+            # Disable auto query - who knows what it does?
+            add_field('queryflag', '1')
+            
+            add_field('orderdesc', 'Store purchase')
+          end
+          
+          mapping :account, 'storeid'
+          mapping :amount, 'amount'
+          
+          def amount=(money)
+            cents = money.respond_to?(:cents) ? money.cents : money 
+
+            if money.is_a?(String) or cents.to_i < 0
+              raise ArgumentError, 'money amount must be either a Money object or a positive integer in cents.' 
+            end
+            
+            add_field(mappings[:amount], cents)
+          end
+          # Supported currencies include:
+          # * CNY：Chinese Yuan (Renminbi)
+          # * TWD：New Taiwan Dollar 
+          # * HKD：Hong Kong Dollar 
+          # * USD：US Dollar 
+          # * AUD：Austrian Dollar 
+          mapping :currency, 'currency'
+        
+          mapping :order, 'ordernumber'
+          mapping :description, 'orderdesc'
+
+          mapping :notify_url, 'merUpdateURL'
+          mapping :return_url, 'returnURL'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,59 @@
+require 'net/http'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module HiTrust
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+          SUCCESS = '00'
+          
+          self.production_ips = [ '203.75.242.8' ]
+          
+          def complete?
+            status == 'Completed'
+          end 
+
+          def transaction_id
+            params['authRRN']
+          end
+          
+          def item_id
+            params['ordernumber']
+          end
+          
+          def received_at
+            Time.parse(params['orderdate']) rescue nil
+          end
+          
+          def currency
+            params['currency']
+          end
+
+          def gross
+            sprintf("%.2f", gross_cents.to_f / 100)
+          end
+          
+          def gross_cents
+            params['approveamount'].to_i
+          end
+          
+          def account
+            params['storeid']
+          end
+
+          def status
+            params['retcode'] == SUCCESS ? 'Completed' : 'Failed'
+          end
+          
+          def test?
+            ActiveMerchant::Billing::Base.integration_mode == :test
+          end
+    
+          def acknowledge      
+            true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module HiTrust
+        class Return < ActiveMerchant::Billing::Integrations::Return
+          SUCCESS = "00"
+          CODES = { "00"   => "Operation completed successfully",
+                    "-1"  => "Unable to initialize winsock dll.",
+                    "-2"  => "Can't create stream socket.",
+                    "-3"  => "No Request Message.", 
+                    "-4"  => "Can't connect to server.",
+                    "-5"  => "Send socket error.",
+                    "-6"  => "Couldn't receive data.", 
+                    "-7"  => "Receive Broken message.",
+                    "-8"  => "Unable to initialize Envirnment.",
+                    "-9"  => "Can't Read Server RSA File.",
+                    "-10" => "Can't Read Client RSA File.",
+                    "-11" => "Web Server error.",
+                    "-12" => "Receive Message type error.",
+                    "-13" => "No Request Message.",
+                    "-14" => "No Response Content.",
+                    "-18" => "Merchant Update URL not found.",
+                    "-19" => "Server URL not find Domain or IP.",
+                    "-20" => "Server URL only can fill http or https.",
+                    "-21" => "Server Config File open error.",
+                    "-22" => "Server RSA Key File open error.",
+                    "-23" => "Server RSA Key File read error.",
+                    "-24" => "Server Config File have some errors, Please to check it.",
+                    "-25" => "Merchant Config File open error.",
+                    "-26" => "Merchant RSA Key File open error.",
+                    "-27" => "Merchant RSA Key File read error.",
+                    "-28" => "Merchant Config File has some errors, Please to check it.",
+                    "-29" => "Server Type is unknown.",
+                    "-30" => "Comm Type is unknown.",
+                    "-31" => "Input Parameter [ORDERNO] is null or empty.",
+                    "-32" => "Input Parameter [STOREID] is null or empty.",
+                    "-33" => "Input Parameter [ORDERDESC] is null or empty.",
+                    "-34" => "Input Parameter [CURRENCY] is null or empty.",
+                    "-35" => "Input Parameter [AMOUNT] is null or empty.",
+                    "-36" => "Input Parameter [ORDERURL] is null or empty.",
+                    "-37" => "Input Parameter [RETURNURL] is null or empty.",
+                    "-38" => "Input Parameter [DEPOSIT] is null or empty.",
+                    "-39" => "Input Parameter [QUERYFLAG] is null or empty.",
+                    "-40" => "Input Parameter [UPDATEURL] is null or empty.",
+                    "-41" => "Input Parameter [MERUPDATEURL] is null or empty.",
+                    "-42" => "Input Parameter [KEY] is null or empty.",
+                    "-43" => "Input Parameter [MAC] is null or empty.",
+                    "-44" => "Input Parameter [CIPHER] is null or empty.",
+                    "-45" => "Input Parameter [TrxType] is wrong.",
+                    "-100" => "TrustLink Server is closed. Or Merchant Server IP is not consistent with TrustLink Server setting.",
+                    "-101" => "TrustLink Server receives NULL.",
+                    "-308" => "Order Number already exists.",
+                    "positive" => "Response from Bank. Please contact with Acquirer Bank Service or HiTRUST Call Center."
+                  }
+          
+          def success?
+            params['retcode'] == SUCCESS
+          end
+          
+          def message
+            CODES[ params['retcode'] ]
+          end
+	      end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Moneybookers
+
+        autoload :Notification, File.dirname(__FILE__) + '/moneybookers/notification.rb'
+        autoload :Helper, File.dirname(__FILE__) + '/moneybookers/helper.rb'
+
+        mattr_accessor :production_url
+        self.production_url = 'https://www.moneybookers.com/app/payment.pl'
+        
+        def self.service_url
+          self.production_url
+        end
+
+        def self.notification(post, options)
+          Notification.new(post, options)
+        end
+
+        def self.return(post, options = {})
+          Return.new(post, options)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,59 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Moneybookers
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          mapping :account, 'pay_to_email'
+          mapping :order, 'transaction_id'
+          mapping :amount, 'amount'
+          mapping :currency, 'currency'
+          
+          mapping :customer,
+            :first_name => 'firstname',
+            :last_name  => 'lastname',
+            :email      => 'pay_from_email',
+            :phone      => 'phone_number'
+
+          mapping :billing_address,
+            :city     => 'city',
+            :address1 => 'address',
+            :address2 => 'address2',
+            :state    => 'state',
+            :zip      => 'postal_code',
+            :country  => 'country'
+
+          mapping :notify_url, 'status_url'
+          mapping :return_url, 'return_url'
+          mapping :cancel_return_url, 'cancel_url'
+          mapping :description, 'detail1_text'
+          
+          def initialize(order, account, options = {})
+            super
+            add_tracking_token
+            add_default_parameters
+            add_seller_details(options)
+          end
+
+
+          private
+          
+          def add_tracking_token
+            return if application_id.blank? || application_id == 'ActiveMerchant'
+
+            add_field('merchant_fields', 'platform')
+            add_field('platform', application_id)
+          end
+          
+          def add_default_parameters
+            add_field('hide_login', 1)
+          end
+          
+          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]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,129 @@
+require 'net/http'
+require 'digest/md5'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Moneybookers
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+
+          def initialize(data, options)
+            if options[:credential2].nil?
+              raise ArgumentError, "You need to provide the md5 secret as the option :credential2 to verify that the notification originated from Moneybookers"
+            end
+            super
+          end
+          
+          def complete?
+            status == 'Completed'
+          end
+
+          # ‘2’ Processed – This status is sent when the transaction is processed and the funds have been received on your Moneybookers account.
+          # ‘0’ Pending – This status is sent when the customers pays via the pending bank transfer option. Such transactions will auto-process IF the bank transfer is received by Moneybookers. We strongly recommend that you do NOT process the order/transaction in your system upon receipt of a pending status from Moneybookers.
+          # ‘-1’ Cancelled – Pending transactions can either be cancelled manually by the sender in their online account history or they will auto-cancel after 14 days if still pending.
+          # ‘-2’ Failed – This status is sent when the customer tries to pay via Credit Card or Direct Debit but our provider declines the transaction. If you do not accept Credit Card or Direct Debit payments via Moneybookers (see page 17) then you will never receive the failed status.
+          # ‘-3’ Chargeback – This status could be received only if your account is configured to receive chargebacks. If this is the case, whenever a chargeback is received by Moneybookers, a -3 status will be posted on the status_url for the reversed transaction.
+          def status
+            case status_code
+            when '2'
+              'Completed'
+            when '0'
+              'Pending'
+            when '-1'
+              'Cancelled'
+            when '-2'
+              'Failed'
+            when '-3'
+              'Reversed'
+            else
+              'Error'
+            end
+          end
+          
+          def status_code
+            params['status']
+          end
+          
+          def item_id
+            params['transaction_id']
+          end
+
+          def transaction_id
+            params['mb_transaction_id']
+          end
+
+          # When was this payment received by the client. 
+          def received_at
+            nil
+          end
+
+          def payer_email
+            params['pay_from_email']
+          end
+         
+          def receiver_email
+            params['pay_to_email']
+          end 
+
+          def md5sig
+            params['md5sig']
+          end
+
+          #Unique ID from the merchant's Moneybookers.com account, needed for calculatinon of md5 sig
+          def merchant_id
+            params['merchant_id']
+          end
+
+          # currency of the payment as posted by the merchant on the entry form
+          def currency
+            params['currency']
+          end
+
+          # amount of the payment as posted by the merchant on the entry form (ex. 39.60/39.6/39)
+          def gross
+            params['amount']
+          end
+
+          # currency of mb_amount, will always be the same as the currency of the beneficiary's account at Moneybookers.com
+          def merchant_currency
+            params['mb_currency']
+          end
+
+          # total amount of the payment in Merchants currency (ex 25.46/25.4/25)
+          def merchant_amount
+            params['mb_amount']
+          end
+
+          # Was this a test transaction?
+          def test?
+            false
+          end
+          
+          def secret
+            @options[:credential2]
+          end
+          
+          # Acknowledge the transaction to MoneyBooker. This method has to be called after a new 
+          # apc arrives. It will verify that all the information we received is correct and will return a
+          # ok or a fail. The secret (second credential) has to be provided in the parameter :credential2
+          # when instantiating the Notification object.
+          # 
+          # Example:
+          # 
+          #   def ipn
+          #     notify = Moneybookers.notification(request.raw_post, :credential2 => 'secret')
+          #
+          #     if notify.acknowledge
+          #       ... process order ... if notify.complete?
+          #     else
+          #       ... log possible hacking attempt ...
+          #     end
+          def acknowledge
+            fields = [merchant_id, item_id, Digest::MD5.hexdigest(secret).upcase, merchant_amount, merchant_currency, status_code].join
+            md5sig == Digest::MD5.hexdigest(fields).upcase
+          end
+        end
+      end
+    end
+  end
+end