lolita-first-data 1.0.0

data/app/models/lolita/first_data/transaction.rb

@@ -0,0 +1,55 @@
+module Lolita::FirstData
+  class Transaction < ActiveRecord::Base
+    set_table_name :first_data_transactions
+    belongs_to :paymentable, :polymorphic => true
+    after_save :touch_paymentable
+    
+    def ip
+      IPAddr.new(self[:ip], Socket::AF_INET).to_s
+    end
+
+    def ip=(x)
+      self[:ip] = IPAddr.new(x).to_i
+    end
+
+    def process_answer rs, gateway, request
+      self.status = (rs.success?) ? 'completed' : 'rejected'
+      self.transaction_code = rs.params['RESULT_CODE']
+      begin
+        self.save!
+      rescue Exception => e
+        fdp_error = "#{e.to_s}\n\n#{$@.join("\n")}"
+        if rs.success?
+          begin
+            gateway.reverse(fdp.transaction_id,fdp.paymentable.price)            
+          rescue Exception => reverse_exception
+            reverse_error = "#{reverse_exception.to_s}\n\n#{$@.join("\n")}"
+            ExceptionNotifier::Notifier.exception_notification(request.env, reverse_exception).deliver if defined?(ExceptionNotifier)
+            gateway.log :error, reverse_error
+          end
+        end
+        ExceptionNotifier::Notifier.exception_notification(request.env, e).deliver if defined?(ExceptionNotifier)
+        gateway.log :error, fdp_error
+        false
+      end
+    end
+
+    # add new transaction in Checkout
+    def self.add payment, request, rs
+      Lolita::FirstData::Transaction.create!(
+        :transaction_id => rs.params['TRANSACTION_ID'],
+        :status => 'processing',
+        :paymentable_id => payment.id,
+        :paymentable_type => payment.class.to_s,
+        :ip => request.remote_ip
+      )      
+    end
+
+    private
+    
+    # trigger "fd_trx_saved" on our paymentable model
+    def touch_paymentable
+      paymentable.fd_trx_saved(self) if paymentable
+    end
+  end
+end

data/config/locales/en.yml

