offsite_payments 2.0.0

data/lib/offsite_payments/integrations/dwolla.rb

@@ -0,0 +1,160 @@
+module OffsitePayments #:nodoc:
+  module Integrations #:nodoc:
+    module Dwolla
+      mattr_accessor :service_url
+      self.service_url = 'https://www.dwolla.com/payment/pay'
+
+      def self.notification(post, options={})
+        Notification.new(post, options)
+      end
+
+      def self.return(query_string, options={})
+        Return.new(query_string, options)
+      end
+
+      module Common
+        def verify_signature(checkoutId, amount, notification_signature, secret)
+          if secret.nil?
+            raise ArgumentError, "You need to provide the Application secret as the option :credential3 to verify that the notification originated from Dwolla"
+          end
+
+          expected_signature = OpenSSL::HMAC.hexdigest(OpenSSL::Digest::SHA1.new, secret, "%s&%.2f" % [checkoutId, amount])
+
+          if notification_signature != expected_signature
+            raise StandardError, "Dwolla signature verification failed."
+          end
+        end
+      end
+
+      class Helper < OffsitePayments::Helper
+        def initialize(order, account, options = {})
+          super
+          add_field('name', 'Store Purchase')
+
+          timestamp = Time.now.to_i.to_s
+
+          if OffsitePayments.mode == :test || options[:test]
+            add_field('test', 'true')
+            # timestamp used for test signature generation:
+            timestamp = "1370726016"
+          end
+
+          add_field('timestamp', timestamp)
+          add_field('allowFundingSources', 'true')
+
+          key = options[:credential2].to_s
+          secret = options[:credential3].to_s
+          orderid = order.to_s
+          signature = OpenSSL::HMAC.hexdigest(OpenSSL::Digest::SHA1.new, secret, "#{key}&#{timestamp}&#{orderid}")
+          add_field('signature', signature)
+        end
+
+        mapping :account, 'destinationid'
+        mapping :credential2, 'key'
+        mapping :notify_url, 'callback'
+        mapping :return_url, 'redirect'
+        mapping :description, 'description'
+        mapping :amount, 'amount'
+        mapping :tax, 'tax'
+        mapping :shipping, 'shipping'
+        mapping :order, 'orderid'
+      end
+
+      class Notification < OffsitePayments::Notification
+        include Common
+
+        def initialize(data, options)
+          super
+        end
+
+        def complete?
+          (status == "Completed")
+        end
+
+        def status
+          params["Status"]
+        end
+
+        def transaction_id
+          params['TransactionId']
+        end
+
+        def item_id
+          params['OrderId']
+        end
+
+        def currency
+          "USD"
+        end
+
+        def gross
+          params['Amount']
+        end
+
+        def error
+          params['Error']
+        end
+
+        def test?
+          params['TestMode'] != "false"
+        end
+
+        def acknowledge(authcode = nil)
+          true
+        end
+
+        private
+
+        def parse(post)
+          @raw = post.to_s
+          json_post = JSON.parse(post)
+          verify_signature(json_post['CheckoutId'], json_post['Amount'], json_post['Signature'], @options[:credential3])
+
+          params.merge!(json_post)
+        end
+      end
+
+      class Return < OffsitePayments::Return
+        include Common
+
+        def initialize(data, options)
+          params = parse(data)
+
+          if params['error'] != 'failure'
+            verify_signature(params['checkoutId'], params['amount'], params['signature'], options[:credential3])
+          end
+
+          super
+        end
+
+        def success?
+          (self.error.nil? && self.callback_success?)
+        end
+
+        def error
+          params['error']
+        end
+
+        def error_description
+          params['error_description']
+        end
+
+        def checkout_id
+          params['checkoutId']
+        end
+
+        def transaction
+          params['transaction']
+        end
+
+        def test?
+          params['test'] != nil
+        end
+
+        def callback_success?
+          (params['postback'] != "failure")
+        end
+      end
+    end
+  end
+end

data/lib/offsite_payments/integrations/e_payment_plans.rb

