activemerchant 1.11.0 → 1.12.0

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

@@ -0,0 +1,23 @@
+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)
+          Notification.new(post)
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+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'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,101 @@
+require 'net/http'
+require 'digest/md5'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Moneybookers
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+          include PostsData
+
+          # was the transaction comlete?
+          def complete?
+            status == "2"
+          end
+
+          def status
+            params['status']
+          end
+
+          def item_id
+            nil
+          end
+
+          def transaction_id
+            if params.has_key?("transaction_id")
+              params['transaction_id']
+            else
+              params['mb_transaction_id']
+            end
+          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 mb_amount, will always be the same as the currency of the beneficiary's account at Moneybookers.com
+          def currency
+            params['mb_currency']
+          end
+
+          # total amount of the payment in Merchants currency (ex 25.46/25.4/25)
+          def gross
+            params['mb_amount']
+          end
+
+          # currency of the payment as posted by the merchant on the entry form
+          def posted_currency
+            params['currency']
+          end
+
+          # amount of the payment as posted by the merchant on the entry form (ex. 39.60/39.6/39)
+          def posted_amount
+            params['amount']
+          end
+
+          # Was this a test transaction?
+          def test?
+            false
+          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.
+          # 
+          # Example:
+          # 
+          #   def ipn
+          #     notify = Moneybookers::Notification.new(request.raw_post)
+          #
+          #     if notify.acknowledge('secretpass')
+          #       ... process order ... if notify.complete?
+          #     else
+          #       ... log possible hacking attempt ...
+          #     end
+          def acknowledge(secret = '')
+            fields = [merchant_id, transaction_id, Digest::MD5.hexdigest(secret).upcase, gross, currency, status].join
+            md5sig == Digest::MD5.hexdigest(fields).upcase
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -50,7 +50,7 @@ module ActiveMerchant #:nodoc:
             requires!(options, :amount, :description)
             options.assert_valid_keys([:description, :quantity, :amount, :discount])
 
-            add_field("Vara_#{id}_Verd", options[:amount])
+            add_field("Vara_#{id}_Verd", format_amount(options[:amount]))
             add_field("Vara_#{id}_Fjoldi", options[:quantity] || "1")
             
             add_field("Vara_#{id}_Lysing", options[:description]) if options[:description]
@@ -75,6 +75,10 @@ module ActiveMerchant #:nodoc:
             @fields[mappings[:success_text]] ||= DEFAULT_SUCCESS_TEXT
             @fields.merge('RafraenUndirskrift' => signature)
           end
+          
+          def format_amount(amount)
+            amount.to_f.round
+          end
         end
       end
     end

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

@@ -0,0 +1,34 @@
+require File.dirname(__FILE__) + '/world_pay/helper.rb'
+require File.dirname(__FILE__) + '/world_pay/notification.rb'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module WorldPay 
+       
+        mattr_accessor :service_url
+        self.service_url = 'https://select.worldpay.com/wcc/purchase'
+
+        mattr_accessor :test_url
+        self.test_url = 'https://select-test.worldpay.com/wcc/purchase'
+
+
+        def self.service_url
+          mode = ActiveMerchant::Billing::Base.integration_mode
+          case mode
+          when :production
+            production_url
+          when :test
+            test_url
+          else
+            raise StandardError, "Integration mode set to an invalid value: #{mode}"
+          end
+        end
+
+        def self.notification(post)
+          Notification.new(post)
+        end  
+      end
+    end
+  end
+end

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