@@ -0,0 +1,109 @@
+en:
+  fd:
+    unknown_error: Unknown error
+    no_trans_id: No transaction ID
+    wrong_request: Wrong request
+    purchase_failed: "Failed to create a payment, please try again."
+    response:
+      code_914: "Rejected, can not return to\n  original transaction"
+      code_003: "Confirmed VIP"
+      code_102: "Rejected, possible fraud detected"
+      code_201: "Take away, card expired"
+      code_300: "Status message: file action successful"
+      code_123: "Rejected, exceeded money\n  issue frequency limit"
+      code_XXX: "Code to be replaced by card status code or stoplist insertion reason code"
+      code_915: "Rejected, reconciliation reconnection\n  or checkpoint error"
+      code_004: "Confirmed, corrected 3rd path"
+      code_103: "Rejected, card holder is\n  required to contact receiver bank"
+      code_202: "Take away, possible fraud detected"
+      code_301: "Status message: file action not supported by receiver"
+      code_400: "Confirmed (For reservation)"
+      code_124: "Rejected, violation of the law"
+      code_916: "Rejected, incorrect MAC"
+      code_005: "Accepted, account is selected\n  by card issuer"
+      code_104: "Rejected, card has limits"
+      code_203: "Take away, card holder is\n  required to contact receiver bank"
+      code_302: "Status message: unable to locate record on file"
+      code_500: "Status message: reconciled, in balance"
+      code_125: "Rejected, card is not valid"
+      code_917: "Rejected, MAC key\n  synchronization error"
+      code_600: "Accepted (Administrative info)"
+      code_126: "Rejected, incorrect PIN"
+      code_006: "Accepted for partial sum, account\n  type selected by card issuer"
+      code_105: "Rejected, card receiver is required\n  to call the security department of the issuer bank"
+      code_204: "Take away, card with limits"
+      code_303: "Status message: duplicate record, old record replaced"
+      code_501: "Status message: reconciled, out of balance"
+      code_700: "Confirmed (commission collection)"
+      code_601: "Status message: impossible to trace back original transaction"
+      code_007: "Confirmed, corrected ICC"
+      code_106: "Rejected, PIN entry retry\n  count exceeded"
+      code_205: "Take away, card receiver is required\n  to call the security department of the issuer bank"
+      code_304: "Status message: file record field edit error"
+      code_502: "Status message: amount not reconciled, totals provided"
+      code_127: "Rejected, PIN too long"
+      code_920: "Rejected, security software\n  error, try again"
+      code_918: "Rejected, no\n  usable transport keys "
+      code_800: "Confirmed (Network management)"
+      code_602: "Status message: invalid transaction reference number"
+      code_107: "Rejected, contact\n  card issuer bank"
+      code_206: "Take away, PIN entry\n  retry count exceeded"
+      code_305: "Status message: file locked out"
+      code_503: "Status message: totals for reconciliation not available"
+      code_128: "Rejected, PIN key synchronization error"
+      code_921: "Rejected, security software error"
+      code_919: "Rejected, encryption key\n  synchronization error"
+      code_900: "Message accepted, accept without\n  financial responsibility"
+      code_603: "Status message: reference number/PAN incompatible"
+      code_108: "Rejected, contact card\n  issuer bank, special conditions apply"
+      code_207: "Take away, special conditions apply"
+      code_306: "Status message: file action not successful"
+      code_504: "Status message: not reconciled, totals provided"
+      code_129: "Rejected, suspected counterfeit card"
+      code_922: "Rejected, message number\n  does not comply with the order"
+      code_901: "Message accepted, accept with\n  financial responsibility"
+      code_604: "Status message: POS photograph is not available"
+      code_110: "Rejected, incorrect amount"
+      code_109: "Rejected, incorrect merchant"
+      code_208: "Take away, lost card"
+      code_307: "Status message: file data format error"
+      code_923: "Request is being processed"
+      code_902: "Rejected, incorrect transaction"
+      code_605: "Status message: requested item supplied"
+      code_111: "Rejected, incorrect card number"
+      code_210: "Take away, suspected counterfeit card"
+      code_209: "Take away, card stolen"
+      code_308: "Status message: duplicate record, new record rejected"
+      code_903: "Enter transaction again"
+      code_606: "Status message: request cannot be\n  fulfilled - required documentation is not available"
+      code_112: "Rejected, PIN required"
+      code_309: "Status message: unknown file"
+      code_197: "Rejected, call AMEX"
+      code_904: "Rejected, format error"
+      code_113: "Rejected, unacceptable commission"
+      code_198: "Rejected, contact card processing center"
+      code_905: "Rejected, receiving bank has no connection"
+      code_114: "Rejected, account type not requested"
+      code_906: "Rejected, currently switching"
+      code_115: "Rejected, requested function\n  not supported"
+      code_950: "Rejected, business agreement breach"
+      code_116: "Rejected, insufficient funds"
+      code_907: "Rejected, issuer bank or connection\n  not working"
+      code_117: "Rejected, incorrect PIN"
+      code_910: "Rejected, card issuer bank turned off"
+      code_908: "Rejected, transaction addressee\n  not found"
+      code_118: "Rejected, card entry not found"
+      code_911: "Rejected, kartes izdevējbanka\n  laicīgi nesniedz atbildi"
+      code_909: "Rejected, system malfunction"
+      code_000: "Confirmed"
+      code_120: "Rejected, transaction not allowed\n  for terminal"
+      code_119: "Rejected, transaction not allowed\n  for card user"
+      code_912: "Rejected, can not connect to\n  card issuer bank"
+      code_001: "Confirmed, if identity can be approved"
+      code_100: "Rejected (General, without specification)"
+      code_121: "Rejected, exceeded monet\n  issue limit"
+      code_913: "Rejected, double transmission"
+      code_002: "Confirmed for partial amount"
+      code_101: "Rejected, card expired"
+      code_200: "Take away card (General, without specification)"
+      code_122: "Rejected, security breach"

data/config/locales/lv.yml

