activemerchant_banklink 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in activemerchant_banklink.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2005-2010 Tobias Luetke
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,32 @@
+= Active Merchant Banklink
+
+WARNING: this is an early release. THINGS WILL CHANGE.
+
+This library adds Banklink payment integration support to {ActiveMerchant}[http://activemerchant.org].
+
+Gem is originally based on ActiveMerchant {fork}[https://github.com/indrekj/active_merchant] by Indrek Juhkam.
+
+== Installation
+
+=== From Ruby Gems
+
+Installation from RubyGems
+
+  > gem install activemerchant_banklink
+
+=== From Git
+
+You can check out the latest source from git:
+
+  > git pull git://github.com/laurynas/activemerchant_banklink.git
+
+== Testing
+
+You can run the tests from this gem with (inside the activemerchant_banklink directory):
+
+  > rake test
+
+== Maintainer
+
+This gem is maintained by {Laurynas Butkus}[mailto:laurynas.butkus@gmail.com]
+

data/Rakefile

@@ -0,0 +1,26 @@
+require 'bundler'
+require 'rake/testtask'
+
+Bundler::GemHelper.install_tasks
+
+desc "Run the unit test suite"
+task :default => 'test:units'
+    
+namespace :test do
+    
+  Rake::TestTask.new(:units) do |t|
+    t.pattern = 'test/unit/**/*_test.rb'
+    t.ruby_opts << '-rubygems'
+    t.libs << 'test'
+    t.verbose = true
+  end
+  
+  Rake::TestTask.new(:remote) do |t|
+    t.pattern = 'test/remote/**/*_test.rb'
+    t.ruby_opts << '-rubygems'
+    t.libs << 'test'
+    t.verbose = true
+  end
+  
+end
+

data/activemerchant_banklink.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "activemerchant_banklink/version"
+
+Gem::Specification.new do |s|
+  s.name        = "activemerchant_banklink"
+  s.version     = ActivemerchantBanklink::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Indrek Juhkam", "Laurynas Butkus"]
+  s.email       = ["laurynas.butkus@gmail.com"]
+  s.homepage    = "http://github.com/laurynas/activemerchant_banklink"
+  s.summary     = %q{ActiveMerchant Banklink add-on (alpha version)}
+  s.description = %q{Adds Banklink support to ActiveMerchant library. Banklink is provided by major banks in the Baltic states.}
+
+  s.rubyforge_project = "activemerchant_banklink"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/init.rb

@@ -0,0 +1 @@
+require 'activemerchant_banklink'

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

@@ -0,0 +1,117 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Pizza #:nodoc:
+        module Helper #:nodoc:
+
+          def self.included(base)
+            base.class_eval do
+              mapping :account, 'VK_SND_ID'
+              # Amount paid, for example, "33.00"
+              mapping :amount, 'VK_AMOUNT'
+              # Unique order id
+              mapping :order, 'VK_STAMP'
+              # Currency used, 3-letter ISO 4217 code
+              mapping :currency, 'VK_CURR'
+              mapping :notify_url, 'VK_RETURN'
+              mapping :return_url, 'VK_RETURN'
+              mapping :cancel_return_url, 'VK_CANCEL'
+              
+              mapping :reference, 'VK_REF'
+              mapping :description, 'VK_MSG'
+            end
+          end
+
+          def initialize(order, account, options = {})
+            old_valid_keys = [:amount, :currency, :test]
+            new_valid_keys = [:description, :reference]
+            valid_keys = (old_valid_keys + new_valid_keys + Pizza.required_service_params.values << :service_msg_number).uniq
+            options.assert_valid_keys(valid_keys)
+
+            @options = options
+            @fields = {}
+            self.order = order
+            self.account = account
+            self.amount = options[:amount]
+            self.currency = options[:currency]
+            self.description = options[:description]
+            self.reference = options[:reference]
+
+            if options[:service_msg_number]
+              @service_msg_number = options.delete(:service_msg_number)
+            else
+              @service_msg_number = default_service_msg_number
+            end
+
+            add_required_params
+            add_charset_field
+            add_vk_mac
+          end
+
+          # Amount can be supplied with a optional dot separator for cents.
+          def amount=(amount)
+            # TODO check this, sooner or later someone will get a wrong amount.
+
+            # If a string is passed to us, don't do anything.
+            # If a Money object is passed to us, don't do anything.
+            # Otherwise delegate the handling to the money object
+            # and free ourself from the responsibility, yay.
+            if amount.is_a?(String) || amount.is_a?(Money)
+              add_field('VK_AMOUNT', amount)
+            else
+              add_field('VK_AMOUNT', Money.new(amount).to_s)
+            end
+          end
+
+          def add_vk_mac
+            # Signature used to validate previous parameters
+            add_field('VK_MAC', generate_mac(@service_msg_number, form_fields))
+          end
+
+          def add_charset_field
+            add_field vk_charset_param, vk_charset
+          end
+
+          def add_required_params
+            required_params = Pizza.required_service_params[@service_msg_number]
+            required_params.each do |param|
+              param_value = (@options.delete(param) || send(param.to_s.downcase)).to_s
+              add_field param, iconv.iconv(param_value)
+            end
+          end
+
+          # Default parameters
+          def vk_charset
+            'ISO-8859-1'
+          end
+
+          def vk_charset_param
+            'VK_CHARSET'
+          end
+
+          def vk_service
+            @service_msg_number
+          end
+
+          def vk_version
+            '008'
+          end
+
+          # Default service message number.
+          # Use '1002' because it requires the least amount of parameters.
+          def default_service_msg_number
+            1002
+          end
+
+          private
+          # Iconv converter to convert from utf8 to
+          # the charset the bank api expects.
+          def iconv
+            @iconv ||= Iconv.new(vk_charset, 'UTF-8')
+          end
+
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,101 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Pizza
+        module Notification
+
+          # A helper method to parse the raw post of the request & return
+          # the right Notification subclass based on the sender id.
+          def self.get_notification(http_raw_data)
+            params = ActiveMerchant::Billing::Integrations::Notification.new(http_raw_data).params
+            Pizza.get_class(params['VK_SND_ID'])::Notification.new(params)
+          end
+
+          def bank_signature_valid?(bank_signature, service_msg_number, sigparams)
+            self.class.parent.get_bank_public_key.verify(OpenSSL::Digest::SHA1.new, bank_signature, generate_data_string(service_msg_number, sigparams))
+          end
+
+          def complete?
+            params['VK_SERVICE'] == '1101'
+          end
+
+          def currency
+            params['VK_CURR']
+          end
+
+          # The order id we passed to the form helper.
+          def item_id
+            params['VK_STAMP']
+          end
+
+          def transaction_id
+            params['VK_T_NO']
+          end
+
+          # When was this payment received by the client.
+          # We're expecting a dd.mm.yyyy format.
+          def received_at
+            date = params['VK_T_DATE']
+            return nil unless date
+            day, month, year = *date.split('.').map(&:to_i)
+            Date.civil(year, month, day)
+          end
+
+          def signature
+            Base64.decode64(params['VK_MAC'])
+          end
+
+          # The money amount we received, string.
+          def gross
+            params['VK_AMOUNT']
+          end
+
+          # Was this a test transaction?
+          def test?
+            params['VK_REC_ID'] == 'testvpos'
+          end
+
+          # TODO what should be here?
+          def status
+            complete? ? 'Completed' : 'Failed'
+          end
+
+          # If our request was sent automatically by the bank (true) or manually
+          # by the user triggering the callback by pressing a "return" button (false).
+          def automatic?
+            params['VK_AUTO'].upcase == 'Y'
+          end
+
+          def success?
+            acknowledge && complete?
+          end
+
+          # We don't actually acknowledge the notification by making another request ourself,
+          # instead, we check the notification by checking the signature that came with the notification.
+          # This method has to be called when handling the notification & deciding whether to process the order.
+          # Example:
+          #
+          #   def notify
+          #     notify = Notification.new(params)
+          #
+          #     if notify.acknowledge
+          #       ... process order ... if notify.complete?
+          #     else
+          #       ... log possible hacking attempt ...
+          #     end
+          def acknowledge
+            bank_signature_valid?(signature, params['VK_SERVICE'], params)
+          end
+
+          private
+          # Take the posted data and move the relevant data into a hash
+          # No parsing since we're already expecting a hash.
+          def parse(params)
+            raise(ArgumentError, 'Need a hash') unless params.is_a?(Hash)
+            @params = params
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,116 @@
+require 'active_merchant/billing/integrations/pizza/helper.rb'
+require 'active_merchant/billing/integrations/pizza/notification.rb'
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Pizza
+
+        # Define sender id (VK_SND_ID) to bank module mappings.
+        def self.get_class(vk_snd_id)
+          case vk_snd_id
+            when 'EYP' then SebEst
+            when 'SAMPOPANK' then SampoEst
+            when 'HP' then SwedbankEst
+            else raise(ArgumentError, "unknown sender id: #{vk_snd_id}")
+          end
+        end
+
+        # Define required fields for each service message.
+        # We need to know this in order to calculate VK_MAC
+        # from a given hash of parameters.
+        # Order of the parameters is important.
+        mattr_accessor :required_service_params
+        self.required_service_params = {
+          1001 => [
+            'VK_SERVICE',
+            'VK_VERSION',
+            'VK_SND_ID',
+            'VK_STAMP',
+            'VK_AMOUNT',
+            'VK_CURR',
+            'VK_ACC',
+            'VK_NAME',
+            'VK_REF',
+            'VK_MSG'],
+          1002 => [
+            'VK_SERVICE',
+            'VK_VERSION',
+            'VK_SND_ID',
+            'VK_STAMP',
+            'VK_AMOUNT',
+            'VK_CURR',
+            'VK_REF',
+            'VK_MSG' ],
+          1101 => [
+            'VK_SERVICE',
+            'VK_VERSION',
+            'VK_SND_ID',
+            'VK_REC_ID',
+            'VK_STAMP',
+            'VK_T_NO',
+            'VK_AMOUNT',
+            'VK_CURR',
+            'VK_REC_ACC',
+            'VK_REC_NAME',
+            'VK_SND_ACC',
+            'VK_SND_NAME',
+            'VK_REF',
+            'VK_MSG',
+            'VK_T_DATE'],
+          1901 => [
+            'VK_SERVICE',
+            'VK_VERSION',
+            'VK_SND_ID',
+            'VK_REC_ID',
+            'VK_STAMP',
+            'VK_REF',
+            'VK_MSG']
+        }
+
+        # Calculation using method VK_VERSION=008:
+        # VK_MAC is RSA signature of the request fields coded into BASE64.
+        # VK_MAC will be calculated using secret key of the sender using RSA. Signature will
+        # be calculated for string that consists of all field lengths and contents in the query. Also
+        # empty fields are used in calculation – lenght “000”. Unnumbered (optional) fields are
+        # not used in calculation.
+        # MAC(x1,x2,...,xn) := RSA( SHA-1(p(x1 )|| x1|| p(x2 )|| x2 || ... ||p( xn )||xn),d,n)
+        # where:
+        # || is string concatenation mark
+        # x1, x2, ..., xn are parameters of the query
+        # p(x) is length of the field x represented by three digits
+        # d is RSA secret exponent
+        # n is RSA modulus
+        module Common
+          # p(x) is length of the field x represented by three digits
+          def func_p(val)
+            sprintf("%03i", val.size)
+          end
+
+          # Generate a string to be signed out of service message parameters.
+          # p(x1 )|| x1|| p(x2 )|| x2 || ... ||p( xn )||xn
+          # || is string concatenation mark
+          # p(x) is length of the field x represented by three digits
+          # Parameters val1, val2, value3 would be turned into:
+          # '003val1003val2006value3'
+          def generate_data_string(service_msg_number, sigparams)
+            str = ''
+            Pizza.required_service_params[Integer(service_msg_number)].each do |param|
+              val = sigparams[param].to_s # nil goes to ''
+              str << func_p(val) << val
+            end
+            str
+          end
+
+          def generate_signature(service_msg_number, sigparams)
+            privkey = self.class.parent.get_private_key
+            privkey.sign(OpenSSL::Digest::SHA1.new, generate_data_string(service_msg_number, sigparams))
+          end
+
+          def generate_mac(service_msg_number, sigparams)
+            Base64.encode64(generate_signature(service_msg_number, sigparams)).gsub(/\n/,'')
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module SampoEst #:nodoc:
+        class Helper < ActiveMerchant::Billing::Integrations::Helper #:nodoc:
+          include Pizza::Common
+          include Pizza::Helper
+
+          def vk_charset
+            'ISO-8859-4'
+          end
+
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,12 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module SampoEst #:nodoc:
+        class Notification < ActiveMerchant::Billing::Integrations::Notification #:nodoc:
+          include Pizza::Common
+          include Pizza::Notification
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,101 @@
+require File.dirname(__FILE__) + '/sampo_est/helper.rb'
+require File.dirname(__FILE__) + '/sampo_est/notification.rb'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+
+      # This module implements bank payments through
+      # AS Sampo Pank (http://www.sampopank.ee/en/index.html) using
+      # their bank link service (see http://www.sampopank.ee/en/25672.html).
+      #
+      # Configuration:
+      # ActiveMerchant::Billing::Integrations::SampoEst.bank_certificate = File.read('cert')
+      # ActiveMerchant::Billing::Integrations::SampoEst.test_bank_certificate = File.read('cert')
+      # ActiveMerchant::Billing::Integrations::SampoEst.private_key = File.read('keyfile')
+      # ActiveMerchant::Billing::Integrations::SampoEst.test_private_key = File.read('keyfile')
+      # ActiveMerchant::Billing::Integrations::SampoEst.test_url = 'https://test-gateway.tld/gw'
+      # ActiveMerchant::Billing::Integrations::SampoEst.production_url = 'https://production-gateway.tld/gw/'
+      #
+      # The syntax of the helper is as follows:
+      #   <% payment_service_for order_id, account_id,
+      #     :amount => 50.00,
+      #     :service => :sampo_est do |service| %>
+      #
+      #     <% service.notify_url url_for(:action => 'notify', :only_path => false) %>
+      #     <% service.cancel_return_url 'http://mystore.com' %>
+      #   <% end %>
+      #
+      # The order_id parameter is a random id referencing the transaction (VK_STAMP)
+      # The account_id parameter is a id given to you from the bank (VK_SND_ID)
+      # The notify_url is the URL that the bank will send its responses.
+      #
+      # You can handle the notification in
+      # your controller action as follows:
+      #
+      #   class NotificationController < ApplicationController
+      #     include ActiveMerchant::Billing::Integrations
+      #
+      #     def notify
+      #       # Notification class is automatically fetched based on the request parameters.
+      #       notify = Pizza::Notification.get_notification(params)
+      #
+      #       if notify.acknowledge
+      #         ... process order ... if notify.complete?
+      #       else
+      #         ... log possible hacking attempt ...
+      #       end
+      #     end
+      #   end
+
+      module SampoEst
+
+        # Raw X509 certificate of the bank, string format.
+        mattr_accessor :bank_certificate
+        mattr_accessor :test_bank_certificate
+        # RSA public key of the bank, taken from the X509 certificate of the bank. OpenSSL container.
+        def self.get_bank_public_key
+          if ActiveMerchant::Billing::Base.integration_mode == :production
+            cert = self.bank_certificate
+          else
+            cert = self.test_bank_certificate
+          end
+          OpenSSL::X509::Certificate.new(cert.gsub(/  /, '')).public_key
+        end
+
+        # Our raw RSA private key, string format.
+        mattr_accessor :private_key
+        mattr_accessor :test_private_key
+        # Our RSA private key. OpenSSL container.
+        def self.get_private_key
+          if ActiveMerchant::Billing::Base.integration_mode == :production
+            private_key = self.private_key
+          else
+            private_key = self.test_private_key
+          end
+          OpenSSL::PKey::RSA.new(private_key.gsub(/  /, ''))
+        end
+
+        # Bank gateway
+        mattr_accessor :test_url
+        mattr_accessor :production_url
+        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.notification(post)
+          Notification.new(post)
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module SebEst #:nodoc:
+        class Helper < ActiveMerchant::Billing::Integrations::Helper #:nodoc:
+          include Pizza::Common
+          include Pizza::Helper
+
+          def vk_charset
+            'UTF-8'
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,12 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module SebEst #:nodoc:
+        class Notification < ActiveMerchant::Billing::Integrations::Notification #:nodoc:
+          include Pizza::Common
+          include Pizza::Notification
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,100 @@
+require File.dirname(__FILE__) + '/seb_est/helper.rb'
+require File.dirname(__FILE__) + '/seb_est/notification.rb'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+
+      # This module implements bank payments through
+      # SEB Eesti Ühispank (http://www.seb.ee/index/1305) using
+      # their bank link service (see http://www.seb.ee/page/130212050205).
+      #
+      # Configuration:
+      # ActiveMerchant::Billing::Integrations::SebEst.bank_certificate = File.read('cert')
+      # ActiveMerchant::Billing::Integrations::SebEst.test_bank_certificate = File.read('cert')
+      # ActiveMerchant::Billing::Integrations::SebEst.private_key = File.read('keyfile')
+      # ActiveMerchant::Billing::Integrations::SebEst.test_private_key = File.read('keyfile')
+      # ActiveMerchant::Billing::Integrations::SebEst.test_url = 'https://test-gateway.tld/gw'
+      # ActiveMerchant::Billing::Integrations::SebEst.production_url = 'https://production-gateway.tld/gw/'
+      #
+      # The syntax of the helper is as follows:
+      #   <% payment_service_for order_id, account_id,
+      #     :amount => 50.00,
+      #     :service => :seb_est do |service| %>
+      #
+      #     <% service.notify_url url_for(:action => 'notify', :only_path => false) %>
+      #     <% service.cancel_return_url 'http://mystore.com' %>
+      #   <% end %>
+      #
+      # The order_id parameter is a random id referencing the transaction (VK_STAMP)
+      # The account_id parameter is a id given to you from the bank (VK_SND_ID)
+      # The notify_url is the URL that the bank will send its responses.
+      #
+      # You can handle the notification in
+      # your controller action as follows:
+      #
+      #   class NotificationController < ApplicationController
+      #     include ActiveMerchant::Billing::Integrations
+      #
+      #     def notify
+      #       # Notification class is automatically fetched based on the request parameters.
+      #       notify = Pizza::Notification.get_notification(params)
+      #
+      #       if notify.acknowledge
+      #         ... process order ... if notify.complete?
+      #       else
+      #         ... log possible hacking attempt ...
+      #       end
+      #     end
+      #   end
+
+      module SebEst
+
+        # Raw X509 certificate of the bank, string format.
+        mattr_accessor :bank_certificate
+        mattr_accessor :test_bank_certificate
+        # RSA public key of the bank, taken from the X509 certificate of the bank. OpenSSL container.
+        def self.get_bank_public_key
+          if ActiveMerchant::Billing::Base.integration_mode == :production
+            cert = self.bank_certificate
+          else
+            cert = self.test_bank_certificate
+          end
+          OpenSSL::X509::Certificate.new(cert.gsub(/  /, '')).public_key
+        end
+
+        # Our raw RSA private key, string format.
+        mattr_accessor :private_key
+        mattr_accessor :test_private_key
+        # Our RSA private key. OpenSSL container.
+        def self.get_private_key
+          if ActiveMerchant::Billing::Base.integration_mode == :production
+            private_key = self.private_key
+          else
+            private_key = self.test_private_key
+          end
+          OpenSSL::PKey::RSA.new(private_key.gsub(/  /, ''))
+        end
+
+        mattr_accessor :test_url
+        mattr_accessor :production_url
+        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.notification(post)
+          Notification.new(post)
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module SwedbankEst #:nodoc:
+        class Helper < ActiveMerchant::Billing::Integrations::Helper #:nodoc:
+          include Pizza::Common
+          include Pizza::Helper
+
+          def vk_charset
+            'ISO-8859-1'
+          end
+
+          def vk_charset_param
+            'VK_ENCODING'
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,12 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module SwedbankEst #:nodoc:
+        class Notification < ActiveMerchant::Billing::Integrations::Notification #:nodoc:
+          include Pizza::Common
+          include Pizza::Notification
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,99 @@
+require File.dirname(__FILE__) + '/swedbank_est/helper.rb'
+require File.dirname(__FILE__) + '/swedbank_est/notification.rb'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+
+      # This module implements bank payments through
+      # Aktsiaselts Hansapank using their bank link service
+      # (http://w.hansa.ee/eng/arikliendile_teenusedkaupmehele_makselahendusedinternetis_tehnilinekirjeldus.html).
+      #
+      # Configuration:
+      # ActiveMerchant::Billing::Integrations::SwedbankEst.bank_certificate = File.read('cert')
+      # ActiveMerchant::Billing::Integrations::SwedbankEst.test_bank_certificate = File.read('cert')
+      # ActiveMerchant::Billing::Integrations::SwedbankEst.private_key = File.read('keyfile')
+      # ActiveMerchant::Billing::Integrations::SwedbankEst.test_private_key = File.read('keyfile')
+      # ActiveMerchant::Billing::Integrations::SwedbankEst.production_url = 'https://production-gateway.tld/gw/'
+      #
+      #
+      # The syntax of the helper is as follows:
+      #   <% payment_service_for order_id, account_id,
+      #     :amount => 50.00,
+      #     :service => :swedbank_est do |service| %>
+      #
+      #     <% service.notify_url url_for(:action => 'notify', :only_path => false) %>
+      #     <% service.cancel_return_url 'http://mystore.com' %>
+      #   <% end %>
+      #
+      # The order_id parameter is a random id referencing the transaction (VK_STAMP)
+      # The account_id parameter is a id given to you from the bank (VK_SND_ID)
+      # The notify_url is the URL that the bank will send its responses.
+      #
+      # You can handle the notification in
+      # your controller action as follows:
+      #
+      #   class NotificationController < ApplicationController
+      #     include ActiveMerchant::Billing::Integrations
+      #
+      #     def notify
+      #       # Notification class is automatically fetched based on the request parameters.
+      #       notify = Pizza::Notification.get_notification(params)
+      #
+      #       if notify.acknowledge
+      #         ... process order ... if notify.complete?
+      #       else
+      #         ... log possible hacking attempt ...
+      #       end
+      #     end
+      #   end
+
+      module SwedbankEst
+
+        # Raw X509 certificate of the bank, string format.
+        mattr_accessor :bank_certificate
+        mattr_accessor :test_bank_certificate
+        # RSA public key of the bank, taken from the X509 certificate of the bank. OpenSSL container.
+        def self.get_bank_public_key
+          if ActiveMerchant::Billing::Base.integration_mode == :production
+            cert = self.bank_certificate
+          else
+            cert = self.test_bank_certificate
+          end
+          OpenSSL::X509::Certificate.new(cert.gsub(/  /, '')).public_key
+        end
+
+        mattr_accessor :private_key
+        mattr_accessor :test_private_key
+        # Our RSA private key. OpenSSL container.
+        def self.get_private_key
+          if ActiveMerchant::Billing::Base.integration_mode == :production
+            private_key = self.private_key
+          else
+            private_key = self.test_private_key
+          end
+          OpenSSL::PKey::RSA.new(private_key.gsub(/  /, ''))
+        end
+
+        mattr_accessor :test_url
+        mattr_accessor :production_url
+        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.notification(post)
+          Notification.new(post)
+        end
+
+      end
+    end
+  end
+end

data/lib/activemerchant_banklink/version.rb

@@ -0,0 +1,3 @@
+module ActivemerchantBanklink
+  VERSION = "0.0.1"
+end

data/lib/activemerchant_banklink.rb

@@ -0,0 +1,5 @@
+require 'active_merchant'
+require 'active_merchant/billing/integrations/pizza'
+require 'active_merchant/billing/integrations/swedbank_est'
+require 'active_merchant/billing/integrations/seb_est'
+require 'active_merchant/billing/integrations/sampo_est'

data/test/test_helper.rb

@@ -0,0 +1,182 @@
+#!/usr/bin/env ruby
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'activemerchant_banklink'
+require 'rubygems'
+require 'money'
+require 'test/unit'
+require 'mocha'
+require 'yaml'
+
+begin
+  gem 'actionpack'
+rescue LoadError
+  raise StandardError, "The view tests need ActionPack installed as gem to run"
+end
+
+require 'action_controller'
+require 'action_controller/test_process'
+require 'active_merchant/billing/integrations/action_view_helper'
+
+ActiveMerchant::Billing::Base.mode = :test
+
+# Test gateways
+class SimpleTestGateway < ActiveMerchant::Billing::Gateway
+end
+
+class SubclassGateway < SimpleTestGateway
+end
+
+
+module ActiveMerchant
+  module Assertions
+    def assert_field(field, value)
+      clean_backtrace do 
+        assert_equal value, @helper.fields[field]
+      end
+    end
+    
+    # Allows the testing of you to check for negative assertions: 
+    # 
+    #   # Instead of
+    #   assert !something_that_is_false
+    # 
+    #   # Do this
+    #   assert_false something_that_should_be_false
+    # 
+    # An optional +msg+ parameter is available to help you debug.
+    def assert_false(boolean, message = nil)
+      message = build_message message, '<?> is not false or nil.', boolean
+    
+      clean_backtrace do
+        assert_block message do
+          not boolean
+        end
+      end
+    end
+    
+    # A handy little assertion to check for a successful response: 
+    # 
+    #   # Instead of
+    #   assert_success response
+    # 
+    #   # DRY that up with
+    #   assert_success response
+    # 
+    # A message will automatically show the inspection of the response 
+    # object if things go afoul.
+    def assert_success(response)
+      clean_backtrace do
+        assert response.success?, "Response failed: #{response.inspect}"
+      end
+    end
+    
+    # The negative of +assert_success+
+    def assert_failure(response)
+      clean_backtrace do
+        assert_false response.success?, "Response expected to fail: #{response.inspect}"
+      end
+    end
+    
+    def assert_valid(validateable)
+      clean_backtrace do
+        assert validateable.valid?, "Expected to be valid"
+      end
+    end
+    
+    def assert_not_valid(validateable)
+      clean_backtrace do
+        assert_false validateable.valid?, "Expected to not be valid"
+      end
+    end
+    
+    private
+    def clean_backtrace(&block)
+      yield
+    rescue Test::Unit::AssertionFailedError => e
+      path = File.expand_path(__FILE__)
+      raise Test::Unit::AssertionFailedError, e.message, e.backtrace.reject { |line| File.expand_path(line) =~ /#{path}/ }
+    end
+  end
+  
+  module Fixtures
+    HOME_DIR = RUBY_PLATFORM =~ /mswin32/ ? ENV['HOMEPATH'] : ENV['HOME'] unless defined?(HOME_DIR)
+    LOCAL_CREDENTIALS = File.join(HOME_DIR.to_s, '.active_merchant/fixtures.yml') unless defined?(LOCAL_CREDENTIALS)
+    DEFAULT_CREDENTIALS = File.join(File.dirname(__FILE__), 'fixtures.yml') unless defined?(DEFAULT_CREDENTIALS)
+    
+    private
+    def credit_card(number = '4242424242424242', options = {})
+      defaults = {
+        :number => number,
+        :month => 9,
+        :year => Time.now.year + 1,
+        :first_name => 'Longbob',
+        :last_name => 'Longsen',
+        :verification_value => '123',
+        :type => 'visa'
+      }.update(options)
+
+      Billing::CreditCard.new(defaults)
+    end
+    
+    def check(options = {})
+      defaults = {
+        :name => 'Jim Smith',
+        :routing_number => '244183602', 
+        :account_number => '15378535', 
+        :account_holder_type => 'personal', 
+        :account_type => 'checking', 
+        :number => '1'
+      }.update(options)
+      
+      Billing::Check.new(defaults)
+    end
+    
+    def address(options = {})
+      { 
+        :name     => 'Jim Smith',
+        :address1 => '1234 My Street',
+        :address2 => 'Apt 1',
+        :company  => 'Widgets Inc',
+        :city     => 'Ottawa',
+        :state    => 'ON',
+        :zip      => 'K1C2N6',
+        :country  => 'CA',
+        :phone    => '(555)555-5555',
+        :fax      => '(555)555-6666'
+      }.update(options)
+    end
+    
+    def all_fixtures
+      @@fixtures ||= load_fixtures
+    end
+    
+    def fixtures(key)
+      data = all_fixtures[key] || raise(StandardError, "No fixture data was found for '#{key}'")
+      
+      data.dup
+    end
+        
+    def load_fixtures
+      file = File.exists?(LOCAL_CREDENTIALS) ? LOCAL_CREDENTIALS : DEFAULT_CREDENTIALS
+      yaml_data = YAML.load(File.read(file))
+      symbolize_keys(yaml_data)
+    
+      yaml_data
+    end
+    
+    def symbolize_keys(hash)
+      return unless hash.is_a?(Hash)
+      
+      hash.symbolize_keys!
+      hash.each{|k,v| symbolize_keys(v)}
+    end
+  end
+end
+
+Test::Unit::TestCase.class_eval do
+  include ActiveMerchant::Billing
+  include ActiveMerchant::Assertions
+  include ActiveMerchant::Utils
+  include ActiveMerchant::Fixtures
+end

data/test/unit/integrations/notifications/seb_est_notification_test.rb

@@ -0,0 +1,87 @@
+require File.dirname(__FILE__) + '/../../../test_helper'
+
+# setup test rsa private key
+ActiveMerchant::Billing::Integrations::SebEst.test_private_key = <<EOF
+-----BEGIN RSA PRIVATE KEY-----
+MIICXAIBAAKBgQC+AROlXiRvi1T7Q9fAh0Lw73szAn26mqfKDqd6Bdplq3v+gVWC
+3v0+bgtfNakRE/UVYOxEA0z0viqRpKzPuNy8OstTMe8fFKs19NW8lBYik6NzJ4Bk
++B6VmovOm0nJLQJytXKiJyuHP9DqPOVmP8S+azzX7Uqzov1nxo9fvH7y2QIDAQAB
+AoGAFhbD9O6r57fYCloJxB01gBMnTHfWrBH8vbXUbJAvorA7+wuIKG3KHS7n7Yqs
+fArI7FJXRVTo5m8RPdtaJ9ADAT9rjAi3A17TaEueyJl+B/hjHYhsd8MeFhTb2fh0
+rY3F6diL8U/YDbiAIegnKO0zcc6ynJrsQZvzb6DlY/CLPe0CQQD3KXJzw1ZfJ1ts
+c370b/ZC1YrRURw41Q0I8ljYJ8EJw/ngVxrnCIsd43bRnOVp9guJrjTQRkhDC3Gn
+J2Y0+42LAkEAxMxmh7QY4nItBTS0fe1KCat4VDxhyxYEhZKlGDhxW75vNROrripB
+1ZfBsq5xkY2MM9R7WKmL7SpStrUPIvEVqwJBAOXA4ISd61cupbytrDEbNscv7Afh
+pyNpYOGVLmNYqQgj5c7WCcsD1RYmkRgPCe8y6czFZJDLFHdGVxLz+/16bTsCQC9J
+Ob2TnYMTkhO1JUU4tdh69e+vjoPgp3d80+Rs83fq2wey0UaI6saqryUC21Dw5OYz
+QOv92RxEVhmGibuIl/8CQCiYrzwlZJDlsKrWPZT0E8rzNmLZkhNHzYJP9S7x+FKk
+m3gFeXEBgzGn9UOd6xIAp0p7A1XVBN8XzDMa09gSOks=
+-----END RSA PRIVATE KEY-----
+EOF
+
+# setup bank public certificate, used for checking response params
+ActiveMerchant::Billing::Integrations::SebEst.test_bank_certificate = <<EOF
+-----BEGIN CERTIFICATE-----
+MIIDRTCCAq6gAwIBAgIBADANBgkqhkiG9w0BAQQFADB7MQswCQYDVQQGEwJFRTEO
+MAwGA1UECBMFSGFyanUxEDAOBgNVBAcTB1RhbGxpbm4xDDAKBgNVBAoTA0VZUDEL
+MAkGA1UECxMCSVQxDDAKBgNVBAMTA2EuYTEhMB8GCSqGSIb3DQEJARYSYWxsYXIu
+YWxsYXNAZXlwLmVlMB4XDTk5MTExNTA4MTAzM1oXDTk5MTIxNTA4MTAzM1owezEL
+MAkGA1UEBhMCRUUxDjAMBgNVBAgTBUhhcmp1MRAwDgYDVQQHEwdUYWxsaW5uMQww
+CgYDVQQKEwNFWVAxCzAJBgNVBAsTAklUMQwwCgYDVQQDEwNhLmExITAfBgkqhkiG
+9w0BCQEWEmFsbGFyLmFsbGFzQGV5cC5lZTCBnzANBgkqhkiG9w0BAQEFAAOBjQAw
+gYkCgYEAvgETpV4kb4tU+0PXwIdC8O97MwJ9upqnyg6negXaZat7/oFVgt79Pm4L
+XzWpERP1FWDsRANM9L4qkaSsz7jcvDrLUzHvHxSrNfTVvJQWIpOjcyeAZPgelZqL
+zptJyS0CcrVyoicrhz/Q6jzlZj/Evms81+1Ks6L9Z8aPX7x+8tkCAwEAAaOB2DCB
+1TAdBgNVHQ4EFgQUFivCzZNmegEoOxYtg20YMMRB98gwgaUGA1UdIwSBnTCBmoAU
+FivCzZNmegEoOxYtg20YMMRB98ihf6R9MHsxCzAJBgNVBAYTAkVFMQ4wDAYDVQQI
+EwVIYXJqdTEQMA4GA1UEBxMHVGFsbGlubjEMMAoGA1UEChMDRVlQMQswCQYDVQQL
+EwJJVDEMMAoGA1UEAxMDYS5hMSEwHwYJKoZIhvcNAQkBFhJhbGxhci5hbGxhc0Bl
+eXAuZWWCAQAwDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQQFAAOBgQBfkayuot+e
+fwW8QmPwpWF5AY3oMT/fTncjCljDBOg39IQv4PjnpTdDfwwl3lUIZHHTLM2i0L/c
+eD4D1UFM1qdp2VZzhBd1eeMjxYjCP8qL2v2MfLkCYcP30Sl6ISSkFjFc5qbGXZOc
+C82uR/wUZJDw9kj+R1O46/byG8yA+S9FVw==
+-----END CERTIFICATE-----
+EOF
+
+class SebEstNotificationTest < Test::Unit::TestCase
+  include ActiveMerchant::Billing::Integrations
+
+  def setup
+    @seb_est = Pizza::Notification.get_notification(http_raw_data)
+  end
+
+  def test_get_notification_class_from_pizza
+    notify_class = Pizza::Notification.get_notification(http_raw_data)
+    assert notify_class.is_a?(ActiveMerchant::Billing::Integrations::SebEst::Notification)
+  end
+
+  def test_accessors
+    assert_equal true, @seb_est.complete?
+    assert_equal 'Completed', @seb_est.status
+    assert_equal "88", @seb_est.item_id
+    assert_equal "2774", @seb_est.transaction_id
+    assert_equal '33', @seb_est.gross
+    assert_equal "EEK", @seb_est.currency
+    assert_equal '26.11.2007', @seb_est.received_at.strftime("%d.%m.%Y")
+    assert_equal true, @seb_est.test?
+  end
+
+  def test_compositions
+    assert_equal Money.new(3300, 'EEK'), @seb_est.amount
+  end
+
+  def test_acknowledgement
+    assert_equal true, @seb_est.acknowledge
+  end
+
+  def test_acknowledgement_fail_with_params_changed
+    @seb_est_wrong = Pizza::Notification.get_notification(http_raw_data.gsub('VK_AMOUNT=33', 'VK_AMOUNT=100'))
+    assert_equal false, @seb_est_wrong.acknowledge
+  end
+
+  private
+
+  def http_raw_data
+    "VK_SERVICE=1101&VK_VERSION=008&VK_SND_ID=EYP&VK_REC_ID=testvpos&VK_STAMP=88&VK_T_NO=2774&VK_AMOUNT=33&VK_CURR=EEK&VK_REC_ACC=10002050618003&VK_REC_NAME=ALLAS+ALLAR&VK_SND_ACC=10010046155012&VK_SND_NAME=t%C3%B5%C3%B5ger+%2C+Le%C3%B5p%C3%A4%C3%B6ld%C5%BE%C5%BD%C5%A1%C5%A0&VK_REF=123&VK_MSG=Porgandid&VK_T_DATE=26.11.2007&VK_MAC=LyCZRncu%2F%2BOi5nwzOkI6C9UMFohN6tSl3tLFyIJyNp2lGKBrDKZ2H8b%2BadU3XalzS7MwnAj8r%2FRhLpbsGNE5ysNyM4CKkSrsVzxoXbt9%2BB1foH9Rlp9LCeoR2H774f8UcMe9RVsE%2B%2BZfrEZzzXYyR1PXDCVOShQOAxlD9pbh8nk%3D&VK_LANG=EST&VK_RETURN=http%3A%2F%2F90.190.110.154%2Fseb_est%2Fnotify&VK_AUTO=N&VK_CHARSET=UTF-8&keel=EST&appname=UN3MIN&act=UPOSTEST2"
+  end
+end

data/test/unit/integrations/sampo_est_module_test.rb

@@ -0,0 +1,9 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+class SampoEstModuleTest < Test::Unit::TestCase
+  include ActiveMerchant::Billing::Integrations
+
+  def test_notification_method
+    assert_instance_of SampoEst::Notification, SampoEst.notification({'name' => 'cody'})
+  end
+end

data/test/unit/integrations/seb_est_module_test.rb

@@ -0,0 +1,9 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+class SebEstModuleTest < Test::Unit::TestCase
+  include ActiveMerchant::Billing::Integrations
+
+  def test_notification_method
+    assert_instance_of SebEst::Notification, SebEst.notification({'name' => 'cody'})
+  end
+end

data/test/unit/integrations/swedbank_est_module_test.rb

@@ -0,0 +1,9 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+class SwedbankEstModuleTest < Test::Unit::TestCase
+  include ActiveMerchant::Billing::Integrations
+
+  def test_notification_method
+    assert_instance_of SwedbankEst::Notification, SwedbankEst.notification({'name' => 'cody'})
+  end
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification 
+name: activemerchant_banklink
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Indrek Juhkam
+- Laurynas Butkus
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-29 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Adds Banklink support to ActiveMerchant library. Banklink is provided by major banks in the Baltic states.
+email: 
+- laurynas.butkus@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- activemerchant_banklink.gemspec
+- init.rb
+- lib/active_merchant/billing/integrations/pizza.rb
+- lib/active_merchant/billing/integrations/pizza/helper.rb
+- lib/active_merchant/billing/integrations/pizza/notification.rb
+- lib/active_merchant/billing/integrations/sampo_est.rb
+- lib/active_merchant/billing/integrations/sampo_est/helper.rb
+- lib/active_merchant/billing/integrations/sampo_est/notification.rb
+- lib/active_merchant/billing/integrations/seb_est.rb
+- lib/active_merchant/billing/integrations/seb_est/helper.rb
+- lib/active_merchant/billing/integrations/seb_est/notification.rb
+- lib/active_merchant/billing/integrations/swedbank_est.rb
+- lib/active_merchant/billing/integrations/swedbank_est/helper.rb
+- lib/active_merchant/billing/integrations/swedbank_est/notification.rb
+- lib/activemerchant_banklink.rb
+- lib/activemerchant_banklink/version.rb
+- test/test_helper.rb
+- test/unit/integrations/notifications/seb_est_notification_test.rb
+- test/unit/integrations/sampo_est_module_test.rb
+- test/unit/integrations/seb_est_module_test.rb
+- test/unit/integrations/swedbank_est_module_test.rb
+has_rdoc: true
+homepage: http://github.com/laurynas/activemerchant_banklink
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: activemerchant_banklink
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: ActiveMerchant Banklink add-on (alpha version)
+test_files: []
+