@@ -0,0 +1,146 @@
+module OffsitePayments #:nodoc:
+  module Integrations #:nodoc:
+    module EPaymentPlans
+      mattr_accessor :production_url
+      self.production_url = 'https://www.epaymentplans.com'
+
+      mattr_accessor :test_url
+      self.test_url = 'https://test.epaymentplans.com'
+
+      def self.service_url
+        mode = OffsitePayments.mode
+        case mode
+        when :production
+          "#{production_url}/order/purchase"
+        when :test
+          "#{test_url}/order/purchase"
+        else
+          raise StandardError, "Integration mode set to an invalid value: #{mode}"
+        end
+      end
+
+      def self.notification_confirmation_url
+        mode = OffsitePayments.mode
+        case mode
+        when :production
+          "#{production_url}/order/confirmation"
+        when :test
+          "#{test_url}/order/confirmation"
+        else
+          raise StandardError, "Integration mode set to an invalid value: #{mode}"
+        end
+      end
+
+      def self.notification(post, options = {})
+        Notification.new(post, options)
+      end
+
+      def self.return(query_string, options = {})
+        Return.new(query_string, options)
+      end
+
+      class Helper < OffsitePayments::Helper
+        mapping :account, 'order[account]'
+        mapping :amount, 'order[amount]'
+
+        mapping :order, 'order[num]'
+
+        mapping :customer, :first_name => 'order[first_name]',
+                           :last_name  => 'order[last_name]',
+                           :email      => 'order[email]',
+                           :phone      => 'order[phone]'
+
+        mapping :billing_address, :city     => 'order[city]',
+                                  :address1 => 'order[address1]',
+                                  :address2 => 'order[address2]',
+                                  :company  => 'order[company]',
+                                  :state    => 'order[state]',
+                                  :zip      => 'order[zip]',
+                                  :country  => 'order[country]'
+
+        mapping :notify_url, 'order[notify_url]'
+        mapping :return_url, 'order[return_url]'
+        mapping :cancel_return_url, 'order[cancel_return_url]'
+        mapping :description, 'order[description]'
+        mapping :tax, 'order[tax]'
+        mapping :shipping, 'order[shipping]'
+      end
+
+      class Notification < OffsitePayments::Notification
+        include ActiveMerchant::PostsData
+        def complete?
+          status == "Completed"
+        end
+
+        def transaction_id
+          params['transaction_id']
+        end
+
+        def item_id
+          params['item_id']
+        end
+
+        # When was this payment received by the client.
+        def received_at
+          Time.parse(params['received_at'].to_s).utc
+        end
+
+        def gross
+          params['gross']
+        end
+
+        def currency
+          params['currency']
+        end
+
+        def security_key
+          params['security_key']
+        end
+
+        # Was this a test transaction?
+        def test?
+          params['test'] == 'test'
+        end
+
+        def status
+          params['status'].capitalize
+        end
+
+        # Acknowledge the transaction to EPaymentPlans. This method has to be called after a new
+        # apc arrives. EPaymentPlans will verify that all the information we received are correct
+        # and will return ok or a fail.
+        #
+        # Example:
+        #
+        #   def ipn
+        #     notify = EPaymentPlans.notification(request.raw_post)
+        #
+        #     if notify.acknowledge
+        #       ... process order ... if notify.complete?
+        #     else
+        #       ... log possible hacking attempt ...
+        #     end
+        def acknowledge(authcode = nil)
+          payload = raw
+
+          response = ssl_post(EPaymentPlans.notification_confirmation_url, payload)
+
+          # Replace with the appropriate codes
+          raise StandardError.new("Faulty EPaymentPlans result: #{response}") unless ["AUTHORISED", "DECLINED"].include?(response)
+          response == "AUTHORISED"
+        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
+      end
+    end
+  end
+end

data/lib/offsite_payments/integrations/easy_pay.rb