@@ -0,0 +1,109 @@
+lv:
+  fd:
+    unknown_error: nezināma kļūda
+    no_trans_id: Nav transakcijas ID
+    wrong_request: Nepareizs pieprasījums
+    purchase_failed: "Neizdevās izveidot maksājumu, lūdzu mēģiniet vēlreiz."
+    response:
+      code_914: "Atteikts, nevar atgriezties pie\n  oriģinālās transakcijas"
+      code_003: "Apstirināts VIP"
+      code_102: "Atteikts, aizdomas par krāpniecību"
+      code_201: "Atņemt, beidzies kartes derīguma termiņš"
+      code_300: "Status message: file action successful"
+      code_123: "Atteikts, pārsniegts naudas\n  izdošanas biežuma limits"
+      code_XXX: "Code to be replaced by card status code or stoplist insertion reason code"
+      code_915: "Atteikts, rekonsilācijas pārslēgšana\n  vai kontrolpunkta kļūda"
+      code_004: "Apstiprināts, koriģēts 3 celiņš"
+      code_103: "Atteikts, kartes pieņēmējam\n  jāsazinās ar pieņēmējbanku"
+      code_202: "Atņemt, aizdomas par krāpšanu"
+      code_301: "Status message: file action not supported by receiver"
+      code_400: "Apstiprināts (Reversēšanai)"
+      code_124: "Atteikts, likuma pārkāpums"
+      code_916: "Atteikts, nepareizs MAC"
+      code_005: "Apstiprināts, konta tipu norāda\n  kartes izdevējs"
+      code_104: "Atteiks, karte ar ierobežojumu"
+      code_203: "Atņemt, kartes pieņēmējam jāsazinās\n  ar pieņēmējbanku"
+      code_302: "Status message: unable to locate record on file"
+      code_500: "Status message: reconciled, in balance"
+      code_125: "Atteikts, karte nav derīga"
+      code_917: "Atteikts, MAC atslēgu\n  sinhronizācijas kļūda"
+      code_600: "Apstiprināts (Administratīvais info)"
+      code_126: "Atteikts, nepareizs PIN bloks"
+      code_006: "Apstiprināts par daļēju summu, konta\n  tipu norāda kartes izdevējs"
+      code_105: "Atteikts, kartes pieņēmējam jāzvana\n  izdevējbankas drošības departamentam"
+      code_204: "Atņemt, karte ar ierobežojumiem"
+      code_303: "Status message: duplicate record, old record replaced"
+      code_501: "Status message: reconciled, out of balance"
+      code_700: "Apstiprināts (komisiju savākšana)"
+      code_601: "Status message: impossible to trace back original transaction"
+      code_007: "Apstiprināts, koriģēts ICC"
+      code_106: "Atteikts, pieļaujamais PIN\n  ievadīšanas skaits izsmelts"
+      code_205: "Atņemt, kartes pieņēmējam jāzvana\n  izdevējbankas drošības departamentam"
+      code_304: "Status message: file record field edit error"
+      code_502: "Status message: amount not reconciled, totals provided"
+      code_127: "Atteikts, PIN garuma kļūda"
+      code_920: "Atteikts, drošības programmatūras\n  kļūda, mēģiniet atkārtoti"
+      code_918: "Atteikts, nav\n  lietojamu transporta atslēgu "
+      code_800: "Apstiprināts (Tīkla vadībai)"
+      code_602: "Status message: invalid transaction reference number"
+      code_107: "Atteikts, griezties pie kartes\n  izdevējbankas"
+      code_206: "Atņemt, pārsniegts atļauto PIN\n  ievažu skaits"
+      code_305: "Status message: file locked out"
+      code_503: "Status message: totals for reconciliation not available"
+      code_128: "Atteikts, PIN atslēgu sinhronizācijas kļūda"
+      code_921: "Atteikts, drošības programmatūras kļūda"
+      code_919: "Atteikts, kriptēšanas atslēgu\n  sinhronizācijas kļūda"
+      code_900: "Paziņojums atzīts, pieņemt bez\n  finansiālas atbildības"
+      code_603: "Status message: reference number/PAN incompatible"
+      code_108: "Atteikts, griezties pie kartes\n  izdevējbankas, īpaši nosacījumi"
+      code_207: "Atņemt, īpaši nosacījumi"
+      code_306: "Status message: file action not successful"
+      code_504: "Status message: not reconciled, totals provided"
+      code_129: "Atteikts, aizdomas par kartes viltojumu"
+      code_922: "Atteikts, ziņojuma numurs neatbilst\n  secībai"
+      code_901: "Paziņojums atzīts, pieņemt ar\n  finansiālu atbildību"
+      code_604: "Status message: POS photograph is not available"
+      code_110: "Atteikts, nepareiza summa"
+      code_109: "Atteikts, nepareizs tirgotājs"
+      code_208: "Atņemt, pazaudēta karte"
+      code_307: "Status message: file data format error"
+      code_923: "Pieprasījums tiek apstrādāts"
+      code_902: "Atteikts, nepareiza transakcija"
+      code_605: "Status message: requested item supplied"
+      code_111: "Atteikts, nepareizs kartes numurs"
+      code_210: "Atņemt, aizdomas par kartes viltojumu"
+      code_209: "Atņemt, zagta karte"
+      code_308: "Status message: duplicate record, new record rejected"
+      code_903: "Vēlreiz ievadi transakciju"
+      code_606: "Status message: request cannot be\n  fulfilled - required documentation is not available"
+      code_112: "Atteikts, PIN dati nepieciešami"
+      code_309: "Status message: unknown file"
+      code_197: "Atteikts, zvaniet AMEX"
+      code_904: "Atteikts, formāta kļūda"
+      code_113: "Atteikts, nepieņemama komisija"
+      code_198: "Atteikts, zvaniet Karšu apstrādes centram"
+      code_905: "Atteikts, pieņēmējbankai nav pieslēguma"
+      code_114: "Atteikts, nav pieprasīts konta tips"
+      code_906: "Atteikts, notiek pārslēgšana"
+      code_115: "Atteikts, pieprasītā funkcija netiek\n  atbalstīta"
+      code_950: "Atteikts, biznesa vienošanās pārkāpums"
+      code_116: "Atteikts, nepietiek līdzekļu"
+      code_907: "Atteikts, nedarbojas izdevējbanka\n  vai pieslēgums"
+      code_117: "Atteikts, nepareizs PIN kods"
+      code_910: "Atteikts, kartes izdevējbankas izslēgta"
+      code_908: "Atteikts, nevar atrast\n  transakcijas adresātu"
+      code_118: "Atteikts, nav kartes ieraksta"
+      code_911: "Atteikts, kartes izdevējbanka\n  laicīgi nesniedz atbildi"
+      code_909: "Atteikts, sistēmas nepareiza darbība"
+      code_000: "Apstiprināts"
+      code_120: "Atteikts, transakcija nav atļauta\n  terminālam"
+      code_119: "Atteikts, transakcija nav atļauta\n  kartes lietotājam"
+      code_912: "Atteikts, kartes izdevējbankas nav\n  sasniedzama"
+      code_001: "Apstiprināts, ja var apliecināt identitāti"
+      code_100: "Atteikts (Vispārīgs, bez komentāriem)"
+      code_121: "Atteikts, pārsniegts naudas\n  izdošanas limits"
+      code_913: "Atteikts, dubulta pārraide"
+      code_002: "Apstiprināts par daļēju summu"
+      code_101: "Atteikts, beidzies kartes derīguma termiņš"
+      code_200: "Atņemt karti (Vispārīgs, bez komnetāriem)"
+      code_122: "Atteikts, drošības pārkāpums"

