active_merchant_first_data 1.0.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Edgars Beigarts
+
+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.md

@@ -0,0 +1,53 @@
+First Data gateway for Active Merchant
+======================================
+
+[![Continuous Integration status](https://secure.travis-ci.org/ebeigarts/active_merchant_first_data.png)](http://travis-ci.org/ebeigarts/active_merchant_first_data)
+
+## Install
+
+```bash
+$ gem install active_merchant_first_data
+```
+
+## Usage
+
+```ruby
+require "active_merchant_first_data"
+@gateway = ActiveMerchant::Billing::FirstDataGateway.new(
+  :pem => "1234567_keystore.pem"
+  :pem_password => "5x64jq8n234c"
+)
+```
+
+## First Data test environment setup
+
+1. Generate a new certificate
+
+    ```bash
+    $ openssl req -newkey rsa:1024 -keyout spec/certs/1234567_key.pem -out spec/certs/1234567_req.pem -subj "/C=lv/O=example.com/CN=1234567" -outform PEM
+    Enter PEM pass phrase: 81f174259v45
+    ```
+
+2. [Request your certificate using `1234567_req.pem`](https://secureshop-test.firstdata.lv/report/keystore_.do)
+
+3. Copy the 3 files you received in e-mail to `spec/certs/`:
+
+    * 1234567.pem
+    * 1234567_certificate_chain.p7.pem
+    * ECOMM.pem
+
+4. Convert the certificates and keys to `1234567_keystore.pem`
+
+    ```bash
+    $ openssl pkcs12 -export -in 1234567.pem -out spec/certs/1234567_keystore.p12 -certfile spec/certs/ECOMM.pem -inkey spec/certs/1234567_key.pem
+    Enter pass phrase for 1234567_key.pem: 81f174259v45
+    Enter Export Password: <empty>
+    ```
+
+    ```bash
+    $ openssl pkcs12 -in spec/certs/1234567_keystore.p12 > spec/certs/1234567_keystore.pem
+    Enter Import Password: <empty>
+    Enter PEM pass phrase: 5x64jq8n234c
+    ```
+
+5. [Set your WAN IP address](https://secureshop-test.firstdata.lv/report/merchantlist.do)

data/lib/active_merchant/billing/first_data_gateway.rb

@@ -0,0 +1,171 @@
+require "active_merchant"
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FirstDataGateway < Gateway
+      class_attribute :test_url, :live_url, :test_redirect_url, :live_redirect_url, :pem_file, :pem_password
+
+      self.test_redirect_url = 'https://secureshop-test.firstdata.lv/ecomm/ClientHandler'
+      self.live_redirect_url = 'https://secureshop.firstdata.lv/ecomm/ClientHandler'
+
+      self.test_url = 'https://secureshop-test.firstdata.lv:8443/ecomm/MerchantHandler'
+      self.live_url = 'https://secureshop.firstdata.lv:8443/ecomm/MerchantHandler'
+
+      self.homepage_url = 'http://www.firstdata.lv/'
+      self.display_name = 'First Data'
+
+      self.ssl_strict = false
+      self.default_currency = '428' # LVL (http://en.wikipedia.org/wiki/ISO_4217)
+      self.money_format = :cents
+
+      # Creates a new FirstDataGateway
+      #
+      # The gateway requires that a valid pem and password be passed
+      # in the +options+ hash.
+      #
+      # Options:
+      #
+      # * <tt>:pem</tt> -- The First Data cert/key (REQUIRED)
+      # * <tt>:pem_password</tt> -- The First Data password. (REQUIRED)
+      #
+      def initialize(options = {})
+        requires!(options, :pem, :pem_password)
+        @options = options
+        super
+      end
+
+      # Perform a purchase, which is essentially an authorization and capture in a single operation.
+      #
+      # Registering of SMS transaction
+      # @param int $amount transaction amount in minor units, mandatory 
+      # @param int $currency transaction currency code, mandatory 
+      # @param string $ip clientís IP address, mandatory
+      # @param string $desc description of transaction, optional
+      # @param string $language authorization language identificator, optional 
+      # @return string TRANSACTION_ID
+      #
+      def purchase(amount, params = {})
+        params = params.reverse_merge(
+          :command => :v,
+          :amount => amount,
+          :currency => default_currency
+        )
+        requires!(params, :amount, :currency, :client_ip_addr)
+        commit(params)
+      end
+
+      # Performs an authorization, which reserves the funds on the customer's credit card, but does not
+      # charge the card.
+      #
+      # Registering of DMS authorisation
+      # @param int $amount transaction amount in minor units, mandatory 
+      # @param int $currency transaction currency code, mandatory 
+      # @param string $ip clientís IP address, mandatory
+      # @param string $desc description of transaction, optional
+      # @param string $language authorization language identificator, optional 
+      # @return string TRANSACTION_ID
+      #
+      def authorize(amount, params = {})
+        params = params.reverse_merge(
+          :command => :a,
+          :msg_type => 'DMS',
+          :amount => amount,
+          :currency => default_currency
+        )
+        requires!(params, :amount, :currency, :client_ip_addr, :msg_type)
+        commit(params)
+      end
+
+      # Captures the funds from an authorized transaction.
+      #
+      # Making of DMS transaction
+      # @param int $auth_id id of previously made successeful authorisation
+      # @param int $amount transaction amount in minor units, mandatory 
+      # @param int $currency transaction currency code, mandatory 
+      # @param string $ip clientís IP address, mandatory
+      # @param string $desc description of transaction, optional
+      # @return string RESULT, RESULT_CODE, RRN, APPROVAL_CODE
+      #
+      def capture(amount, trans_id, params = {})
+        params = params.reverse_merge(
+          :command => :t,
+          :msg_type => 'DMS',
+          :trans_id => trans_id,
+          :amount => amount,
+          :currency => default_currency
+        )
+        requires!(params, :trans_id, :amount, :currency, :client_ip_addr)
+        commit(params)
+      end
+
+      # Transaction result
+      #
+      # @param int $trans_id transaction identifier, mandatory
+      # @param string $ip clientís IP address, mandatory
+      # @return string RESULT, RESULT_CODE, 3DSECURE, AAV, RRN, APPROVAL_CODE
+      #
+      def result(trans_id, params = {})
+        params = params.reverse_merge(
+          :command => :c,
+          :trans_id => trans_id
+        )
+        requires!(params, :trans_id, :client_ip_addr)
+        commit(params)
+      end
+
+      # credit() allows you to return money to a card that was previously billed.
+      #
+      # Transaction reversal
+      # @param int $trans_id transaction identifier, mandatory
+      # @param int $amount transaction amount in minor units, mandatory 
+      # @return string RESULT, RESULT_CODE
+      #
+      def credit(amount, trans_id = nil)
+        params = {
+          :command => :r,
+          :trans_id => trans_id,
+          :amount => amount
+        }
+        requires!(params, :command, :trans_id, :amount)
+        commit(params)
+      end
+
+      # Close business day.
+      def close_day
+        commit({ :command => :b })
+      end
+
+      def endpoint_url
+        test? ? test_url : live_url
+      end
+
+      def redirect_url
+        test? ? test_redirect_url : live_redirect_url
+      end
+
+      private
+
+      # Convert HTTP response body to a Ruby Hash.
+      def parse(body)
+        results = ActiveSupport::HashWithIndifferentAccess.new
+        body.split(/[\r\n]+/).each do |pair|
+          key, val = pair.split(": ")
+          results[key.downcase] = val
+        end
+        results
+      end
+
+      def commit(params = {})
+        response = parse(ssl_post(endpoint_url, post_data(params)))
+        raise response[:error] unless response[:error].blank?
+        response
+      end
+
+      def post_data(params)
+        post = PostData.new
+        params.each { |k, v| post[k] = v }
+        post.to_s
+      end
+    end
+  end
+end

data/lib/active_merchant_first_data.rb

@@ -0,0 +1 @@
+require "active_merchant/billing/first_data_gateway"

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: active_merchant_first_data
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Edgars Beigarts
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-08 00:00:00.000000000 +03:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemerchant
+  requirement: &2152366380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.15.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152366380
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2152366000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2152366000
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2152365440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *2152365440
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: &2152365020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2152365020
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: &2152364560 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2152364560
+description: First Data gateway for Active Merchant
+email:
+- edgars.beigarts@makit.lv
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/active_merchant/billing/first_data_gateway.rb
+- lib/active_merchant_first_data.rb
+- README.md
+- LICENSE
+has_rdoc: true
+homepage: https://github.com/ebeigarts/active_merchant_first_data
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: First Data gateway for Active Merchant
+test_files: []