@@ -0,0 +1,137 @@
+module OffsitePayments #:nodoc:
+  module Integrations #:nodoc:
+    # Documentation: https://ssl.easypay.by/light/
+    module EasyPay
+      mattr_accessor :signature_parameter_name
+      self.signature_parameter_name = 'EP_Hash'
+
+      mattr_accessor :notify_signature_parameter_name
+      self.notify_signature_parameter_name = 'notify_signature'
+
+      mattr_accessor :service_url
+      self.service_url = 'https://ssl.easypay.by/weborder/'
+
+      def self.helper(order, account, options = {})
+        Helper.new(order, account, options)
+      end
+
+      def self.notification(query_string, options = {})
+        Notification.new(query_string, options)
+      end
+
+      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_signature_string
+          [
+            @fields[mappings[:account]],
+            @secret,
+            @fields[mappings[:order]],
+            @fields[mappings[:amount]]
+          ].join
+        end
+
+        def notify_signature_string
+          [
+            params['order_mer_code'],
+            params['sum'],
+            params['mer_no'],
+            params['card'],
+            params['purch_date'],
+            secret
+          ].join
+        end
+      end
+
+      class Helper < OffsitePayments::Helper
+        include Common
+
+        def initialize(order, account, options = {})
+          super
+          @secret = options[:credential2]
+        end
+
+        def form_fields
+          @fields.merge(OffsitePayments::Integrations::EasyPay.signature_parameter_name => generate_signature(:request))
+        end
+
+        def params
+          @fields
+        end
+
+        mapping :account, 'EP_MerNo'
+        mapping :amount, 'EP_Sum'
+        mapping :order, 'EP_OrderNo'
+        mapping :comment, 'EP_Comment'
+        mapping :order_info, 'EP_OrderInfo'
+        mapping :expires, 'EP_Expires'
+        mapping :success_url, 'EP_Success_URL'
+        mapping :cancel_url, 'EP_Cancel_URL'
+        mapping :debug, 'EP_Debug'
+        mapping :url_type, 'EP_URL_Type'
+        mapping :encoding, 'EP_Encoding'
+      end
+
+      class Notification < OffsitePayments::Notification
+        include Common
+
+        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 EasyPay"
+          end
+
+          super
+        end
+
+        def self.recognizes?(params)
+          params.has_key?('order_mer_code') && params.has_key?('sum')
+        end
+
+        def complete?
+          true
+        end
+
+        def amount
+          BigDecimal.new(gross)
+        end
+
+        def item_id
+          params['order_mer_code']
+        end
+
+        def security_key
+          params[OffsitePayments::Integrations::EasyPay.notify_signature_parameter_name]
+        end
+
+        def gross
+          params['sum']
+        end
+
+        def status
+          'Completed'
+        end
+
+        def secret
+          @options[:credential2]
+        end
+
+        def acknowledge(authcode = nil)
+          security_key == generate_signature(:notify)
+        end
+
+        def success_response(*args)
+          { :nothing => true }
+        end
+      end
+    end
+  end
+end

data/lib/offsite_payments/integrations/epay.rb