data/config/routes.rb

@@ -0,0 +1,5 @@
+Rails.application.routes.draw do
+  match '/first_data/checkout', :as => "checkout_first_data", :controller => 'Lolita::FirstData::Transaction', :action => 'checkout'
+  match '/first_data/answer', :as => "answer_first_data", :controller => 'Lolita::FirstData::Transaction', :action => 'answer'
+  match '/first_data_test/:action', :controller => 'Lolita::FirstData::Test'
+end

data/lib/generators/lolita_first_data/install_generator.rb

@@ -0,0 +1,14 @@
+module LolitaFirstData
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include Lolita::Generators::FileHelper
+      source_root File.expand_path("../templates", __FILE__)
+      desc "Create migrations. "
+
+      def copy_migration
+        copy_file "migration.rb", "db/migrate/#{Time.now.strftime("%Y%m%d%H%M%S")}_create_lolita_first_data_transaction.rb"
+      end
+     
+    end
+  end
+end

data/lib/generators/lolita_first_data/templates/migration.rb

@@ -0,0 +1,21 @@
+class CreateLolitaFirstDataTransaction < ActiveRecord::Migration
+  class << self
+    def up
+      create_table :first_data_transactions do |t|
+        t.string :transaction_id, :length => 28
+        t.string :transaction_code, :length => 3
+        t.string :status, :default => "processing"
+        t.references :paymentable, :polymorphic => true
+        t.string :ip, :length => 10
+
+        t.timestamps
+      end
+
+      add_index :first_data_transactions, [:paymentable_type,:paymentable_id], :name => "fd_trx_paymentable_type_paymentable_id"
+    end
+
+    def down
+      drop_table :first_data_transactions
+    end
+  end
+end

