bitfluent-activemerchant 1.5.1.1

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/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)
+          Notification.new(post)
+        end
+        
+        def self.return(query_string)
+          Return.new(query_string)
+        end  
+      end
+    end
+  end
+end

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

@@ -0,0 +1,120 @@
+require "digest/sha1"
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Ipay88
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          include RequiresParameters
+
+          # Currencies supported
+          #   MYR (Malaysian Ringgit - for all payment methods except China Union Pay and PayPal)
+          #   USD (US Dollar - only for PayPal)
+          #   CNY (Yuan Renminbi - only for China Union Pay)
+          SUPPORTED_CURRENCIES = %w[MYR USD CNY]
+
+          # Languages supported
+          #   ISO-8859-1 (English)
+          #   UTF-8      (Unicode)
+          #   GB2312     (Chinese Simplified)
+          #   GD18030    (Chinese Simplified)
+          #   BIG5       (Chinese Traditional)
+          SUPPORTED_LANGS      = %w[ISO-8859-1 UTF-8 GB2312 GD18030 BIG5]
+
+          # Payment methods supported
+          #   8  (Alliance Online Transfer)
+          #   10 (AmBank)
+          #   21 (China Union Pay)
+          #   20 (CIMB Click)
+          #   2  (Credit Card MYR)
+          #   16 (FPX)
+          #   15 (Hong Leong Bank Transfer)
+          #   6  (Maybank2u.com)
+          #   23 (MEPS Cash)
+          #   17 (Mobile Money)
+          #   33 (PayPal)
+          #   14 (RHB)
+          PAYMENT_METHODS      = %w[8 10 21 20 2 16 15 6 23 17 33 14]
+
+          attr_reader :amount_in_cents
+
+          def initialize(order, account, options = {})
+            requires!(options, :amount, :currency)
+            @amount_in_cents = options[:amount]
+            super
+            add_field mappings[:signature], signature
+          end
+
+          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], sprintf("%.2f", cents.to_f/100)
+          end
+
+          def currency(symbol)
+            raise ArgumentError, "unsupported currency" unless SUPPORTED_CURRENCIES.include?(symbol)
+            add_field mappings[:currency], symbol
+          end
+
+          def language(lang)
+            raise ArgumentError, "unsupported language" unless SUPPORTED_LANGS.include?(lang)
+            add_field mappings[:language], lang
+          end
+
+          def payment(pay_method)
+            raise ArgumentError, "unsupported payment method" unless PAYMENT_METHODS.include?(pay_method.to_s)
+            add_field mappings[:payment], pay_method
+          end
+
+          # Generate a Base64-encoded SHA1 given a string
+          def self.sign(str)
+            [Digest::SHA1.digest(str)].pack("m").chomp
+          end
+
+          def signature
+            self.class.sign(self.sig_components)
+          end
+
+          # MerchantCode (required)
+          mapping :account,     "MerchantCode"
+          # Amount (required)
+          mapping :amount,      "Amount"
+          # Currency (required)
+          mapping :currency,    "Currency"
+          # RefNo (required)
+          mapping :order,       "RefNo"
+          # ProdDesc (required)
+          mapping :description, "ProdDesc"
+          # UserName (required)
+          # UserEmail (required)
+          # UserContact (required)
+          mapping :customer, :name  => "UserName",
+                             :email => "UserEmail",
+                             :phone => "UserContact"
+          # Remark
+          mapping :remark,      "Remark"
+          # Lang
+          mapping :language,    "Lang"
+          # PaymentId
+          mapping :payment,     "PaymentId"
+          # ResponseURL
+          mapping :return_url,  "ResponseURL"
+          # Signature
+          mapping :signature,   "Signature"
+
+          protected
+          def sig_components #:nodoc:
+            components  = [Ipay88.merchant_key]
+            components << fields[mappings[:account]]
+            components << fields[mappings[:order]]
+            components << amount_in_cents
+            components << fields[mappings[:currency]]
+            components.join
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,121 @@
+require "digest/sha1"
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Ipay88
+        class Return < ActiveMerchant::Billing::Integrations::Return
+          include ActiveMerchant::PostsData
+
+          # Merchant Code assigned by iPay88
+          def account
+            params["MerchantCode"]
+          end
+
+          # The payment method
+          def payment
+            params["PaymentId"].to_i
+          end
+
+          # Unique merchant transaction number
+          def order
+            params["RefNo"]
+          end
+
+          # The payment with two decimals
+          def amount
+            params["Amount"]
+          end
+
+          # The currency. List of possible values:
+          # <tt>MYR</tt>::
+          # <tt>USD</tt>::
+          # <tt>CNY</tt>::
+          def currency
+            params["Currency"]
+          end
+
+          # Merchant remark
+          def remark
+            params["Remark"]
+          end
+
+          # Transaction ID from iPay88
+          def transaction
+            params["TransId"]
+          end
+
+          # Bank's approval code
+          def auth_code
+            params["AuthCode"]
+          end
+
+          # Payment status. List of possible values:
+          # <tt>1</tt>:: Success
+          # <tt>0</tt>:: Fail
+          def status
+            params["Status"]
+          end
+
+          # The error description. List of possible values:
+          # <tt>Duplicate reference number</tt>::
+          # <tt>Invalid merchant</tt>::
+          # <tt>Invalid parameters</tt>::
+          # <tt>Overlimit per transaction</tt>::
+          # <tt>Payment not allowed</tt>::
+          # <tt>Permission not allow</tt>::
+          # <tt>Signature not match</tt>::
+          # <tt>Status not approved</tt>::
+          def error
+            params["ErrDesc"]
+          end
+
+          # The hash signature
+          def signature
+            params["Signature"]
+          end
+
+          # Convenience method to check if the request is secure by
+          # checking the incoming signature against our own generated
+          # signature
+          def secure?
+            self.generated_signature == self.signature
+          end
+
+          # Was the transaction successful?
+          def success?
+            self.secure? && self.requery == "00" && self.status == "1"
+          end
+
+          protected
+          def generated_signature #:nodoc:
+            Helper.sign(self.sig_components)
+          end
+
+          def sig_components #:nodoc:
+            components = [Ipay88.merchant_key]
+            [:account, :payment, :order, :amount_in_cents, :currency, :status].each do |i|
+              components << self.send(i)
+            end
+            components.join
+          end
+
+          def requery #:nodoc:
+            data   = { "MerchantCode" => self.account, "RefNo" => self.order, "Amount" => self.amount }
+            params = parameterize(data)
+            ssl_post Ipay88.service_url, params, { "Content-Length" => params.size.to_s, "User-Agent" => "Active Merchant -- http://activemerchant.org" }
+          end
+
+          private
+          def parameterize(params) #:nodoc:
+            params.reject { |k, v| v.blank? }.keys.sort.collect { |key| "#{key}=#{CGI.escape(params[key].to_s)}" }.join("&")
+          end
+
+          def amount_in_cents #:nodoc:
+            @amount_in_cents ||= (self.amount || "").gsub(/[.,]/, "")
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Ipay88
+        autoload :Return,       "active_merchant/billing/integrations/ipay88/return.rb"
+        autoload :Helper,       "active_merchant/billing/integrations/ipay88/helper.rb"
+        autoload :Notification, "active_merchant/billing/integrations/ipay88/notification.rb"
+
+        mattr_accessor :merch_key
+
+        # The merchant key provided to you by iPay88.
+        def self.merchant_key
+          self.merch_key
+        end
+
+        # Set the merchant key (in a Rails initializer, for example)
+        #
+        #   ActiveMerchant::Billing::Integrations::Ipay88.merchant_key = "foo"
+        #
+        def self.merchant_key=(key)
+          self.merch_key = key
+        end
+
+        # The URL to POST your payment form to
+        def self.service_url
+          "https://www.mobile88.com/epayment/entry.asp"
+        end
+
+        # The requery URL upon returning from iPay88
+        def self.entry_url
+          "https://www.mobile88.com/epayment/enquiry.asp"
+        end
+
+        def self.return(query_string)
+          Return.new(query_string)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,68 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Nochex
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          # Required Parameters
+          # email
+          # amount
+          mapping :account, 'email'
+          mapping :amount, 'amount'
+        
+          # Set the field status = test for testing with accounts:
+          # Account             Password
+          # test1@nochex.com    123456
+          # test2@nochex.com    123456
+          # def initialize(order, account, options = {})
+          #  super
+          #  add_field('status', 'test')
+          # end 
+
+          # Need to format the amount to have 2 decimal places
+          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], sprintf("%.2f", cents.to_f/100)
+          end
+          
+          # Optional Parameters
+          # ordernumber
+          mapping :order, 'ordernumber'
+
+          # firstname
+          # lastname
+          # email_address_sender
+          mapping :customer, :first_name => 'firstname',
+                             :last_name  => 'lastname',
+                             :email      => 'email_address_sender'
+
+          # town
+          # firstline
+          # county
+          # postcode
+          mapping :billing_address, :city     => 'town',
+                                    :address1 => 'firstline',
+                                    :state    => 'county',
+                                    :zip      => 'postcode'
+
+          # responderurl 
+          mapping :notify_url, 'responderurl'
+
+          # returnurl
+          mapping :return_url, 'returnurl'
+          
+          # cancelurl
+          mapping :cancel_return_url, 'cancelurl'
+          
+          # description
+          mapping :description, 'description'
+
+          # Currently unmapped
+          # logo
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,94 @@
+require 'net/http'
+require 'date'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Nochex
+        # Parser and handler for incoming Automatic Payment Confirmations from Nochex.
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+          include ActiveMerchant::PostsData
+
+          def complete?
+            status == 'Completed'
+          end 
+
+          # Id of the order we passed to Nochex
+          def item_id
+            params['order_id']
+          end
+
+          def transaction_id
+            params['transaction_id']
+          end
+
+          def currency
+            'GBP'
+          end
+  
+          # When was this payment received by the client. 
+          def received_at
+            # U.K. Format: 27/09/2006 22:30:54
+            return if params['transaction_date'].blank?
+            time = params['transaction_date'].scan(/\d+/)
+            Time.utc(time[2], time[1], time[0], time[3], time[4], time[5])
+          end
+
+          def payer_email
+            params['from_email']
+          end
+         
+          def receiver_email
+            params['to_email']
+          end 
+
+          def security_key
+            params['security_key']
+          end
+
+          # the money amount we received in X.2 decimal.
+          def gross
+            sprintf("%.2f", params['amount'].to_f)
+          end
+
+          # Was this a test transaction?
+          def test?
+            params['status'] == 'test'
+          end
+
+          def status
+            'Completed'
+          end
+
+          # Acknowledge the transaction to Nochex. This method has to be called after a new 
+          # apc arrives. Nochex will verify that all the information we received are correct and will return a 
+          # ok or a fail. This is very similar to the PayPal IPN scheme.
+          # 
+          # Example:
+          # 
+          #   def nochex_ipn
+          #     notify = NochexNotification.new(request.raw_post)
+          #
+          #     if notify.acknowledge 
+          #       ... process order ... if notify.complete?
+          #     else
+          #       ... log possible hacking attempt ...
+          #     end
+          def acknowledge
+             payload =  raw
+
+             response = ssl_post(Nochex.notification_confirmation_url, payload, 
+               'Content-Length' => "#{payload.size}",
+               'User-Agent'     => "Active Merchant -- http://activemerchant.org",
+               'Content-Type'   => "application/x-www-form-urlencoded"
+             )
+
+             raise StandardError.new("Faulty Nochex result: #{response}") unless ["AUTHORISED", "DECLINED"].include?(response)
+
+             response == "AUTHORISED"
+          end
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,88 @@
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      # To start with Nochex, follow the instructions for installing 
+      # ActiveMerchant as a plugin, as described on 
+      # http://www.activemerchant.org/.
+      # 
+      # The plugin will automatically add the ActionView helper for 
+      # ActiveMerchant, which will allow you to make the Nochex payments.  
+      # The idea behind the helper is that it generates an invisible 
+      # forwarding screen that will automatically redirect the user.  
+      # So you would collect all the information about the order and then 
+      # simply render the hidden form, which redirects the user to Nochex.
+      # 
+      # The syntax of the helper is as follows:
+      # 
+      #   <% payment_service_for 'order id', 'nochex_user_id',
+      #                                 :amount => 50.00,
+      #                                 :service => :nochex,
+      #                                 :html => { :id => 'nochex-form' } do |service| %>
+      #   
+      #      <% service.customer :first_name => 'Cody',
+      #                         :last_name => 'Fauser',
+      #                         :phone => '(555)555-5555',
+      #                         :email => 'cody@example.com' %>
+      #   
+      #      <% service.billing_address :city => 'Ottawa',
+      #                                :address1 => '21 Snowy Brook Lane',
+      #                                :address2 => 'Apt. 36',
+      #                                :state => 'ON',
+      #                                :country => 'CA',
+      #                                :zip => 'K1J1E5' %>
+      #   
+      #      <% service.invoice '#1000' %>
+      #      <% service.shipping '0.00' %>
+      #      <% service.tax '0.00' %>
+      #   
+      #      <% service.notify_url url_for(:action => 'notify', :only_path => false) %>
+      #      <% service.return_url url_for(:action => 'done', :only_path => false) %>
+      #      <% service.cancel_return_url 'http://mystore.com' %>
+      #    <% end %>
+      #   
+      # The notify_url is the URL that the Nochex IPN will be sent.  You can 
+      # handle the notification in your controller action as follows:
+      #   
+      #   class NotificationController < ApplicationController
+      #     include ActiveMerchant::Billing::Integrations
+      #   
+      #     def notify
+      #       notification =  Nochex::Notification.new(request.raw_post)
+      #       
+      #       begin
+      #         # Acknowledge notification with Nochex
+      #         raise StandardError, 'Illegal Notification' unless notification.acknowledge
+      #           # Process the payment  
+      #       rescue => e
+      #           logger.warn("Illegal notification received: #{e.message}")
+      #       ensure
+      #           head(:ok)
+      #       end
+      #     end
+      #   end
+      module Nochex
+        autoload :Return, File.dirname(__FILE__) + '/nochex/return.rb'
+        autoload :Helper, File.dirname(__FILE__) + '/nochex/helper.rb'
+        autoload :Notification, File.dirname(__FILE__) + '/nochex/notification.rb'
+        
+       
+        mattr_accessor :service_url
+        self.service_url = 'https://www.nochex.com/nochex.dll/checkout'
+
+        mattr_accessor :notification_confirmation_url
+        self.notification_confirmation_url = 'https://www.nochex.com/nochex.dll/apc/apc'
+
+        # Simply a convenience method that returns a new 
+        # ActiveMerchant::Billing::Integrations::Nochex::Notification
+        def self.notification(post)
+          Notification.new(post)
+        end  
+        
+        def self.return(query_string)
+          Return.new(query_string)
+        end
+      end
+    end
+  end
+end