@@ -0,0 +1,161 @@
+module OffsitePayments #:nodoc:
+  module Integrations #:nodoc:
+    module Epay
+      mattr_accessor :service_url
+      self.service_url = 'https://ssl.ditonlinebetalingssystem.dk/integration/ewindow/Default.aspx'
+
+      def self.notification(post, options = {})
+        Notification.new(post)
+      end
+
+      def self.return(post, options = {})
+        Return.new(post, options)
+      end
+
+      class Helper < OffsitePayments::Helper
+        def initialize(order, merchantnumber, options = {})
+          super
+          add_field('windowstate', 3)
+          add_field('language', '0')
+          add_field('orderid', format_order_number(order))
+          @fields = Hash[@fields.sort]
+        end
+
+        def md5secret(value)
+          @md5secret = value
+        end
+
+        def form_fields
+          @fields.merge('hash' => generate_md5hash)
+        end
+
+        def generate_md5string
+          @fields.sort.each.map { |key, value| key != 'hash' ? value.to_s : ''} * "" + @md5secret
+        end
+
+        def generate_md5hash
+          Digest::MD5.hexdigest(generate_md5string)
+        end
+
+        # Limited to 20 digits max
+        def format_order_number(number)
+          number.to_s.gsub(/[^\w_]/, '').rjust(4, "0")[0...20]
+        end
+
+        mapping :account, 'merchantnumber'
+        mapping :language, 'language'
+        mapping :amount, 'amount'
+        mapping :currency, 'currency'
+        mapping :return_url, 'accepturl'
+        mapping :cancel_return_url, 'cancelurl'
+        mapping :notify_url, 'callbackurl'
+        mapping :autocapture, 'instantcapture'
+        mapping :description, 'description'
+        mapping :credential3, 'md5secret'
+        mapping :customer, ''
+        mapping :billing_address, {}
+        mapping :tax, ''
+        mapping :shipping, ''
+      end
+
+      class Notification < OffsitePayments::Notification
+        CURRENCY_CODES = {
+          :ADP => '020', :AED => '784', :AFA => '004', :ALL => '008', :AMD => '051',
+          :ANG => '532', :AOA => '973', :ARS => '032', :AUD => '036', :AWG => '533',
+          :AZM => '031', :BAM => '977', :BBD => '052', :BDT => '050', :BGL => '100',
+          :BGN => '975', :BHD => '048', :BIF => '108', :BMD => '060', :BND => '096',
+          :BOB => '068', :BOV => '984', :BRL => '986', :BSD => '044', :BTN => '064',
+          :BWP => '072', :BYR => '974', :BZD => '084', :CAD => '124', :CDF => '976',
+          :CHF => '756', :CLF => '990', :CLP => '152', :CNY => '156', :COP => '170',
+          :CRC => '188', :CUP => '192', :CVE => '132', :CYP => '196', :CZK => '203',
+          :DJF => '262', :DKK => '208', :DOP => '214', :DZD => '012', :ECS => '218',
+          :ECV => '983', :EEK => '233', :EGP => '818', :ERN => '232', :ETB => '230',
+          :EUR => '978', :FJD => '242', :FKP => '238', :GBP => '826', :GEL => '981',
+          :GHC => '288', :GIP => '292', :GMD => '270', :GNF => '324', :GTQ => '320',
+          :GWP => '624', :GYD => '328', :HKD => '344', :HNL => '340', :HRK => '191',
+          :HTG => '332', :HUF => '348', :IDR => '360', :ILS => '376', :INR => '356',
+          :IQD => '368', :IRR => '364', :ISK => '352', :JMD => '388', :JOD => '400',
+          :JPY => '392', :KES => '404', :KGS => '417', :KHR => '116', :KMF => '174',
+          :KPW => '408', :KRW => '410', :KWD => '414', :KYD => '136', :KZT => '398',
+          :LAK => '418', :LBP => '422', :LKR => '144', :LRD => '430', :LSL => '426',
+          :LTL => '440', :LVL => '428', :LYD => '434', :MAD => '504', :MDL => '498',
+          :MGF => '450', :MKD => '807', :MMK => '104', :MNT => '496', :MOP => '446',
+          :MRO => '478', :MTL => '470', :MUR => '480', :MVR => '462', :MWK => '454',
+          :MXN => '484', :MXV => '979', :MYR => '458', :MZM => '508', :NAD => '516',
+          :NGN => '566', :NIO => '558', :NOK => '578', :NPR => '524', :NZD => '554',
+          :OMR => '512', :PAB => '590', :PEN => '604', :PGK => '598', :PHP => '608',
+          :PKR => '586', :PLN => '985', :PYG => '600', :QAR => '634', :ROL => '642',
+          :RUB => '643', :RUR => '810', :RWF => '646', :SAR => '682', :SBD => '090',
+          :SCR => '690', :SDD => '736', :SEK => '752', :SGD => '702', :SHP => '654',
+          :SIT => '705', :SKK => '703', :SLL => '694', :SOS => '706', :SRG => '740',
+          :STD => '678', :SVC => '222', :SYP => '760', :SZL => '748', :THB => '764',
+          :TJS => '972', :TMM => '795', :TND => '788', :TOP => '776', :TPE => '626',
+          :TRL => '792', :TRY => '949', :TTD => '780', :TWD => '901', :TZS => '834',
+          :UAH => '980', :UGX => '800', :USD => '840', :UYU => '858', :UZS => '860',
+          :VEB => '862', :VND => '704', :VUV => '548', :XAF => '950', :XCD => '951',
+          :XOF => '952', :XPF => '953', :YER => '886', :YUM => '891', :ZAR => '710',
+          :ZMK => '894', :ZWD => '716'
+        }
+
+        def complete?
+          Integer(transaction_id) > 0
+        end
+
+        def item_id
+          params['orderid']
+        end
+
+        def transaction_id
+          params['txnid']
+        end
+
+        def received_at
+          Time.mktime(params['date'][0..3], params['date'][4..5], params['date'][6..7], params['time'][0..1], params['time'][2..3])
+        end
+
+        def gross
+          "%.2f" % (gross_cents / 100.0)
+        end
+
+        def gross_cents
+          params['amount'].to_i
+        end
+
+        def test?
+          return false
+        end
+
+        %w(txnid orderid amount currency date time hash fraud payercountry issuercountry txnfee subscriptionid paymenttype cardno).each do |attr|
+          define_method(attr) do
+            params[attr]
+          end
+        end
+
+        def currency
+          CURRENCY_CODES.invert[params['currency']].to_s
+        end
+
+        def amount
+          Money.new(params['amount'].to_i, currency)
+        end
+
+        def generate_md5string
+          md5string = String.new
+          for line in @raw.split('&')
+            key, value = *line.scan( %r{^([A-Za-z0-9_.]+)\=(.*)$} ).flatten
+            md5string += params[key] if key != 'hash'
+          end
+          return md5string + @options[:credential3]
+        end
+
+        def generate_md5hash
+          Digest::MD5.hexdigest(generate_md5string)
+        end
+
+        def acknowledge
+          generate_md5hash == params['hash']
+        end
+      end
+    end
+  end
+end