data/lib/lolita-first-data.rb

@@ -0,0 +1,6 @@
+require 'ipaddr'
+require 'active_merchant'
+require 'lolita-first-data/custom_logger'
+require 'lolita-first-data/billing'
+require 'lolita-first-data/gateway'
+require 'lolita-first-data/rails'

data/lib/lolita-first-data/billing.rb

@@ -0,0 +1,37 @@
+module Lolita
+  module FirstData
+    module Billing
+      def self.included(base)
+        base.has_many :fd_transactions, :as => :paymentable, :class_name => "Lolita::FirstData::Transaction", :dependent => :destroy
+        base.extend ClassMethods
+        base.class_eval do
+          # returns true if exists transaction with status 'completed'
+          # and updates status if needed
+          def paid?
+            self.fd_transactions.count(:conditions => {:status => 'completed', :transaction_code => '000'}) >= 1
+          end
+
+          def fd_error_message
+            if !fd_transactions.empty? && fd_transactions.last.transaction_code
+              I18n.t("fd.response.code_#{fd_transactions.last.transaction_code}", :default => I18n.t('fd.unknown_error'))
+            end
+          end
+        end
+      end
+
+      module ClassMethods
+        # Closes business day
+        # should be executed every day ~midnight
+        # Like "ruby script/runner <YourBillingModel>.close_business_day"
+        def close_business_day
+          gw = ActiveMerchant::Billing::FirstDataGateway.new(
+            :pem => File.open(FD_PEM).read,
+            :pem_password => FD_PASS
+          )
+          rs =gw.close_day
+          rs.success? or raise("FirstData close day: #{rs.message}")
+        end
+      end
+    end
+  end
+end

data/lib/lolita-first-data/custom_logger.rb

@@ -0,0 +1,10 @@
+module Lolita
+  module FirstData
+    # custom log formatter for FirstData gateway
+    class LogFormatter < Logger::Formatter
+      def call(severity, time, program_name, message)
+        "%5s [%s] (%s) %s :: %s\n" % [severity,I18n.l(time), $$, program_name, message]
+      end
+    end
+  end
+end

data/lib/lolita-first-data/gateway.rb