@@ -0,0 +1,100 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module WorldPay
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          mapping :account, 'instId'
+          mapping :amount, 'amount'
+          mapping :order, 'cartId'
+          mapping :currency, 'currency'
+
+          mapping :customer, :email => 'email',
+                             :phone => 'tel'
+
+          mapping :billing_address, :zip => 'postcode',
+                                    :country  => 'country'
+
+          mapping :description, 'desc'
+          mapping :notify_url, 'MC_callback'
+          
+          
+          # WorldPay supports two different test modes - :always_succeed and :always_fail
+          def initialize(order, account, options = {})
+            super
+            
+            if ActiveMerchant::Billing::Base.integration_mode == :test || options[:test]
+              test_mode = case options[:test]
+              when :always_fail
+                101
+              when false
+                0
+              else
+                100
+              end
+              add_field('testMode', test_mode.to_s)
+            elsif ActiveMerchant::Billing::Base.integration_mode == :always_succeed
+              add_field('testMode', '100')
+            elsif ActiveMerchant::Billing::Base.integration_mode == :always_fail
+              add_field('testMode', '101')
+            end
+          end
+          
+          # WorldPay only supports a single address field so we 
+          # have to concat together - lines are separated using &#10;
+          def billing_address(params={})
+            add_field(mappings[:billing_address][:zip], params[:zip])
+            add_field(mappings[:billing_address][:country], lookup_country_code(params[:country]))
+            
+            address = [params[:address1], params[:address2], params[:city], params[:state]].compact
+            add_field('address', address.join('&#10;'))
+          end
+          
+          # WorldPay only supports a single name field so we have to concat
+          def customer(params={})
+            add_field(mappings[:customer][:email], params[:email])
+            add_field(mappings[:customer][:phone], params[:phone])
+            add_field('name', "#{params[:first_name]} #{params[:last_name]}")
+          end
+          
+          # Support for a MD5 hash of selected fields to prevent tampering
+          # For futher information read the tech note at the address below: 
+          # http://support.worldpay.com/kb/integration_guides/junior/integration/help/tech_notes/sjig_tn_009.html
+          def encrypt(secret, fields = [:amount, :currency, :account, :order])
+            signature_fields = fields.collect{ |field| mappings[field] }
+            add_field('signatureFields', signature_fields.join(':'))
+
+            field_values = fields.collect{ |field| form_fields[mappings[field]] }
+            signature    = "#{secret}:#{field_values.join(':')}"            
+            add_field('signature', Digest::MD5.hexdigest(signature))
+          end
+          
+          # Add a time window for which the payment can be completed. Read the link below for how they work
+          # http://support.worldpay.com/kb/integration_guides/junior/integration/help/appendicies/sjig_10100.html
+          def valid_from(from_time)
+            add_field('authValidFrom', from_time.to_i.to_s + '000')
+          end
+          
+          def valid_to(to_time)
+            add_field('authValidTo', to_time.to_i.to_s + '000')
+          end
+          
+          # WorldPay supports the passing of custom parameters prefixed with the following:
+          # C_          : These parameters can be used in the response pages hosted on WorldPay's site
+          # M_          : These parameters are passed through to the callback script (if enabled)
+          # MC_ or CM_  : These parameters are availble both in the response and callback contexts
+          def response_params(params={})
+            params.each{|k,v| add_field("C_#{k}",v)}
+          end
+          
+          def callback_params(params={})
+            params.each{|k,v| add_field("M_#{k}",v)}
+          end
+          
+          def combined_params(params={})
+            params.each{|k,v| add_field("MC_#{k}",v)}
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,160 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module WorldPay
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+          def complete?
+            status == 'Completed'
+          end 
+
+          def account
+            params['instId']
+          end
+
+          def item_id
+            params['cartId']
+          end
+
+          def transaction_id
+            params['transId']
+          end
+
+          # Time this payment was received by the client in UTC time.
+          def received_at
+            Time.at(params['transTime'].to_i / 1000).utc
+          end
+
+          # Callback password set in the WorldPay CMS
+          def security_key
+            params['callbackPW']
+          end
+
+          # the money amount we received in X.2 decimal.
+          def gross
+            params['authAmount']
+          end
+          
+          def currency
+            params['authCurrency']
+          end
+
+          # Was this a test transaction?
+          def test?
+            params.key?('testMode') && params['testMode'] != '0'
+          end
+
+          def status
+            params['transStatus'] == 'Y' ? 'Completed' : 'Cancelled'
+          end
+          
+          def name
+            params['name']
+          end
+          
+          def address
+            params['address']
+          end
+          
+          def postcode
+            params['postcode']
+          end
+          
+          def country
+            params['country']
+          end
+          
+          def phone_number
+            params['tel']
+          end
+          
+          def fax_number
+            params['fax']
+          end
+          
+          def email_address
+            params['email']
+          end
+          
+          def card_type
+            params['cardType']
+          end
+          
+          # WorldPay extended fraud checks returned as a 4 character string
+          #   1st char: Credit card CVV check
+          #   2nd char: Postcode AVS check
+          #   3rd char: Address AVS check
+          #   4th char: Country comparison check
+          # Possible values are:
+          #   :not_supported   -  0
+          #   :not_checked     -  1
+          #   :matched         -  2
+          #   :not_matched     -  4
+          #   :partial_match   -  8
+          def cvv_status
+            return avs_value_to_symbol(params['AVS'][0].chr)
+          end
+
+          def postcode_status
+            return avs_value_to_symbol(params['AVS'][1].chr)
+          end
+
+          def address_status
+            return avs_value_to_symbol(params['AVS'][2].chr)
+          end
+
+          def country_status
+            return avs_value_to_symbol(params['AVS'][3].chr)
+          end
+
+          def acknowledge
+            return true
+          end
+          
+          # WorldPay supports the passing of custom parameters through to the callback script
+          def custom_params
+            return @custom_params ||= read_custom_params
+          end
+          
+          
+          private
+
+          # Take the posted data and move the relevant data into a hash
+          def parse(post)
+            @raw = post
+            for line in post.split('&')
+              key, value = *line.scan( %r{^(\w+)\=(.*)$} ).flatten
+              params[key] = value
+            end
+          end
+          
+          # Read the custom params into a hash
+          def read_custom_params
+            custom = {}
+            params.each do |key, value|
+              if /\A(M_|MC_|CM_)/ === key
+                custom[key.gsub(/\A(M_|MC_|CM_)/, '').to_sym] = value
+              end
+            end
+            custom
+          end
+          
+          # Convert a AVS value to a symbol - see above for more about AVS
+          def avs_value_to_symbol(value)
+            case value.to_s
+            when '8'
+              :partial_match
+            when '4'
+              :no_match
+            when '2'
+              :matched
+            when '1'
+              :not_checked
+            else
+              :not_supported
+            end
+          end
+        end
+      end
+    end
+  end
+end