ipizza 0.7.1 → 2.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 160c73db6da0b92bb8d59f3478ae2836a8efdfe57cbfe174a0715559a980273a
+  data.tar.gz: 40486a43f105c5ee73fb7d3f4e827124f7bff5cb8fb1bfa93c2fca677c06f9c7
+SHA512:
+  metadata.gz: 173c0fd63f8e5c43c099a9871005db2bc83272455eb56c10c9c01fabb4a2ab2c42925d490f9608332aca2916ef172ef81bc204ae9f211d9a357a3a4989581f43
+  data.tar.gz: b702c29a1c3ccf89a46a10828c3911ab9d7d9880d43e79387ff4e5cd6284aabe83dcb81c28f65c19f484550f018c2fb93261b0e7a7939ed04c587a76a00ed2be

data/.gitignore

@@ -1,2 +1,4 @@
 .DS_Store
-pkg
+pkg
+.ruby-gemset
+.ruby-version

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+## v2.0.0
+
+* Added support for iPizza services (`1011`, `1012`, `4011` and `4012`). Read more form [Estonian Banking Association webpage](http://pangaliit.ee/et/arveldused/pangalingi-spetsifikatsioon)
+* Changed MAC calculation in case of UTF-8 encoding to support new iPizza protocol.
+* Added supported encodings to Provider model (`UTF-8` (default), `ISO-8859-1` and `WINDOWS-1257`).
+* Added 'transaction_time' attribute to `Ipizza::Payment` object (parsed value of the `VK_T_DATETIME` field).
+* Removed support for iPizza services (`1001`, `1002`, `4001` and `4002`).
+* Added new provider: LHV Bank.
+* Authentication request response method `authentication_info` returns now `Ipizza::Authentication` object instead of string.

data/Gemfile

@@ -1,2 +1,2 @@
-source "http://rubygems.org"
+source 'http://rubygems.org'
 gemspec

data/Gemfile.lock

@@ -1,38 +1,41 @@
 PATH
   remote: .
   specs:
-    ipizza (0.7.1)
+    ipizza (2.0.1)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    coderay (1.0.8)
-    diff-lcs (1.1.2)
-    guard (1.6.1)
+    coderay (1.1.0)
+    diff-lcs (1.1.3)
+    formatador (0.2.5)
+    guard (1.7.0)
+      formatador (>= 0.2.4)
       listen (>= 0.6.0)
       lumberjack (>= 1.0.2)
       pry (>= 0.9.10)
       thor (>= 0.14.6)
-    guard-rspec (1.1.0)
+    guard-rspec (1.2.1)
       guard (>= 1.1)
-    listen (0.7.1)
-    lumberjack (1.0.2)
-    method_source (0.8.1)
-    pry (0.9.10)
-      coderay (~> 1.0.5)
-      method_source (~> 0.8)
-      slop (~> 3.3.1)
-    rb-fsevent (0.9.1)
-    rspec (2.6.0)
-      rspec-core (~> 2.6.0)
-      rspec-expectations (~> 2.6.0)
-      rspec-mocks (~> 2.6.0)
-    rspec-core (2.6.2)
-    rspec-expectations (2.6.0)
-      diff-lcs (~> 1.1.2)
-    rspec-mocks (2.6.0)
-    slop (3.3.3)
-    thor (0.16.0)
+    listen (0.7.3)
+    lumberjack (1.0.9)
+    method_source (0.8.2)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rake (10.3.1)
+    rb-fsevent (0.9.4)
+    rspec (2.9.0)
+      rspec-core (~> 2.9.0)
+      rspec-expectations (~> 2.9.0)
+      rspec-mocks (~> 2.9.0)
+    rspec-core (2.9.0)
+    rspec-expectations (2.9.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.9.0)
+    slop (3.6.0)
+    thor (0.19.1)
 
 PLATFORMS
   ruby
@@ -40,5 +43,6 @@ PLATFORMS
 DEPENDENCIES
   guard-rspec
   ipizza!
+  rake
   rb-fsevent
-  rspec (~> 2.6.0)
+  rspec (~> 2.9.0)

data/Guardfile

@@ -1,5 +1,5 @@
-guard 'rspec', :version => 2, :cli => "--color", :bundler => true, :all_on_start => false, :all_after_pass => false, :keep_failed => true, :notification => false do
-  watch('spec/spec_helper.rb') { "spec" }
+guard 'rspec', version: 2, cli: '--color', bundler: true, all_on_start: false, all_after_pass: false, keep_failed: true, notification: false do
+  watch('spec/spec_helper.rb') { 'spec' }
   watch(%r{^spec/.+_spec\.rb})
   watch(%r{^lib/(.+)\.rb}) { |m| "spec/lib/#{m[1]}_spec.rb" }
 end

data/README.markdown

@@ -1,11 +1,19 @@
 Implements iPizza protocol to communicate with Estonian Banks.
 
+Gem implements support for iPizza services (`1011`, `1012`, `4011` and `4012`) that are supported by members of the Estonian Banking Association [since October 2014](http://pangaliit.ee/et/arveldused/pangalingi-spetsifikatsioon).
+
+If you need to use this gem with old iPizza services implementations (`1001`, `1002`, `4001` and `4002`), use 1.0.0 version of this gem (NB! support for these services will end on 31 December 2015).
+
 # Usage
 
 Add gem dependency in your `Gemfile` and install the gem:
 
     gem 'ipizza'
 
+## Ruby 1.8 support
+
+Since ipizza gem version 1.0.0, Ruby 1.8 support has been dropped. If you need to use this gem with older versions of Ruby, use 0.7.1 version of this gem.
+
 # Configuration
 
 Configuration can be made in two different ways, using `Ipizza::Config.configure` block or loading configuration properties from YAML file.
@@ -42,9 +50,7 @@ At any time, configuration can be modified with `Ipizza::Config.configure` block
       # relatively to YAML file
       file_cert: ./certificates/bank_public.crt
       snd_id: dealer
-      encoding: ISO-8859-4
-
-Please note that currently only ISO-8859-4 encoding is supported with Swedbank. UTF-8 works well with other payment providers.
+      encoding: UTF-8
 
 ## Payment requests
 
@@ -71,14 +77,16 @@ Please note that currently only ISO-8859-4 encoding is supported with Swedbank.
 
 This library currently works with four Estonian Banks. Here are their respective interface specifications:
 
-* [Swedbank](https://www.swedbank.ee/static/pdf/business/d2d/paymentcollection/info_banklink_techspec_est.pdf)
+* [Swedbank](https://www.swedbank.ee/business/cash/ecommerce/banklink/description?language=EST)
 * [SEB](http://www.seb.ee/ari/maksete-kogumine/maksete-kogumine-internetis/tehniline-spetsifikatsioon)
-* [Sampo](http://www.sampopank.ee/et/14732.html)
-* [Krediidipank](http://www.krediidipank.ee/business/settlements/bank-link/tehniline_kirjeldus.pdf)
-* [Nordea](http://www.nordea.ee/Teenused+ärikliendile/E-lahendused/787802.html)
+* [Danske Bank](http://www.danskebank.ee/et/14732.html)
+* [Krediidipank](http://www.krediidipank.ee/business/settlements/bank-link/index.html)
+* [LHV Bank](https://www.lhv.ee/pangateenused/pangalink/)
+* [Nordea](http://www.nordea.ee/Teenused+%C3%A4rikliendile/Igap%C3%A4evapangandus/Maksete+kogumine/E-makse/1562142.html) (*uses SOLO protocol*)
 
 # Helpful links
 
+* [pangalink.net](https://pangalink.net/et/info)
 * [Repository](http://github.com/priithaamer/ipizza)
 * [Issue tracker](http://github.com/priithaamer/ipizza/issues)
 

data/Rakefile

@@ -7,4 +7,4 @@ Bundler::GemHelper.install_tasks
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/ipizza.gemspec

@@ -1,23 +1,24 @@
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "ipizza/version"
+$:.push File.expand_path('../lib', __FILE__)
+require 'ipizza/version'
 
 Gem::Specification.new do |s|
-  s.name        = "ipizza"
+  s.name        = 'ipizza'
   s.version     = Ipizza::VERSION
   s.platform    = Gem::Platform::RUBY
-  s.authors     = ["Priit Haamer"]
-  s.email       = ["priit@fraktal.ee"]
-  s.homepage    = "http://github.com/priithaamer/ipizza"
-  s.summary     = %q{Implements iPizza protocol to communicate with Estonian Banks}
-  s.description = %q{Simplifies generating payment requests and parsing responses from banks when using iPizza protocol.}
-  
-  s.add_development_dependency 'rspec', '~> 2.6.0'
+  s.authors     = ['Priit Haamer', 'Tanel Jakobsoo']
+  s.email       = ['priit@voog.com', 'tanel@voog.com']
+  s.homepage    = 'https://github.com/Voog/ipizza'
+  s.summary     = 'Implements iPizza protocol to communicate with Estonian Banks'
+  s.description = 'Simplifies generating payment requests and parsing responses from banks when using iPizza protocol.'
+
+  s.add_development_dependency 'rspec', '~> 2.9.0'
   s.add_development_dependency 'guard-rspec'
   s.add_development_dependency 'rb-fsevent'
+  s.add_development_dependency 'rake'
 
   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"]
+  s.require_paths = ['lib']
 end

data/lib/ipizza/authentication.rb

@@ -0,0 +1,15 @@
+module Ipizza
+  class Authentication
+    
+    attr_accessor :provider, :user, :message_time, :sender_id, :receiver_id, :user_name, :user_id, :country, :other, :authentication_identifier, :request_identifier
+    
+    def initialize(attribs = {})
+      attribs.each do |key, value|
+        if self.respond_to?("#{key.to_s}=".to_sym)
+          v = key.to_sym == :message_time && value.is_a?(String) ? Time.parse(value) : value
+          self.send("#{key.to_s}=".to_sym, v)
+        end
+      end
+    end
+  end
+end

data/lib/ipizza/authentication_request.rb

@@ -1,4 +1,4 @@
 module Ipizza
   class AuthenticationRequest < Ipizza::Request
   end
-end
+end

data/lib/ipizza/authentication_response.rb

@@ -2,23 +2,36 @@ module Ipizza
   class AuthenticationResponse < Ipizza::Response
     
     def success?
-      return ['3002'].include?(@params['VK_SERVICE'])
+      %w(3012 3013).include?(@params['VK_SERVICE'])
     end
     
     def valid?
-      return @valid
-    end
-
-    def authentication_info
-      @params['VK_INFO']
+      @valid
     end
     
     def info_social_security_id
-      /ISIK:([^;.]+)/i.match(@params['VK_INFO'])[1] if @params['VK_INFO']
+      authentication_info.user_id
     end
     
     def info_name
-      /NIMI:([^;.]+)/.match(@params['VK_INFO'])[1] if @params['VK_INFO']
+      authentication_info.user_name
+    end
+
+    def authentication_info
+      @authentication_info ||= Ipizza::Authentication.new(
+        provider: @params['VK_SND_ID'],
+        user: @params['VK_USER'],
+        message_time: @params['VK_DATETIME'],
+        sender_id: @params['VK_SND_ID'],
+        receiver_id: @params['VK_REC_ID'],
+        user_name: @params['VK_USER_NAME'],
+        user_id: @params['VK_USER_ID'],
+        country: @params['VK_COUNTRY'],
+        other: @params['VK_OTHER'],
+        authentication_identifier: @params['VK_TOKEN'],
+        request_identifier: @params['VK_RID'],
+        nonce: @params['VK_NONCE']
+      )
     end
   end
-end
+end

data/lib/ipizza/config.rb

@@ -8,10 +8,10 @@ module Ipizza
 
       def load_from_file(yaml_path)
         @certs_root = File.dirname(yaml_path)
-        
+
         load_from_hash(YAML::load_file(yaml_path))
       end
-      
+
       def load_from_hash(config)
         config.each do |bank, params|
           params.each do |param, value|
@@ -21,19 +21,19 @@ module Ipizza
           end
         end
       end
-      
+
       def configure
         yield self
       end
-      
+
       def method_missing(m, *args)
-        if /^(swedbank|seb|sampo|krediidipank|nordea)_(.*)=$/ =~ m.to_s
+        if /^(lhv|swedbank|seb|sampo|krediidipank|nordea|luminor)_(.*)=$/ =~ m.to_s
           clz = Ipizza::Provider.const_get($1.capitalize)
           key = $2
           value = args.first
-          
+
           value = load_certificate(value) if /^file_(cert|key)/ =~ key
-          
+
           if clz.respond_to?(:"#{key}=")
             return clz.send(:"#{key}=", *[value])
           end
@@ -41,23 +41,23 @@ module Ipizza
 
         super
       end
-      
+
       private
-      
+
       def load_certificate(file_path)
-        if File.exists?(file_path)
+        if File.exist?(file_path)
           file_path
         else
           file_path = File.expand_path(File.join(certs_root, file_path))
         end
-        
-        if File.exists?(file_path)
+
+        if File.exist?(file_path)
           file_path
         else
           raise "Could not load certificate from file '#{file_path}'"
         end
       end
-      
+
     end
   end
 end

data/lib/ipizza/payment.rb

@@ -1,15 +1,15 @@
 module Ipizza
   class Payment
     
-    attr_accessor :stamp, :amount, :currency, :refnum, :receiver_account, :receiver_name, :sender_account, :sender_name, :message, :transaction_id
+    attr_accessor :provider, :stamp, :amount, :currency, :refnum, :receiver_account, :receiver_name, :sender_account, :sender_name, :message, :transaction_id, :transaction_time
     
     def initialize(attribs = {})
       attribs.each do |key, value|
         if self.respond_to?("#{key.to_s}=".to_sym)
-          self.send("#{key.to_s}=".to_sym, value)
+          v = key.to_sym == :transaction_time && value.is_a?(String) ? Time.parse(value) : value
+          self.send("#{key.to_s}=".to_sym, v)
         end
       end
     end
-
   end
-end
+end

data/lib/ipizza/payment_request.rb

@@ -1,4 +1,4 @@
 module Ipizza
   class PaymentRequest < Ipizza::Request
   end
-end
+end

data/lib/ipizza/payment_response.rb

@@ -1,23 +1,31 @@
 class Ipizza::PaymentResponse < Ipizza::Response
 
   def success?
-    return ['1101'].include?(@params['VK_SERVICE'])
+    %w(1111).include?(@params['VK_SERVICE'])
   end
   
   def valid?
-    return @valid
+    @valid
   end
   
   def automatic_message?
-    @params['VK_AUTO'] and @params['VK_AUTO'] == 'Y'
+    @params['VK_AUTO'] == 'Y'
   end
   
   def payment_info
     @payment_info ||= Ipizza::Payment.new(
-      :stamp => @params['VK_STAMP'], :amount => @params['VK_AMOUNT'], :currency => @params['VK_CURR'],
-      :refnum => @params['VK_REF'], :message => @params['VK_MSG'], :transaction_id => @params['VK_T_NO'],
-      :receiver_account => @params['VK_REC_ACC'], :receiver_name => @params['VK_REC_NAME'],
-      :sender_account => @params['VK_SND_ACC'], :sender_name => @params['VK_SND_NAME']
+      provider: @params['VK_SND_ID'],
+      stamp: @params['VK_STAMP'],
+      amount: @params['VK_AMOUNT'],
+      currency: @params['VK_CURR'],
+      refnum: @params['VK_REF'],
+      message: @params['VK_MSG'],
+      transaction_id: @params['VK_T_NO'],
+      receiver_account: @params['VK_REC_ACC'],
+      receiver_name: @params['VK_REC_NAME'],
+      sender_account: @params['VK_SND_ACC'],
+      sender_name: @params['VK_SND_NAME'],
+      transaction_time: @params['VK_T_DATETIME']
     )
   end
 end

data/lib/ipizza/provider/base.rb

@@ -0,0 +1,90 @@
+module Ipizza::Provider
+  class Base
+
+    SUPPORTED_ENCODINGS = %w(UTF-8 ISO-8859-1 WINDOWS-1257)
+
+    class << self
+      attr_accessor :service_url, :return_url, :cancel_url, :file_key, :key_secret, :file_cert, :snd_id, :rec_id, :rec_acc, :rec_name, :encoding, :lang
+    end
+
+    def payment_request(payment, service_no = 1012)
+      req = Ipizza::PaymentRequest.new
+      req.service_url = self.class.service_url
+      req.sign_params = {
+        'VK_SERVICE' => service_no,
+        'VK_VERSION' => '008',
+        'VK_SND_ID' => self.class.snd_id,
+        'VK_STAMP' => payment.stamp,
+        'VK_AMOUNT' => sprintf('%.2f', payment.amount),
+        'VK_CURR' => payment.currency,
+        'VK_REF' => Ipizza::Util.sign_731(payment.refnum),
+        'VK_MSG' => payment.message,
+        'VK_RETURN' => self.class.return_url,
+        'VK_CANCEL' => self.class.cancel_url,
+        'VK_DATETIME' => Ipizza::Util.time_to_iso8601(Time.now)
+      }
+
+      if service_no.to_s == '1011'
+        req.sign_params['VK_ACC'] = self.class.rec_acc
+        req.sign_params['VK_NAME'] = self.class.rec_name
+      end
+
+      req.extra_params = {
+        'VK_ENCODING' => get_encoding(self.class.encoding),
+        'VK_LANG' => self.class.lang
+      }
+
+      req.sign(self.class.file_key, self.class.key_secret, Ipizza::Request::PARAM_ORDER[service_no.to_s])
+      req
+    end
+
+    def payment_response(params)
+      response = Ipizza::PaymentResponse.new(params)
+      response.verify(self.class.file_cert)
+      response
+    end
+
+    def authentication_request(service_no = 4011, param = {})
+      req = Ipizza::AuthenticationRequest.new
+      req.service_url = self.class.service_url
+      req.sign_params = {
+        'VK_SERVICE' => service_no,
+        'VK_VERSION' => '008',
+        'VK_SND_ID' => self.class.snd_id,
+        'VK_RETURN' => self.class.return_url,
+        'VK_DATETIME' => Ipizza::Util.time_to_iso8601(Time.now),
+        'VK_RID' => param[:vk_rid]
+      }
+
+      case service_no.to_s
+      when '4011'
+        req.sign_params['VK_REPLY'] = '3012'
+      when '4012'
+        req.sign_params.merge(
+          'VK_REC_ID' => self.class.rec_id,
+          'VK_NONCE' => param[:vk_nonce]
+        )
+      end
+
+      req.extra_params = {
+        'VK_ENCODING' => get_encoding(self.class.encoding),
+        'VK_LANG' => self.class.lang
+      }
+
+      req.sign(self.class.file_key, self.class.key_secret, Ipizza::Request::PARAM_ORDER[service_no.to_s])
+      req
+    end
+
+    def authentication_response(params)
+      response = Ipizza::AuthenticationResponse.new(params)
+      response.verify(self.class.file_cert)
+      response
+    end
+
+    private
+
+    def get_encoding(val)
+      SUPPORTED_ENCODINGS.include?(val.to_s.upcase) ? val.to_s.upcase : 'UTF-8'
+    end
+  end
+end