@@ -0,0 +1,160 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FirstDataGateway < Gateway
+      TEST_DOMAIN = 'https://secureshop-test.firstdata.lv'
+      LIVE_DOMAIN = 'https://secureshop.firstdata.lv'
+      
+      # The homepage URL of the gateway
+      self.homepage_url = 'http://www.firstdata.lv/'
+      
+      # The name of the gateway
+      self.display_name = 'FirstData'
+      
+      def initialize(options = {})
+        requires!(options, :pem, :pem_password)
+        @options = options
+        @logger  = Logger.new(defined?(Rails) ? "#{Rails.root}/log/first_data.log" : "/tmp/fd.log", 2, 1024**2)
+        @logger.formatter = Lolita::FirstData::LogFormatter.new
+        super
+      end  
+
+      def authorize(money, currency ,ip, description)
+        commit('authorize',{
+            'command'       => 'a',
+            'msg_type'      => 'DMS',
+            'amount'        => money,
+            'currency'      => currency,
+            'client_ip_addr'=> ip,
+            'description'   => description[0,125],
+            'language'      => language
+          })
+      end
+
+      def complete(trans_id,amount,currency,ip,description)
+        commit('complete',{
+            'command'       => 't',
+            'msg_type'      => 'DMS',
+            'trans_id'      => trans_id,
+            'amount'        => amount,
+            'currency'      => currency,
+            'client_ip_addr'=> ip,
+            'description'   => description[0,125]
+          })
+      end
+
+      def purchase(money, currency ,ip, description)
+        commit('purchase',{
+            'command'       => 'v',
+            'amount'        => money,
+            'currency'      => currency,
+            'client_ip_addr'=> ip,
+            'description'   => description[0,125],
+            'language'      => language
+          })
+      end                       
+
+      def get_trans_result(ip,trans_id)
+        commit('result',{
+            'command'       => 'c',
+            'trans_id'      => trans_id,
+            'client_ip_addr'=> ip
+          })
+      end
+
+      def reverse(trans_id, amount)
+        commit('reverse',{
+            'command' => 'r',
+            'trans_id' => trans_id,
+            'amount' => amount
+          })
+      end
+
+      def close_day
+        commit('close',{
+            'command' => 'b'
+          })
+      end
+      
+      def go_out
+        raise I18n.t('fd.no_trans_id') unless @trans_id
+        url = get_domain + "/ecomm/ClientHandler?trans_id=#{CGI.escape @trans_id}"
+        url
+      end
+
+      # log to default logger and if possible to payment logger
+      def log severity, message
+        @logger.send(severity,message)
+        @options[:payment].log(severity,message) if @options[:payment].respond_to?(:log)
+      end
+      
+      private                       
+      
+      def language
+        I18n.locale.to_s.sub('-','_').downcase
+      end
+      
+      def test?
+        ActiveMerchant::Billing::Base.mode == :test
+      end
+
+      def get_domain
+        test? ? TEST_DOMAIN : LIVE_DOMAIN
+      end
+      
+      def parse(body)
+        body.to_s.strip
+      end     
+
+      # Return Response object
+      # Use the response:
+      #   rs.success? - returns true|false
+      #   rs.message - returns String with message
+      #   rs.params - returns Hash with {'TRANSACTION_ID': 'jl2j4l2j423423=3-3423-4'} or {'RESULT_CODE' => '000'} ...
+      def commit(action,parameters)
+        url   = get_domain + ":8443/ecomm/MerchantHandler"
+        data  = post_data(action, parameters)
+        log :info, "#{url} + #{data}"
+        rs = parse(post(url, data))
+        log :info, rs
+        data = {}
+        rs.scan(/[0-9A-Z_]+:\s[^\s]+/){|item|
+          item =~ /([0-9A-Z_]+):\s(.+)/
+          data[$1] = $2
+        }
+        case action
+        when /purchase|authorize/
+          @trans_id = data['TRANSACTION_ID']
+          Response.new(data['TRANSACTION_ID'],rs,data)
+        when /result|reverse|complete|close/
+          Response.new(data['RESULT'] == "OK",rs,data)
+        end
+      end
+
+      # this posts data to FirstData server
+      def post url, data, headers = {}
+        begin
+            ssl_post(url, data, headers)
+        rescue Exception => e
+          log :error, "#{e.to_s}\n\n#{$@.join("\n")}"
+          "ERROR POSTING DATA"
+        end
+      end
+
+      def pem_password
+        @options[:pem_password]
+      end
+
+      def ssl_strict
+        false
+      end
+      
+      def post_data(action, parameters = {})
+        parameters.to_query
+      end
+
+      def self.get_code_msg k
+        I18n.t("fd.code._#{k}", :default => I18n.t('fd.unknown_error'))
+      end      
+    end
+  end
+end